# 模型参数阈值更新接口优化设计

## 1. 背景

当前 `ModelParamSaveDTO` 存在参数冗余问题：
- 外层包含不必要的 `modelName` 字段
- 内层 `ParamItem` 包含 6 个字段，但 Service 层只使用 `paramCode` 和 `paramValue`
- 前端请求体包含大量无用字段，增加网络传输开销

## 2. 优化目标

- 简化 DTO 结构，减少冗余字段
- 减少前端请求数据量
- 提升代码可读性

## 3. 设计方案

### 3.1 后端 DTO 简化

**文件：** `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/ModelParamSaveDTO.java`

**改动：**
- 移除 `modelName` 字段
- 将内部类 `ParamItem` 重命名为 `ParamValueItem`
- 内部类只保留 `paramCode` 和 `paramValue` 两个字段

**优化后结构：**
```java
@Data
public class ModelParamSaveDTO {
    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;
    }
}
```

### 3.2 Service 层微调

**文件：** `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java`

**改动：** 更新循环中的类型引用
```java
// 改动前
for (ModelParamSaveDTO.ParamItem item : saveDTO.getParams())

// 改动后
for (ModelParamSaveDTO.ParamValueItem item : saveDTO.getParams())
```

### 3.3 前端请求简化

**文件：** `ruoyi-ui/src/views/ccdi/modelParam/index.vue`

**改动：** 简化 `handleSave` 方法中的请求参数

**优化后：**
```javascript
const saveDTO = {
  projectId: this.queryParams.projectId,
  modelCode: this.queryParams.modelCode,
  params: modifiedParams.map((item) => ({
    paramCode: item.paramCode,
    paramValue: item.paramValue,
  })),
};
```

## 4. 改动文件清单

| 文件 | 改动类型 |
|------|---------|
| `ModelParamSaveDTO.java` | 简化字段 |
| `CcdiModelParamServiceImpl.java` | 类型引用更新 |
| `index.vue` | 请求参数简化 |

## 5. 优化效果

| 指标 | 优化前 | 优化后 |
|------|--------|--------|
| DTO 外层字段数 | 3 | 2 |
| DTO 内层字段数 | 6 | 2 |
| 前端请求体字段数 | 8 | 4 |

## 6. 风险评估

- **风险等级：** 低
- **向后兼容：** 是（后端忽略多余字段）
- **测试要求：** 验证保存功能正常

---

**创建日期：** 2026-02-26
