ccdi/doc/plans/2026-02-26-model-param-save-optimization-plan.md

模型参数阈值更新接口优化实施计划

For Claude: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

Goal: 简化模型参数保存接口的 DTO 结构，减少冗余字段

Architecture: 纯重构，不改变业务逻辑。简化 DTO 字段，同步更新 Service 和前端调用

Tech Stack: Java 17, Spring Boot, Vue.js

---

Task 1: 简化后端 DTO

Files:

• Modify: ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/ModelParamSaveDTO.java

Step 1: 读取当前 DTO 文件

检查现有代码结构。

Step 2: 重写 DTO 文件

将整个文件替换为简化后的版本：

package com.ruoyi.ccdi.project.domain.dto;

import lombok.Data;
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.NotNull;
import java.util.List;

/**
 * 模型参数保存DTO
 */
@Data
public class ModelParamSaveDTO {

    /** 项目ID */
    private Long projectId;

    /** 模型编码 */
    @NotBlank(message = "模型编码不能为空")
    private String modelCode;

    /** 参数列表 */
    @NotNull(message = "参数列表不能为空")
    private List<ParamValueItem> params;

    @Data
    public static class ParamValueItem {

        /** 参数编码 */
        @NotBlank(message = "参数编码不能为空")
        private String paramCode;

        /** 参数值 - 唯一可修改字段 */
        @NotBlank(message = "参数值不能为空")
        private String paramValue;
    }
}

Step 3: 保存文件

确保文件保存成功。

---

Task 2: 更新 Service 层类型引用

Files:

• Modify: ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java

Step 1: 更新 for 循环中的类型引用

找到第 105 行附近的代码，将：

for (ModelParamSaveDTO.ParamItem item : saveDTO.getParams()) {

改为：

for (ModelParamSaveDTO.ParamValueItem item : saveDTO.getParams()) {

---

Task 3: 简化前端请求参数

Files:

• Modify: ruoyi-ui/src/views/ccdi/modelParam/index.vue

Step 1: 找到 handleSave 方法中的 saveDTO 构建

定位到第 119-133 行。

Step 2: 简化请求参数

将原有的 saveDTO 构建代码：

const saveDTO = {
  projectId: this.queryParams.projectId,
  modelCode: this.queryParams.modelCode,
  modelName: this.modelList.find(
    (m) => m.modelCode === this.queryParams.modelCode
  )?.modelName,
  params: modifiedParams.map((item) => ({
    paramCode: item.paramCode,
    paramName: item.paramName,
    paramDesc: item.paramDesc,
    paramValue: item.paramValue,
    paramUnit: item.paramUnit,
    sortOrder: item.sortOrder,
  })),
};

替换为简化版本：

const saveDTO = {
  projectId: this.queryParams.projectId,
  modelCode: this.queryParams.modelCode,
  params: modifiedParams.map((item) => ({
    paramCode: item.paramCode,
    paramValue: item.paramValue,
  })),
};

---

Task 4: 编译后端验证

Files:

• 无文件修改，仅验证

Step 1: 编译后端项目

cd D:/ccdi/ccdi && mvn clean compile -DskipTests

Expected: BUILD SUCCESS

Step 2: 如有编译错误，检查类型引用

确保所有 ParamItem 都已改为 ParamValueItem。

---

Task 5: 功能测试验证

Files:

• 无文件修改，仅验证

Step 1: 启动后端服务

cd D:/ccdi/ccdi && mvn spring-boot:run

等待服务启动完成。

Step 2: 通过 Swagger 测试保存接口

1. 访问 http://localhost:8080/swagger-ui/index.html
2. 找到 模型参数配置 分组
3. 测试 /ccdi/modelParam/save 接口
4. 使用简化的请求体：

{
  "projectId": 0,
  "modelCode": "LARGE_TRANSACTION",
  "params": [
    {
      "paramCode": "SINGLE_AMOUNT",
      "paramValue": "50000"
    }
  ]
}

Expected: 返回 {"code": 200, "msg": "保存成功"}

Step 3: 验证参数已更新

调用 /ccdi/modelParam/list?projectId=0&modelCode=LARGE_TRANSACTION

Expected: 返回的参数中 SINGLE_AMOUNT 的 paramValue 已更新为 50000

---

Task 6: 提交代码

Step 1: 查看变更

git status
git diff

Step 2: 提交后端改动

git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/ModelParamSaveDTO.java
git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java
git commit -m "refactor: 简化 ModelParamSaveDTO，移除冗余字段"

Step 3: 提交前端改动

git add ruoyi-ui/src/views/ccdi/modelParam/index.vue
git commit -m "refactor: 简化模型参数保存请求参数"

---

改动摘要

文件	改动
ModelParamSaveDTO.java	移除 modelName，ParamItem 简化为 ParamValueItem（2字段）
CcdiModelParamServiceImpl.java	类型引用 ParamItem → ParamValueItem
index.vue	请求参数只保留 paramCode 和 paramValue

风险等级： 低（向后兼容，纯简化重构）

---

创建日期： 2026-02-26