feat: 基础参数配置接口

gongchunyi

8 小时以前 578ea7a56b5fd6019cd96549f1176ce2574fc13a

feat: 基础参数配置接口

 doc/ÄþÏÄ-ÖÐÊ¢½¨²Ä.sql

@@ -176,3 +176,24 @@
ALTER TABLE `product-inventory-management-zsjc`.`production_plan`
    DROP COLUMN `data_sync_type`,
    MODIFY COLUMN `data_source_type` tinyint NULL DEFAULT 1 COMMENT '数据来源类型：1=钉钉同步 2=手动新增' AFTER `form_modified_time`;

DROP TABLE IF EXISTS `base_param`;
CREATE TABLE `base_param`
(
    id            BIGINT PRIMARY KEY AUTO_INCREMENT COMMENT '主键ID',
    param_key     VARCHAR(100) NOT NULL COMMENT '参数唯一标识',
    param_name    VARCHAR(100) NOT NULL COMMENT '参数名称',
    param_type    TINYINT      NOT NULL COMMENT '参数类型(1数字 2文本)',
    value_mode    TINYINT DEFAULT 1 COMMENT '值模式(1单值 2区间)',
    unit          VARCHAR(50) COMMENT '单位',
    default_value VARCHAR(200) COMMENT '默认值(单值参数)',
    default_min   DECIMAL(10, 2) COMMENT '默认最小值(区间参数)',
    default_max   DECIMAL(10, 2) COMMENT '默认最大值(区间参数)',
    is_required   TINYINT DEFAULT 0 COMMENT '是否必填(0否 1是)',
    remark        VARCHAR(255) COMMENT '备注',
    create_user   VARCHAR(64) COMMENT '创建人',
    create_time   DATETIME COMMENT '创建时间',
    update_user   VARCHAR(64) COMMENT '修改人',
    update_time   DATETIME COMMENT '修改时间',
    tenant_id     BIGINT       NOT NULL COMMENT '租户ID'
) COMMENT = '基础参数定义表';

 src/main/java/com/ruoyi/basic/controller/BaseParamController.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,60 @@
package com.ruoyi.basic.controller;

import com.ruoyi.basic.pojo.BaseParam;
import com.ruoyi.basic.service.BaseParamService;
import com.ruoyi.framework.aspectj.lang.annotation.Log;
import com.ruoyi.framework.aspectj.lang.enums.BusinessType;
import com.ruoyi.framework.web.controller.BaseController;
import com.ruoyi.framework.web.domain.AjaxResult;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

/**
 * <br>
 * åŸºç¡€å‚数定义控制层
 * </br>
 *
 * @author deslrey
 * @version 1.0
 * @since 2026/03/13 16:42
 */
@RestController
@RequestMapping("/baseParam")
public class BaseParamController extends BaseController {

    @Autowired
    private BaseParamService baseParamService;

    @GetMapping("list")
    @Log(title = "基础参数数据集合", businessType = BusinessType.OTHER)
    @ApiOperation("基础参数数据集合")
    public AjaxResult baseParamList(BaseParam baseParam) {
        List<BaseParam> list = baseParamService.baseParamList(baseParam);
        return AjaxResult.success(list);
    }

    @PostMapping("/add")
    @Log(title = "新增基础参数", businessType = BusinessType.INSERT)
    @ApiOperation("新增基础参数")
    public AjaxResult baseParamAdd(@RequestBody BaseParam baseParam) {
        return toAjax(baseParamService.addBaseParam(baseParam));
    }

    @PutMapping("/edit")
    @Log(title = "修改基础参数", businessType = BusinessType.UPDATE)
    @ApiOperation("修改基础参数")
    public AjaxResult baseParamEdit(@RequestBody BaseParam baseParam) {
        return toAjax(baseParamService.updateBaseParam(baseParam));
    }

    @DeleteMapping("/remove/{ids}")
    @Log(title = "删除基础参数", businessType = BusinessType.DELETE)
    @ApiOperation("删除基础参数")
    public AjaxResult baseParamRemove(@PathVariable Long[] ids) {
        return toAjax(baseParamService.deleteBaseParamByIds(ids));
    }

}

 src/main/java/com/ruoyi/basic/dto/BaseParamDto.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,79 @@
package com.ruoyi.basic.dto;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat;

import java.math.BigDecimal;
import java.time.LocalDateTime;

/**
 * <br>
 * åŸºç¡€å‚数定义Dto
 * </br>
 *
 * @author deslrey
 * @version 1.0
 * @since 2026/03/13 17:40
 */
@Data
@Api("基础参数定义Dto")
public class BaseParamDto {

    @ApiModelProperty("主键ID")
    private Long id;

    @ApiModelProperty("参数唯一标识")
    private String paramKey;

    @ApiModelProperty("参数名称")
    private String paramName;

    @ApiModelProperty("参数类型(1数字 2文本)")
    private Integer paramType;

    @ApiModelProperty("值模式(1单值 2区间)")
    private Integer valueMode;

    @ApiModelProperty("单位")
    private String unit;

    @ApiModelProperty("默认值(单值参数)")
    private String defaultValue;

    @ApiModelProperty("默认最小值(区间参数)")
    private BigDecimal defaultMin;

    @ApiModelProperty("默认最大值(区间参数)")
    private BigDecimal defaultMax;

    @ApiModelProperty("是否必填(0否 1是)")
    private Integer isRequired;

    @ApiModelProperty("产品类型表ID名称")
    private String baseProductTypeName;

    @ApiModelProperty("备注")
    private String remark;

    @ApiModelProperty("创建人")
    private String createUser;

    @ApiModelProperty("创建时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime createTime;

    @ApiModelProperty("修改人")
    private String updateUser;

    @ApiModelProperty("修改时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime updateTime;
}

 src/main/java/com/ruoyi/basic/mapper/BaseParamMapper.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,16 @@
package com.ruoyi.basic.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.ruoyi.basic.pojo.BaseParam;

/**
 * <br>
 * åŸºç¡€å‚数定义Mapper
 * </br>
 *
 * @author deslrey
 * @version 1.0
 * @since 2026/03/13 16:39
 */
public interface BaseParamMapper extends BaseMapper<BaseParam> {
}

 src/main/java/com/ruoyi/basic/pojo/BaseParam.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,81 @@
package com.ruoyi.basic.pojo;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.fasterxml.jackson.annotation.JsonFormat;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import org.springframework.format.annotation.DateTimeFormat;

import java.math.BigDecimal;
import java.time.LocalDateTime;

/**
 * <br>
 * åŸºç¡€å‚数定义表
 * </br>
 *
 * @author deslrey
 * @version 1.0
 * @since 2026/03/13 16:33
 */
@Data
@TableName("base_param")
@Api("基础参数定义")
public class BaseParam {

    @TableId(type = IdType.AUTO)
    @ApiModelProperty("主键ID")
    private Long id;

    @ApiModelProperty("参数唯一标识")
    private String paramKey;

    @ApiModelProperty("参数名称")
    private String paramName;

    @ApiModelProperty("参数类型(1数字 2文本)")
    private Integer paramType;

    @ApiModelProperty("值模式(1单值 2区间)")
    private Integer valueMode;

    @ApiModelProperty("单位")
    private String unit;

    @ApiModelProperty("默认值(单值参数)")
    private String defaultValue;

    @ApiModelProperty("默认最小值(区间参数)")
    private BigDecimal defaultMin;

    @ApiModelProperty("默认最大值(区间参数)")
    private BigDecimal defaultMax;

    @ApiModelProperty("是否必填(0否 1是)")
    private Integer isRequired;

    @ApiModelProperty("备注")
    private String remark;

    @ApiModelProperty("创建人")
    private String createUser;

    @ApiModelProperty("创建时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime createTime;

    @ApiModelProperty("修改人")
    private String updateUser;

    @ApiModelProperty("修改时间")
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    @DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime updateTime;

    @ApiModelProperty("租户ID")
    private Long tenantId;
}

 src/main/java/com/ruoyi/basic/service/BaseParamService.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,25 @@
package com.ruoyi.basic.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.ruoyi.basic.pojo.BaseParam;

import java.util.List;

/**
 * <br>
 * åŸºç¡€å‚数定义接口
 * </br>
 *
 * @author deslrey
 * @version 1.0
 * @since 2026/03/13 16:40
 */
public interface BaseParamService extends IService<BaseParam> {
    List<BaseParam> baseParamList(BaseParam baseParam);

    int addBaseParam(BaseParam baseParam);

    int updateBaseParam(BaseParam baseParam);

    int deleteBaseParamByIds(Long[] ids);
}

 src/main/java/com/ruoyi/basic/service/impl/BaseParamServiceImpl.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,157 @@
package com.ruoyi.basic.service.impl;

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.ruoyi.basic.mapper.BaseParamMapper;
import com.ruoyi.basic.pojo.BaseParam;
import com.ruoyi.basic.service.BaseParamService;
import com.ruoyi.common.utils.SecurityUtils;
import com.ruoyi.common.utils.StringUtils;
import io.swagger.annotations.Api;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;

import java.math.BigDecimal;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

/**
 * <br>
 * åŸºç¡€å‚数定义接口实现类
 * </br>
 *
 * @author deslrey
 * @version 1.0
 * @since 2026/03/13 16:41
 */
@Slf4j
@Service
@Api("基础参数定义接口实现类")
public class BaseParamServiceImpl extends ServiceImpl<BaseParamMapper, BaseParam> implements BaseParamService {

    @Override
    public List<BaseParam> baseParamList(BaseParam baseParam) {
        LambdaQueryWrapper<BaseParam> queryWrapper = new LambdaQueryWrapper<>();
        if (StringUtils.isNotEmpty(baseParam.getParamName())) {
            queryWrapper.like(BaseParam::getParamName, baseParam.getParamName());
        }
        List<BaseParam> list = list(queryWrapper);
        if (list == null || list.isEmpty()) {
            return new ArrayList<>(0);
        }
        return list;
    }

    @Override
    public int addBaseParam(BaseParam baseParam) {

        if (baseParam == null) {
            throw new RuntimeException("新增参数不能为空");
        }
        // å‚数校验
        checkBaseParam(baseParam, false);
        // è‡ªåŠ¨ç”ŸæˆparamKey
        baseParam.setParamKey(generateParamKey());
        baseParam.setCreateUser(SecurityUtils.getUsername());
        baseParam.setCreateTime(LocalDateTime.now());

        return baseMapper.insert(baseParam);
    }

    @Override
    public int updateBaseParam(BaseParam baseParam) {
        if (baseParam == null || baseParam.getId() == null) {
            throw new RuntimeException("修改参数ID不能为空");
        }
        // å‚数校验
        checkBaseParam(baseParam, true);
        baseParam.setUpdateUser(SecurityUtils.getUsername());
        baseParam.setUpdateTime(LocalDateTime.now());

        return baseMapper.updateById(baseParam);
    }

    /**
     * ç”Ÿæˆå‚数唯一key
     */
    private String generateParamKey() {
        String prefix = "PARAM_";
        // æŸ¥è¯¢å½“前最大key
        LambdaQueryWrapper<BaseParam> wrapper = new LambdaQueryWrapper<>();
        wrapper.select(BaseParam::getParamKey)
                .likeRight(BaseParam::getParamKey, prefix)
                .orderByDesc(BaseParam::getParamKey)
                .last("limit 1");
        BaseParam last = baseMapper.selectOne(wrapper);
        int nextNum = 1;
        if (last != null) {
            String lastKey = last.getParamKey();
            String numStr = lastKey.replace(prefix, "");
            nextNum = Integer.parseInt(numStr) + 1;
        }
        return prefix + String.format("%04d", nextNum);
    }

    /**
     * å‚数合法性校验
     */
    private void checkBaseParam(BaseParam baseParam, boolean isUpdate) {
        if (baseParam == null) {
            throw new RuntimeException("参数对象不能为空");
        }
        if (StringUtils.isEmpty(baseParam.getParamName())) {
            throw new RuntimeException("参数名称不能为空");
        }
        if (baseParam.getParamType() == null ||
                !(baseParam.getParamType() == 1 || baseParam.getParamType() == 2)) {
            throw new RuntimeException("参数类型必须为1(数字)或2(文本)");
        }
        if (baseParam.getValueMode() == null ||
                !(baseParam.getValueMode() == 1 || baseParam.getValueMode() == 2)) {
            throw new RuntimeException("值模式必须为1(单值)或2(区间)");
        }

        // å•å€¼æ¨¡å¼
        if (baseParam.getValueMode() == 1) {
            if (StringUtils.isEmpty(baseParam.getDefaultValue())) {
                throw new RuntimeException("单值参数默认值不能为空");
            }
            if (baseParam.getParamType() == 1) {
                try {
                    new BigDecimal(baseParam.getDefaultValue());
                } catch (Exception e) {
                    throw new RuntimeException("默认值必须为数字");
                }
            }

            baseParam.setDefaultMin(null);
            baseParam.setDefaultMax(null);
        }

        // åŒºé—´æ¨¡å¼
        if (baseParam.getValueMode() == 2) {
            if (baseParam.getParamType() != 1) {
                throw new RuntimeException("只有数字类型才能使用区间模式");
            }
            if (baseParam.getDefaultMin() == null || baseParam.getDefaultMax() == null) {
                throw new RuntimeException("区间参数最小值和最大值不能为空");
            }
            if (baseParam.getDefaultMin().compareTo(baseParam.getDefaultMax()) > 0) {
                throw new RuntimeException("最小值不能大于最大值");
            }

            baseParam.setDefaultValue(null);
        }
    }

    @Override
    public int deleteBaseParamByIds(Long[] ids) {
        if (ids == null || ids.length == 0) {
            throw new RuntimeException("删除ID不能为空");
        }

        return baseMapper.deleteBatchIds(Arrays.asList(ids));
    }
}

 src/main/resources/mapper/basic/BaseParamMapper.xml

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,25 @@
<?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="com.ruoyi.basic.mapper.BaseParamMapper">

    <resultMap id="BaseResultMap" type="com.ruoyi.basic.pojo.BaseParam">
        <id column="id" property="id"/>
        <result column="param_key" property="paramKey"/>
        <result column="param_name" property="paramName"/>
        <result column="param_type" property="paramType"/>
        <result column="value_mode" property="valueMode"/>
        <result column="unit" property="unit"/>
        <result column="default_value" property="defaultValue"/>
        <result column="default_min" property="defaultMin"/>
        <result column="default_max" property="defaultMax"/>
        <result column="is_required" property="isRequired"/>
        <result column="remark" property="remark"/>
        <result column="create_user" property="createUser"/>
        <result column="create_time" property="createTime"/>
        <result column="update_user" property="updateUser"/>
        <result column="update_time" property="updateTime"/>
        <result column="tenant_id" property="tenantId"/>
    </resultMap>


</mapper>