接口变动
This commit is contained in:
@@ -1,80 +0,0 @@
|
|||||||
# 项目详情参数配置页面设计文档
|
|
||||||
|
|
||||||
**创建时间：** 2026-03-06
|
|
||||||
**作者：** Claude Code
|
|
||||||
**状态：** 已批准
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 1. 概述
|
|
||||||
|
|
||||||
### 1.1 需求背景
|
|
||||||
|
|
||||||
纪检初核系统需要在项目详情页面中添加参数配置功能，允许用户为每个项目自定义模型参数配置。当前系统已有独立的模型参数配置页面（管理系统默认参数），需要将其功能复用到项目详情页面中。
|
|
||||||
|
|
||||||
### 1.2 核心需求
|
|
||||||
|
|
||||||
1. **配置模式：** 自动切换模式（修改即切换为 custom）
|
|
||||||
2. **界面布局：** 完全复用独立页面的布局（模型下拉框 + 参数表格 + 保存按钮）
|
|
||||||
3. **重置功能：** 不提供切换回默认配置的功能
|
|
||||||
4. **初始化策略：** 查询时复制（按需创建自定义参数）
|
|
||||||
|
|
||||||
### 1.3 设计原则
|
|
||||||
|
|
||||||
1. **最小改动原则：** 前端组件直接复用代码，后端只修改必要的方法
|
|
||||||
2. **自动切换原则：** 用户保存参数时自动从 default 切换到 custom
|
|
||||||
3. **按需创建原则：** 只在首次保存时创建项目自定义参数，不预复制
|
|
||||||
4. **数据隔离原则：** 项目自定义参数与系统默认参数完全独立
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 2. 实施步骤
|
|
||||||
|
|
||||||
### 2.1 后端开发
|
|
||||||
|
|
||||||
**文件：** `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java`
|
|
||||||
|
|
||||||
**修改方法：**
|
|
||||||
|
|
||||||
1. **selectParamList 方法** - 根据 configType 返回对应的参数
|
|
||||||
2. **saveParams 方法** - 首次保存时自动复制默认参数并切换 configType
|
|
||||||
3. **新增 copyDefaultParamsToProject 私有方法** - 复制默认参数到项目
|
|
||||||
|
|
||||||
**文件：** `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiModelParamMapper.xml`
|
|
||||||
|
|
||||||
**新增 SQL：**
|
|
||||||
|
|
||||||
1. `updateParamValue` - 更新参数值
|
|
||||||
2. `insertBatch` - 批量插入参数
|
|
||||||
|
|
||||||
### 2.2 前端开发
|
|
||||||
|
|
||||||
**文件：** `ruoyi-ui/src/views/ccdiProject/components/detail/ParamConfig.vue`
|
|
||||||
|
|
||||||
**功能：**
|
|
||||||
|
|
||||||
1. 模型选择下拉框
|
|
||||||
2. 参数配置表格（可编辑）
|
|
||||||
3. 保存按钮
|
|
||||||
|
|
||||||
**API：** 复用 `ruoyi-ui/src/api/ccdi/modelParam.js`
|
|
||||||
|
|
||||||
### 2.3 测试（不需要后端单元测试）
|
|
||||||
|
|
||||||
**测试方式：**
|
|
||||||
|
|
||||||
1. 手动测试清单
|
|
||||||
2. 集成测试脚本（可选）
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 3. 详细设计
|
|
||||||
|
|
||||||
详细设计文档已保存在本文件中，包含：
|
|
||||||
- 架构设计
|
|
||||||
- 组件设计
|
|
||||||
- 数据流设计
|
|
||||||
- 错误处理
|
|
||||||
- 测试策略
|
|
||||||
|
|
||||||
完整设计文档请查看项目仓库。
|
|
||||||
@@ -1,723 +0,0 @@
|
|||||||
# 项目详情参数配置页面实施计划
|
|
||||||
|
|
||||||
> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.
|
|
||||||
|
|
||||||
**Goal:** 在项目详情页面实现参数配置功能，允许每个项目自定义模型参数，首次保存时自动从系统默认参数复制。
|
|
||||||
|
|
||||||
**Architecture:** 前端组件复用独立页面代码，后端修改 Service 根据 configType 返回对应参数，首次保存时自动复制默认参数并切换 configType。
|
|
||||||
|
|
||||||
**Tech Stack:** Spring Boot 3, MyBatis Plus, Vue.js 2, Element UI
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 1: 修改后端 Mapper 接口
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiModelParamMapper.java`
|
|
||||||
|
|
||||||
**Step 1: 添加更新参数值方法**
|
|
||||||
|
|
||||||
在 `CcdiModelParamMapper.java` 接口中添加方法：
|
|
||||||
|
|
||||||
```java
|
|
||||||
/**
|
|
||||||
* 更新参数值
|
|
||||||
*
|
|
||||||
* @param projectId 项目ID
|
|
||||||
* @param modelCode 模型编码
|
|
||||||
* @param paramCode 参数编码
|
|
||||||
* @param paramValue 参数值
|
|
||||||
* @return 影响行数
|
|
||||||
*/
|
|
||||||
int updateParamValue(@Param("projectId") Long projectId,
|
|
||||||
@Param("modelCode") String modelCode,
|
|
||||||
@Param("paramCode") String paramCode,
|
|
||||||
@Param("paramValue") String paramValue);
|
|
||||||
|
|
||||||
/**
|
|
||||||
* 批量插入参数
|
|
||||||
*
|
|
||||||
* @param params 参数列表
|
|
||||||
* @return 影响行数
|
|
||||||
*/
|
|
||||||
int insertBatch(@Param("list") List<CcdiModelParam> params);
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiModelParamMapper.java
|
|
||||||
git commit -m "feat: 添加 Mapper 接口方法 updateParamValue 和 insertBatch"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 2: 修改后端 Mapper XML
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiModelParamMapper.xml`
|
|
||||||
|
|
||||||
**Step 1: 添加 updateParamValue SQL**
|
|
||||||
|
|
||||||
在 `</mapper>` 标签之前添加：
|
|
||||||
|
|
||||||
```xml
|
|
||||||
<!-- 更新参数值 -->
|
|
||||||
<update id="updateParamValue">
|
|
||||||
UPDATE ccdi_model_param
|
|
||||||
SET param_value = #{paramValue},
|
|
||||||
update_time = NOW()
|
|
||||||
WHERE project_id = #{projectId}
|
|
||||||
AND model_code = #{modelCode}
|
|
||||||
AND param_code = #{paramCode}
|
|
||||||
</update>
|
|
||||||
|
|
||||||
<!-- 批量插入参数 -->
|
|
||||||
<insert id="insertBatch" parameterType="java.util.List">
|
|
||||||
INSERT INTO ccdi_model_param (
|
|
||||||
project_id, model_code, model_name, param_code, param_name,
|
|
||||||
param_desc, param_value, param_unit, sort_order, remark,
|
|
||||||
create_time, update_time
|
|
||||||
) VALUES
|
|
||||||
<foreach collection="list" item="item" separator=",">
|
|
||||||
(
|
|
||||||
#{item.projectId}, #{item.modelCode}, #{item.modelName},
|
|
||||||
#{item.paramCode}, #{item.paramName}, #{item.paramDesc},
|
|
||||||
#{item.paramValue}, #{item.paramUnit}, #{item.sortOrder},
|
|
||||||
#{item.remark}, NOW(), NOW()
|
|
||||||
)
|
|
||||||
</foreach>
|
|
||||||
</insert>
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ccdi-project/src/main/resources/mapper/ccdi/project/CcdiModelParamMapper.xml
|
|
||||||
git commit -m "feat: 添加 Mapper XML SQL updateParamValue 和 insertBatch"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 3: 注入 ProjectMapper 依赖
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java`
|
|
||||||
|
|
||||||
**Step 1: 添加 import 语句**
|
|
||||||
|
|
||||||
在文件顶部的 import 区域添加：
|
|
||||||
|
|
||||||
```java
|
|
||||||
import com.ruoyi.ccdi.project.domain.CcdiProject;
|
|
||||||
import com.ruoyi.ccdi.project.mapper.CcdiProjectMapper;
|
|
||||||
import org.apache.commons.lang3.StringUtils;
|
|
||||||
import org.slf4j.Logger;
|
|
||||||
import org.slf4j.LoggerFactory;
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 添加 Logger**
|
|
||||||
|
|
||||||
在类开始处添加：
|
|
||||||
|
|
||||||
```java
|
|
||||||
private static final Logger log = LoggerFactory.getLogger(CcdiModelParamServiceImpl.class);
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 3: 注入 ProjectMapper**
|
|
||||||
|
|
||||||
在 `@Resource private CcdiModelParamMapper modelParamMapper;` 之后添加：
|
|
||||||
|
|
||||||
```java
|
|
||||||
@Resource
|
|
||||||
private CcdiProjectMapper projectMapper;
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 4: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java
|
|
||||||
git commit -m "feat: 注入 CcdiProjectMapper 依赖"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 4: 修改 selectParamList 方法
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java:52-71`
|
|
||||||
|
|
||||||
**Step 1: 替换 selectParamList 方法**
|
|
||||||
|
|
||||||
完全替换 `selectParamList` 方法：
|
|
||||||
|
|
||||||
```java
|
|
||||||
@Override
|
|
||||||
public List<ModelParamVO> selectParamList(ModelParamQueryDTO queryDTO) {
|
|
||||||
// 1. 参数验证
|
|
||||||
Long projectId = queryDTO.getProjectId();
|
|
||||||
if (projectId == null) {
|
|
||||||
projectId = 0L;
|
|
||||||
}
|
|
||||||
|
|
||||||
// 2. 如果是项目查询（projectId > 0），需要根据 configType 决定查询哪组参数
|
|
||||||
Long effectiveProjectId = projectId;
|
|
||||||
if (projectId > 0) {
|
|
||||||
// 查询项目信息
|
|
||||||
CcdiProject project = projectMapper.selectById(projectId);
|
|
||||||
if (project == null) {
|
|
||||||
throw new ServiceException("项目不存在");
|
|
||||||
}
|
|
||||||
|
|
||||||
// 根据 configType 决定查询哪组参数
|
|
||||||
if ("default".equals(project.getConfigType())) {
|
|
||||||
// 使用系统默认参数
|
|
||||||
effectiveProjectId = 0L;
|
|
||||||
} else {
|
|
||||||
// 使用项目自定义参数
|
|
||||||
effectiveProjectId = projectId;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 3. 查询参数列表
|
|
||||||
List<CcdiModelParam> params = modelParamMapper.selectByProjectAndModel(
|
|
||||||
effectiveProjectId,
|
|
||||||
queryDTO.getModelCode()
|
|
||||||
);
|
|
||||||
|
|
||||||
// 4. 转换为 VO
|
|
||||||
List<ModelParamVO> result = new ArrayList<>();
|
|
||||||
params.forEach(param -> {
|
|
||||||
ModelParamVO vo = new ModelParamVO();
|
|
||||||
BeanUtils.copyProperties(param, vo);
|
|
||||||
result.add(vo);
|
|
||||||
});
|
|
||||||
|
|
||||||
return result;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java
|
|
||||||
git commit -m "feat: 修改 selectParamList 方法支持根据 configType 返回对应参数"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 5: 添加 copyDefaultParamsToProject 私有方法
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java`
|
|
||||||
|
|
||||||
**Step 1: 添加复制参数方法**
|
|
||||||
|
|
||||||
在 `saveParams` 方法之后添加：
|
|
||||||
|
|
||||||
```java
|
|
||||||
/**
|
|
||||||
* 复制系统默认参数到项目
|
|
||||||
*
|
|
||||||
* @param projectId 项目ID
|
|
||||||
* @param modelCode 模型编码
|
|
||||||
* @return 复制的参数数量
|
|
||||||
*/
|
|
||||||
private int copyDefaultParamsToProject(Long projectId, String modelCode) {
|
|
||||||
// 查询系统默认参数
|
|
||||||
List<CcdiModelParam> defaultParams = modelParamMapper.selectByProjectAndModel(0L, modelCode);
|
|
||||||
|
|
||||||
if (defaultParams.isEmpty()) {
|
|
||||||
log.warn("系统默认参数为空，modelCode={}", modelCode);
|
|
||||||
return 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
// 复制到项目
|
|
||||||
List<CcdiModelParam> projectParams = defaultParams.stream()
|
|
||||||
.map(param -> {
|
|
||||||
CcdiModelParam newParam = new CcdiModelParam();
|
|
||||||
BeanUtils.copyProperties(param, newParam);
|
|
||||||
newParam.setId(null); // 清空ID，让数据库自动生成
|
|
||||||
newParam.setProjectId(projectId);
|
|
||||||
newParam.setCreateBy(null); // 清空审计字段，让 MyBatis Plus 自动填充
|
|
||||||
newParam.setCreateTime(null);
|
|
||||||
newParam.setUpdateBy(null);
|
|
||||||
newParam.setUpdateTime(null);
|
|
||||||
return newParam;
|
|
||||||
})
|
|
||||||
.collect(Collectors.toList());
|
|
||||||
|
|
||||||
// 批量插入
|
|
||||||
int count = modelParamMapper.insertBatch(projectParams);
|
|
||||||
|
|
||||||
log.info("复制系统默认参数到项目成功，projectId={}, modelCode={}, count={}",
|
|
||||||
projectId, modelCode, count);
|
|
||||||
|
|
||||||
return count;
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java
|
|
||||||
git commit -m "feat: 添加 copyDefaultParamsToProject 私有方法"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 6: 修改 saveParams 方法
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java:74-122`
|
|
||||||
|
|
||||||
**Step 1: 替换 saveParams 方法**
|
|
||||||
|
|
||||||
完全替换 `saveParams` 方法：
|
|
||||||
|
|
||||||
```java
|
|
||||||
@Override
|
|
||||||
@Transactional(rollbackFor = Exception.class)
|
|
||||||
public void saveParams(ModelParamSaveDTO saveDTO) {
|
|
||||||
try {
|
|
||||||
// 1. 参数验证
|
|
||||||
if (saveDTO.getProjectId() == null) {
|
|
||||||
throw new ServiceException("项目ID不能为空");
|
|
||||||
}
|
|
||||||
if (StringUtils.isBlank(saveDTO.getModelCode())) {
|
|
||||||
throw new ServiceException("模型编码不能为空");
|
|
||||||
}
|
|
||||||
if (saveDTO.getParams() == null || saveDTO.getParams().isEmpty()) {
|
|
||||||
throw new ServiceException("参数列表不能为空");
|
|
||||||
}
|
|
||||||
|
|
||||||
Long projectId = saveDTO.getProjectId();
|
|
||||||
|
|
||||||
// 2. 如果是项目保存（projectId > 0），需要检查是否首次保存
|
|
||||||
if (projectId > 0) {
|
|
||||||
// 查询项目信息
|
|
||||||
CcdiProject project = projectMapper.selectById(projectId);
|
|
||||||
if (project == null) {
|
|
||||||
throw new ServiceException("项目不存在");
|
|
||||||
}
|
|
||||||
|
|
||||||
// 3. 如果是首次保存（configType=default），需要复制系统默认参数
|
|
||||||
if ("default".equals(project.getConfigType())) {
|
|
||||||
int copiedCount = copyDefaultParamsToProject(projectId, saveDTO.getModelCode());
|
|
||||||
if (copiedCount == 0) {
|
|
||||||
log.warn("系统默认参数为空，projectId={}, modelCode={}",
|
|
||||||
projectId, saveDTO.getModelCode());
|
|
||||||
}
|
|
||||||
|
|
||||||
// 更新项目配置类型为 custom
|
|
||||||
project.setConfigType("custom");
|
|
||||||
projectMapper.updateById(project);
|
|
||||||
|
|
||||||
log.info("项目配置类型已更新为 custom，projectId={}", projectId);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
// 4. 更新参数值
|
|
||||||
String username = SecurityUtils.getUsername();
|
|
||||||
for (ModelParamSaveDTO.ParamValueItem item : saveDTO.getParams()) {
|
|
||||||
int updated = modelParamMapper.updateParamValue(
|
|
||||||
projectId,
|
|
||||||
saveDTO.getModelCode(),
|
|
||||||
item.getParamCode(),
|
|
||||||
item.getParamValue()
|
|
||||||
);
|
|
||||||
if (updated == 0) {
|
|
||||||
log.warn("参数不存在或未更新，paramCode={}", item.getParamCode());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
} catch (ServiceException e) {
|
|
||||||
// 业务异常，直接抛出
|
|
||||||
throw e;
|
|
||||||
} catch (Exception e) {
|
|
||||||
// 系统异常，记录日志并抛出
|
|
||||||
log.error("保存模型参数失败", e);
|
|
||||||
throw new ServiceException("保存模型参数失败：" + e.getMessage());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java
|
|
||||||
git commit -m "feat: 修改 saveParams 方法支持首次保存自动复制默认参数"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 7: 实现前端 ParamConfig 组件（模板部分）
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ParamConfig.vue`
|
|
||||||
|
|
||||||
**Step 1: 替换模板部分**
|
|
||||||
|
|
||||||
完全替换文件内容：
|
|
||||||
|
|
||||||
```vue
|
|
||||||
<template>
|
|
||||||
<div class="param-config-container">
|
|
||||||
<!-- 模型选择区域 -->
|
|
||||||
<div class="filter-section">
|
|
||||||
<el-form :inline="true" :model="queryParams">
|
|
||||||
<el-form-item label="模型名称">
|
|
||||||
<el-select
|
|
||||||
v-model="queryParams.modelCode"
|
|
||||||
placeholder="请选择模型"
|
|
||||||
@change="handleModelChange"
|
|
||||||
>
|
|
||||||
<el-option
|
|
||||||
v-for="model in modelList"
|
|
||||||
:key="model.modelCode"
|
|
||||||
:label="model.modelName"
|
|
||||||
:value="model.modelCode"
|
|
||||||
/>
|
|
||||||
</el-select>
|
|
||||||
</el-form-item>
|
|
||||||
</el-form>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- 参数配置表格 -->
|
|
||||||
<div class="table-section">
|
|
||||||
<h3>阈值参数配置</h3>
|
|
||||||
<el-table :data="paramList" border style="width: 100%">
|
|
||||||
<el-table-column label="监测项" prop="paramName" width="200" />
|
|
||||||
<el-table-column label="描述" prop="paramDesc" />
|
|
||||||
<el-table-column label="阈值设置" width="200">
|
|
||||||
<template #default="{ row }">
|
|
||||||
<el-input
|
|
||||||
v-model="row.paramValue"
|
|
||||||
placeholder="请输入阈值"
|
|
||||||
@input="markAsModified(row)"
|
|
||||||
/>
|
|
||||||
</template>
|
|
||||||
</el-table-column>
|
|
||||||
<el-table-column label="单位" prop="paramUnit" width="120" />
|
|
||||||
</el-table>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<!-- 操作按钮 -->
|
|
||||||
<div class="button-section">
|
|
||||||
<el-button
|
|
||||||
type="primary"
|
|
||||||
@click="handleSave"
|
|
||||||
:loading="saving"
|
|
||||||
>
|
|
||||||
保存配置
|
|
||||||
</el-button>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</template>
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ruoyi-ui/src/views/ccdiProject/components/detail/ParamConfig.vue
|
|
||||||
git commit -m "feat: 实现 ParamConfig 组件模板部分"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 8: 实现前端 ParamConfig 组件（脚本部分）
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ParamConfig.vue`
|
|
||||||
|
|
||||||
**Step 1: 添加脚本部分**
|
|
||||||
|
|
||||||
在 `</template>` 之后添加：
|
|
||||||
|
|
||||||
```vue
|
|
||||||
|
|
||||||
<script>
|
|
||||||
import { listModels, listParams, saveParams } from "@/api/ccdi/modelParam";
|
|
||||||
|
|
||||||
export default {
|
|
||||||
name: 'ParamConfig',
|
|
||||||
props: {
|
|
||||||
projectId: {
|
|
||||||
type: [String, Number],
|
|
||||||
required: true
|
|
||||||
},
|
|
||||||
projectInfo: {
|
|
||||||
type: Object,
|
|
||||||
default: () => ({})
|
|
||||||
}
|
|
||||||
},
|
|
||||||
data() {
|
|
||||||
return {
|
|
||||||
modelList: [],
|
|
||||||
queryParams: {
|
|
||||||
modelCode: undefined,
|
|
||||||
projectId: this.projectId
|
|
||||||
},
|
|
||||||
paramList: [],
|
|
||||||
saving: false
|
|
||||||
}
|
|
||||||
},
|
|
||||||
watch: {
|
|
||||||
projectId(newVal) {
|
|
||||||
this.queryParams.projectId = newVal
|
|
||||||
this.loadModelList()
|
|
||||||
}
|
|
||||||
},
|
|
||||||
created() {
|
|
||||||
this.loadModelList()
|
|
||||||
},
|
|
||||||
methods: {
|
|
||||||
/** 加载模型列表 */
|
|
||||||
async loadModelList() {
|
|
||||||
try {
|
|
||||||
const res = await listModels({ projectId: this.projectId })
|
|
||||||
this.modelList = res.data
|
|
||||||
if (this.modelList.length > 0) {
|
|
||||||
this.queryParams.modelCode = this.modelList[0].modelCode
|
|
||||||
this.loadParamList()
|
|
||||||
}
|
|
||||||
} catch (error) {
|
|
||||||
this.$message.error('加载模型列表失败：' + error.message)
|
|
||||||
console.error('加载模型列表失败', error)
|
|
||||||
}
|
|
||||||
},
|
|
||||||
|
|
||||||
/** 加载参数列表 */
|
|
||||||
async loadParamList() {
|
|
||||||
try {
|
|
||||||
const res = await listParams(this.queryParams)
|
|
||||||
this.paramList = res.data
|
|
||||||
} catch (error) {
|
|
||||||
this.$message.error('加载参数列表失败：' + error.message)
|
|
||||||
console.error('加载参数列表失败', error)
|
|
||||||
}
|
|
||||||
},
|
|
||||||
|
|
||||||
/** 模型切换 */
|
|
||||||
handleModelChange() {
|
|
||||||
this.loadParamList()
|
|
||||||
},
|
|
||||||
|
|
||||||
/** 标记为已修改 */
|
|
||||||
markAsModified(row) {
|
|
||||||
row.modified = true
|
|
||||||
},
|
|
||||||
|
|
||||||
/** 保存配置 */
|
|
||||||
async handleSave() {
|
|
||||||
// 验证是否有修改
|
|
||||||
const modifiedParams = this.paramList.filter(item => item.modified)
|
|
||||||
if (modifiedParams.length === 0) {
|
|
||||||
this.$message.info('没有需要保存的修改')
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// 验证参数值
|
|
||||||
const invalidParams = modifiedParams.filter(
|
|
||||||
item => !item.paramValue || item.paramValue.trim() === ''
|
|
||||||
)
|
|
||||||
if (invalidParams.length > 0) {
|
|
||||||
this.$message.error('请填写所有参数值')
|
|
||||||
return
|
|
||||||
}
|
|
||||||
|
|
||||||
// 构造保存数据
|
|
||||||
const saveDTO = {
|
|
||||||
projectId: this.projectId,
|
|
||||||
modelCode: this.queryParams.modelCode,
|
|
||||||
params: modifiedParams.map(item => ({
|
|
||||||
paramCode: item.paramCode,
|
|
||||||
paramValue: item.paramValue
|
|
||||||
}))
|
|
||||||
}
|
|
||||||
|
|
||||||
// 保存
|
|
||||||
this.saving = true
|
|
||||||
try {
|
|
||||||
await saveParams(saveDTO)
|
|
||||||
this.$message.success('保存成功')
|
|
||||||
// 清除修改标记并重新加载
|
|
||||||
this.paramList.forEach(item => { item.modified = false })
|
|
||||||
await this.loadParamList()
|
|
||||||
} catch (error) {
|
|
||||||
if (error.response && error.response.data && error.response.data.msg) {
|
|
||||||
this.$message.error('保存失败：' + error.response.data.msg)
|
|
||||||
} else {
|
|
||||||
this.$message.error('保存失败：' + error.message)
|
|
||||||
}
|
|
||||||
} finally {
|
|
||||||
this.saving = false
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
</script>
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ruoyi-ui/src/views/ccdiProject/components/detail/ParamConfig.vue
|
|
||||||
git commit -m "feat: 实现 ParamConfig 组件脚本部分"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 9: 实现前端 ParamConfig 组件（样式部分）
|
|
||||||
|
|
||||||
**Files:**
|
|
||||||
- Modify: `ruoyi-ui/src/views/ccdiProject/components/detail/ParamConfig.vue`
|
|
||||||
|
|
||||||
**Step 1: 添加样式部分**
|
|
||||||
|
|
||||||
在 `</script>` 之后添加：
|
|
||||||
|
|
||||||
```vue
|
|
||||||
|
|
||||||
<style scoped lang="scss">
|
|
||||||
.param-config-container {
|
|
||||||
padding: 20px;
|
|
||||||
background-color: #fff;
|
|
||||||
min-height: 400px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.filter-section {
|
|
||||||
padding: 15px;
|
|
||||||
background: #fff;
|
|
||||||
border-radius: 4px;
|
|
||||||
margin-bottom: 20px;
|
|
||||||
}
|
|
||||||
|
|
||||||
.table-section {
|
|
||||||
padding: 20px;
|
|
||||||
background: #fff;
|
|
||||||
border-radius: 4px;
|
|
||||||
margin-bottom: 20px;
|
|
||||||
|
|
||||||
h3 {
|
|
||||||
font-size: 16px;
|
|
||||||
font-weight: bold;
|
|
||||||
color: #333;
|
|
||||||
margin: 0 0 15px 0;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
.button-section {
|
|
||||||
padding: 15px;
|
|
||||||
background: #fff;
|
|
||||||
border-radius: 4px;
|
|
||||||
text-align: left;
|
|
||||||
}
|
|
||||||
</style>
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 2: 提交**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add ruoyi-ui/src/views/ccdiProject/components/detail/ParamConfig.vue
|
|
||||||
git commit -m "feat: 实现 ParamConfig 组件样式部分"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## Task 10: 手动测试功能
|
|
||||||
|
|
||||||
**Step 1: 启动后端服务**
|
|
||||||
|
|
||||||
提示用户手动启动后端服务（不要自动运行）。
|
|
||||||
|
|
||||||
**Step 2: 启动前端服务**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cd ruoyi-ui
|
|
||||||
npm run dev
|
|
||||||
```
|
|
||||||
|
|
||||||
**Step 3: 访问测试页面**
|
|
||||||
|
|
||||||
1. 访问 `http://localhost:80`
|
|
||||||
2. 登录系统（admin/admin123）
|
|
||||||
3. 进入"项目管理"页面
|
|
||||||
4. 点击任意项目的"详情"按钮
|
|
||||||
5. 点击"参数配置"菜单
|
|
||||||
|
|
||||||
**Step 4: 测试场景 1 - 查看默认配置**
|
|
||||||
|
|
||||||
**操作：**
|
|
||||||
- 新项目查看参数配置
|
|
||||||
|
|
||||||
**预期结果：**
|
|
||||||
- 显示系统默认参数
|
|
||||||
- 参数值与系统默认一致
|
|
||||||
|
|
||||||
**Step 5: 测试场景 2 - 首次保存参数**
|
|
||||||
|
|
||||||
**操作：**
|
|
||||||
- 修改参数值
|
|
||||||
- 点击"保存配置"
|
|
||||||
|
|
||||||
**预期结果：**
|
|
||||||
- 显示"保存成功"提示
|
|
||||||
- 项目的 `configType` 变为 `custom`
|
|
||||||
- 再次查看参数显示修改后的值
|
|
||||||
|
|
||||||
**Step 6: 测试场景 3 - 切换模型**
|
|
||||||
|
|
||||||
**操作：**
|
|
||||||
- 切换到另一个模型
|
|
||||||
|
|
||||||
**预期结果：**
|
|
||||||
- 参数列表正确切换
|
|
||||||
- 显示新模型的参数
|
|
||||||
|
|
||||||
**Step 7: 测试场景 4 - 不修改参数点击保存**
|
|
||||||
|
|
||||||
**操作：**
|
|
||||||
- 不修改任何参数
|
|
||||||
- 点击"保存配置"
|
|
||||||
|
|
||||||
**预期结果：**
|
|
||||||
- 显示"没有需要保存的修改"提示
|
|
||||||
|
|
||||||
**Step 8: 测试场景 5 - 清空参数值后保存**
|
|
||||||
|
|
||||||
**操作：**
|
|
||||||
- 清空某个参数值
|
|
||||||
- 点击"保存配置"
|
|
||||||
|
|
||||||
**预期结果：**
|
|
||||||
- 显示"请填写所有参数值"错误提示
|
|
||||||
- 不发起保存请求
|
|
||||||
|
|
||||||
**Step 9: 提交测试完成**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git add .
|
|
||||||
git commit -m "test: 项目详情参数配置功能手动测试完成"
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 完成检查清单
|
|
||||||
|
|
||||||
- [ ] 后端 Mapper 接口已修改
|
|
||||||
- [ ] 后端 Mapper XML 已修改
|
|
||||||
- [ ] 后端 Service 已修改
|
|
||||||
- [ ] 前端 ParamConfig 组件已实现
|
|
||||||
- [ ] 所有测试场景通过
|
|
||||||
- [ ] 代码已提交到 git
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 注意事项
|
|
||||||
|
|
||||||
1. **不要自动启动后端服务** - 提示用户手动启动
|
|
||||||
2. **不需要后端单元测试** - 用户明确要求
|
|
||||||
3. **首次保存会触发复制** - 确保系统默认参数存在
|
|
||||||
4. **事务回滚** - 如果复制失败，事务会自动回滚
|
|
||||||
5. **前端验证优先** - 参数值验证在前端完成
|
|
||||||
Reference in New Issue
Block a user