feat(system): 添加商品备货属性管理功能

- 新增商品备货属性实体类ProductStockUp定义数据结构
- 实现商品备货属性业务对象ProductStockUpBo用于数据传输
- 创建商品备货属性视图对象ProductStockUpVo支持Excel导出
- 开发商品备货属性服务接口IProductStockUpService及实现类
- 构建商品备货属性数据访问层ProductStockUpMapper及XML映射文件
- 设计商品备货属性控制器ProductStockUpController提供REST API
- 实现商品备货属性的增删改查、状态修改、分页查询等功能

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/controller/system/ProductStockUpController.java

@@ -0,0 +1,115 @@
+package org.dromara.system.controller.system;
+
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.RequiredArgsConstructor;
+import org.dromara.common.core.domain.R;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import org.dromara.common.excel.utils.ExcelUtil;
+import org.dromara.common.idempotent.annotation.RepeatSubmit;
+import org.dromara.common.log.annotation.Log;
+import org.dromara.common.log.enums.BusinessType;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.web.core.BaseController;
+import org.dromara.system.domain.bo.ProductStockUpBo;
+import org.dromara.system.domain.vo.ProductStockUpVo;
+import org.dromara.system.service.IProductStockUpService;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+
+/**
+ * 商品备货属性
+ * 前端访问路由地址为:/system/stockUp
+ *
+ * @author LionLi
+ * @date 2026-03-31
+ */
+@Validated
+@RequiredArgsConstructor
+@RestController
+@RequestMapping("/stockUp")
+public class ProductStockUpController extends BaseController {
+
+    private final IProductStockUpService productStockUpService;
+
+    /**
+     * 查询商品备货属性列表
+     */
+    //@SaCheckPermission("system:stockUp:list")
+    @GetMapping("/list")
+    public TableDataInfo<ProductStockUpVo> list(ProductStockUpBo bo, PageQuery pageQuery) {
+        return productStockUpService.queryPageList(bo, pageQuery);
+    }
+
+    /**
+     * 导出商品备货属性列表
+     */
+    //@SaCheckPermission("system:stockUp:export")
+    @Log(title = "商品备货属性", businessType = BusinessType.EXPORT)
+    @PostMapping("/export")
+    public void export(ProductStockUpBo bo, HttpServletResponse response) {
+        List<ProductStockUpVo> list = productStockUpService.queryList(bo);
+        ExcelUtil.exportExcel(list, "商品备货属性", ProductStockUpVo.class, response);
+    }
+
+    /**
+     * 获取商品备货属性详细信息
+     *
+     * @param id 主键
+     */
+    //@SaCheckPermission("system:stockUp:query")
+    @GetMapping("/{id}")
+    public R<ProductStockUpVo> getInfo(@NotNull(message = "主键不能为空")
+                                       @PathVariable("id") Long id) {
+        return R.ok(productStockUpService.queryById(id));
+    }
+
+    /**
+     * 新增商品备货属性
+     */
+    //@SaCheckPermission("system:stockUp:add")
+    @Log(title = "商品备货属性", businessType = BusinessType.INSERT)
+    @RepeatSubmit()
+    @PostMapping()
+    public R<Void> add(@Validated(AddGroup.class) @RequestBody ProductStockUpBo bo) {
+        return toAjax(productStockUpService.insertByBo(bo));
+    }
+
+    /**
+     * 修改商品备货属性
+     */
+    //@SaCheckPermission("system:stockUp:edit")
+    @Log(title = "商品备货属性", businessType = BusinessType.UPDATE)
+    @RepeatSubmit()
+    @PutMapping()
+    public R<Void> edit(@Validated(EditGroup.class) @RequestBody ProductStockUpBo bo) {
+        return toAjax(productStockUpService.updateByBo(bo));
+    }
+
+    /**
+     * 删除商品备货属性
+     *
+     * @param ids 主键串
+     */
+    //@SaCheckPermission("system:stockUp:remove")
+    @Log(title = "商品备货属性", businessType = BusinessType.DELETE)
+    @DeleteMapping("/{ids}")
+    public R<Void> remove(@NotEmpty(message = "主键不能为空")
+                          @PathVariable("ids") Long[] ids) {
+        return toAjax(productStockUpService.deleteWithValidByIds(List.of(ids), true));
+    }
+
+    /**
+     * 状态修改
+     */
+    @Log(title = "商品备货属性", businessType = BusinessType.UPDATE)
+    @PutMapping("/changeStatus")
+    public R<Void> changeStatus(@RequestBody ProductStockUpBo bo) {
+        return toAjax(productStockUpService.updateStatus(bo));
+    }
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/domain/ProductStockUp.java

@@ -0,0 +1,67 @@
+package org.dromara.system.domain;
+
+import org.dromara.common.tenant.core.TenantEntity;
+import com.baomidou.mybatisplus.annotation.*;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.io.Serial;
+
+/**
+ * 商品备货属性对象 product_stock_up
+ *
+ * @author LionLi
+ * @date 2026-03-31
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@TableName("product_stock_up")
+public class ProductStockUp extends TenantEntity {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 主键ID
+     */
+    @TableId(value = "id")
+    private Long id;
+
+    /**
+     * 属性编号
+     */
+    private String stockNo;
+
+    /**
+     * 属性名称
+     */
+    private String stockName;
+
+    /**
+     * 是否显示（0-显示，1-不显示）
+     */
+    private String isShow;
+
+    /**
+     * 数据来源
+     */
+    private String dataSource;
+
+    /**
+     * 状态（0正常 1停用）
+     */
+    private String status;
+
+    /**
+     * 删除标志（0代表存在 2代表删除）
+     */
+    @TableLogic
+    private String delFlag;
+
+    /**
+     * 备注
+     */
+    private String remark;
+
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/domain/bo/ProductStockUpBo.java

@@ -0,0 +1,60 @@
+package org.dromara.system.domain.bo;
+
+import org.dromara.system.domain.ProductStockUp;
+import org.dromara.common.mybatis.core.domain.BaseEntity;
+import org.dromara.common.core.validate.AddGroup;
+import org.dromara.common.core.validate.EditGroup;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import jakarta.validation.constraints.*;
+
+/**
+ * 商品备货属性业务对象 product_stock_up
+ *
+ * @author LionLi
+ * @date 2026-03-31
+ */
+@Data
+@EqualsAndHashCode(callSuper = true)
+@AutoMapper(target = ProductStockUp.class, reverseConvertGenerate = false)
+public class ProductStockUpBo extends BaseEntity {
+
+    /**
+     * 主键ID
+     */
+    private Long id;
+
+    /**
+     * 属性编号
+     */
+    private String stockNo;
+
+    /**
+     * 属性名称
+     */
+    //@NotBlank(message = "属性名称不能为空", groups = { AddGroup.class, EditGroup.class })
+    private String stockName;
+
+    /**
+     * 是否显示（0-显示，1-不显示）
+     */
+    private String isShow;
+
+    /**
+     * 数据来源
+     */
+    private String dataSource;
+
+    /**
+     * 状态（0正常 1停用）
+     */
+    private String status;
+
+    /**
+     * 备注
+     */
+    private String remark;
+
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/domain/vo/ProductStockUpVo.java

@@ -0,0 +1,76 @@
+package org.dromara.system.domain.vo;
+
+import org.dromara.system.domain.ProductStockUp;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import org.dromara.common.excel.annotation.ExcelDictFormat;
+import org.dromara.common.excel.convert.ExcelDictConvert;
+import io.github.linpeilie.annotations.AutoMapper;
+import lombok.Data;
+
+import java.io.Serial;
+import java.io.Serializable;
+import java.util.Date;
+
+
+
+/**
+ * 商品备货属性视图对象 product_stock_up
+ *
+ * @author LionLi
+ * @date 2026-03-31
+ */
+@Data
+@ExcelIgnoreUnannotated
+@AutoMapper(target = ProductStockUp.class)
+public class ProductStockUpVo implements Serializable {
+
+    @Serial
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * 主键ID
+     */
+    @ExcelProperty(value = "主键ID")
+    private Long id;
+
+    /**
+     * 属性编号
+     */
+    @ExcelProperty(value = "属性编号")
+    private String stockNo;
+
+    /**
+     * 属性名称
+     */
+    @ExcelProperty(value = "属性名称")
+    private String stockName;
+
+    /**
+     * 是否显示（0-显示，1-不显示）
+     */
+    @ExcelProperty(value = "是否显示", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(readConverterExp = "0=-显示，1-不显示")
+    private String isShow;
+
+    /**
+     * 数据来源
+     */
+    @ExcelProperty(value = "数据来源")
+    private String dataSource;
+
+    /**
+     * 状态（0正常 1停用）
+     */
+    @ExcelProperty(value = "状态", converter = ExcelDictConvert.class)
+    @ExcelDictFormat(readConverterExp = "0=正常,1=停用")
+    private String status;
+
+    /**
+     * 备注
+     */
+    @ExcelProperty(value = "备注")
+    private String remark;
+
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/mapper/ProductStockUpMapper.java

@@ -0,0 +1,15 @@
+package org.dromara.system.mapper;
+
+import org.dromara.system.domain.ProductStockUp;
+import org.dromara.system.domain.vo.ProductStockUpVo;
+import org.dromara.common.mybatis.core.mapper.BaseMapperPlus;
+
+/**
+ * 商品备货属性Mapper接口
+ *
+ * @author LionLi
+ * @date 2026-03-31
+ */
+public interface ProductStockUpMapper extends BaseMapperPlus<ProductStockUp, ProductStockUpVo> {
+
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/IProductStockUpService.java

@@ -0,0 +1,79 @@
+package org.dromara.system.service;
+
+import com.baomidou.mybatisplus.extension.service.IService;
+import org.dromara.system.domain.ProductStockUp;
+import org.dromara.system.domain.bo.CreditLevelBo;
+import org.dromara.system.domain.vo.ProductStockUpVo;
+import org.dromara.system.domain.bo.ProductStockUpBo;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * 商品备货属性Service接口
+ *
+ * @author LionLi
+ * @date 2026-03-31
+ */
+public interface IProductStockUpService extends IService<ProductStockUp> {
+
+    /**
+     * 查询商品备货属性
+     *
+     * @param id 主键
+     * @return 商品备货属性
+     */
+    ProductStockUpVo queryById(Long id);
+
+    /**
+     * 分页查询商品备货属性列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 商品备货属性分页列表
+     */
+    TableDataInfo<ProductStockUpVo> queryPageList(ProductStockUpBo bo, PageQuery pageQuery);
+
+    /**
+     * 查询符合条件的商品备货属性列表
+     *
+     * @param bo 查询条件
+     * @return 商品备货属性列表
+     */
+    List<ProductStockUpVo> queryList(ProductStockUpBo bo);
+
+    /**
+     * 新增商品备货属性
+     *
+     * @param bo 商品备货属性
+     * @return 是否新增成功
+     */
+    Boolean insertByBo(ProductStockUpBo bo);
+
+    /**
+     * 修改商品备货属性
+     *
+     * @param bo 商品备货属性
+     * @return 是否修改成功
+     */
+    Boolean updateByBo(ProductStockUpBo bo);
+
+    /**
+     * 修改商品备货属性显示状态
+     *
+     * @param bo 商品备货属性
+     * @return 是否修改成功
+     */
+    int updateStatus(ProductStockUpBo bo);
+
+    /**
+     * 校验并批量删除商品备货属性信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid);
+}

ruoyi-modules/ruoyi-system/src/main/java/org/dromara/system/service/impl/ProductStockUpServiceImpl.java

@@ -0,0 +1,159 @@
+package org.dromara.system.service.impl;
+
+import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
+import org.dromara.common.core.utils.MapstructUtils;
+import org.dromara.common.core.utils.StringUtils;
+import org.dromara.common.mybatis.core.page.TableDataInfo;
+import org.dromara.common.mybatis.core.page.PageQuery;
+import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import com.baomidou.mybatisplus.core.toolkit.Wrappers;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+import org.dromara.common.redis.utils.SequenceUtils;
+import org.dromara.system.domain.CreditLevel;
+import org.dromara.system.domain.bo.CreditLevelBo;
+import org.springframework.stereotype.Service;
+import org.dromara.system.domain.bo.ProductStockUpBo;
+import org.dromara.system.domain.vo.ProductStockUpVo;
+import org.dromara.system.domain.ProductStockUp;
+import org.dromara.system.mapper.ProductStockUpMapper;
+import org.dromara.system.service.IProductStockUpService;
+
+import java.time.Duration;
+import java.util.List;
+import java.util.Map;
+import java.util.Collection;
+
+/**
+ * 商品备货属性Service业务层处理
+ *
+ * @author LionLi
+ * @date 2026-03-31
+ */
+@Slf4j
+@RequiredArgsConstructor
+@Service
+public class ProductStockUpServiceImpl extends ServiceImpl<ProductStockUpMapper, ProductStockUp> implements IProductStockUpService {
+
+    private static final String STOCK_UP_NO_KEY = "product_stock_up:cstock_up_no";
+
+    private final ProductStockUpMapper baseMapper;
+
+    /**
+     * 查询商品备货属性
+     *
+     * @param id 主键
+     * @return 商品备货属性
+     */
+    @Override
+    public ProductStockUpVo queryById(Long id) {
+        return baseMapper.selectVoById(id);
+    }
+
+    /**
+     * 分页查询商品备货属性列表
+     *
+     * @param bo        查询条件
+     * @param pageQuery 分页参数
+     * @return 商品备货属性分页列表
+     */
+    @Override
+    public TableDataInfo<ProductStockUpVo> queryPageList(ProductStockUpBo bo, PageQuery pageQuery) {
+        LambdaQueryWrapper<ProductStockUp> lqw = buildQueryWrapper(bo);
+        Page<ProductStockUpVo> result = baseMapper.selectVoPage(pageQuery.build(), lqw);
+        return TableDataInfo.build(result);
+    }
+
+    /**
+     * 查询符合条件的商品备货属性列表
+     *
+     * @param bo 查询条件
+     * @return 商品备货属性列表
+     */
+    @Override
+    public List<ProductStockUpVo> queryList(ProductStockUpBo bo) {
+        LambdaQueryWrapper<ProductStockUp> lqw = buildQueryWrapper(bo);
+        return baseMapper.selectVoList(lqw);
+    }
+
+    private LambdaQueryWrapper<ProductStockUp> buildQueryWrapper(ProductStockUpBo bo) {
+        Map<String, Object> params = bo.getParams();
+        LambdaQueryWrapper<ProductStockUp> lqw = Wrappers.lambdaQuery();
+        lqw.orderByAsc(ProductStockUp::getId);
+        lqw.eq(StringUtils.isNotBlank(bo.getStockNo()), ProductStockUp::getStockNo, bo.getStockNo());
+        lqw.like(StringUtils.isNotBlank(bo.getStockName()), ProductStockUp::getStockName, bo.getStockName());
+        lqw.eq(StringUtils.isNotBlank(bo.getIsShow()), ProductStockUp::getIsShow, bo.getIsShow());
+        lqw.eq(StringUtils.isNotBlank(bo.getDataSource()), ProductStockUp::getDataSource, bo.getDataSource());
+        lqw.eq(StringUtils.isNotBlank(bo.getStatus()), ProductStockUp::getStatus, bo.getStatus());
+        lqw.eq(StringUtils.isNotBlank(bo.getPlatformCode()), ProductStockUp::getPlatformCode, bo.getPlatformCode());
+        return lqw;
+    }
+
+    /**
+     * 新增商品备货属性
+     *
+     * @param bo 商品备货属性
+     * @return 是否新增成功
+     */
+    @Override
+    public Boolean insertByBo(ProductStockUpBo bo) {
+        bo.setStockNo(SequenceUtils.nextPaddedIdStr(STOCK_UP_NO_KEY, Duration.ofDays(3650), 4));
+        ProductStockUp add = MapstructUtils.convert(bo, ProductStockUp.class);
+        validEntityBeforeSave(add);
+        boolean flag = baseMapper.insert(add) > 0;
+        if (flag) {
+            bo.setId(add.getId());
+        }
+        return flag;
+    }
+
+    /**
+     * 修改商品备货属性
+     *
+     * @param bo 商品备货属性
+     * @return 是否修改成功
+     */
+    @Override
+    public Boolean updateByBo(ProductStockUpBo bo) {
+        ProductStockUp update = MapstructUtils.convert(bo, ProductStockUp.class);
+        validEntityBeforeSave(update);
+        return baseMapper.updateById(update) > 0;
+    }
+
+    /**
+     * 修改显示状态
+     *
+     * @param bo 信息
+     * @return 结果
+     */
+    @Override
+    public int updateStatus(ProductStockUpBo bo) {
+        ProductStockUp stockUp = new ProductStockUp();
+        stockUp.setId(bo.getId());
+        stockUp.setIsShow(bo.getIsShow());
+        return baseMapper.updateById(stockUp);
+    }
+
+    /**
+     * 保存前的数据校验
+     */
+    private void validEntityBeforeSave(ProductStockUp entity) {
+        //TODO 做一些数据校验,如唯一约束
+    }
+
+    /**
+     * 校验并批量删除商品备货属性信息
+     *
+     * @param ids     待删除的主键集合
+     * @param isValid 是否进行有效性校验
+     * @return 是否删除成功
+     */
+    @Override
+    public Boolean deleteWithValidByIds(Collection<Long> ids, Boolean isValid) {
+        if (isValid) {
+            //TODO 做一些业务上的校验,判断是否需要校验
+        }
+        return baseMapper.deleteByIds(ids) > 0;
+    }
+}

ruoyi-modules/ruoyi-system/src/main/resources/mapper/system/ProductStockUpMapper.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper
+PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
+"http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="org.dromara.system.mapper.ProductStockUpMapper">
+
+</mapper>