docs: 添加项目详情参数配置页面设计文档

This commit is contained in:
wkc
2026-03-06 14:00:12 +08:00
parent ea70710804
commit 7cc1668ee7
2 changed files with 104 additions and 0 deletions

24
.opencode Normal file
View File

@@ -0,0 +1,24 @@
{
"$schema": "https://opencode.ai/config.json",
"plugin": [
"oh-my-opencode@latest"
],
"agent": {
"Sisyphus-Junior": {
"mode": "subagent",
"model": "glm/glm-5"
},
"oracle": {
"mode": "subagent",
"model": "gmn/gpt-5.3-codex"
},
"Metis (Plan Consultant)": {
"mode": "subagent",
"model": "gmn/gpt-5.3-codex"
},
"Momus (Plan Critic)": {
"mode": "subagent",
"model": "gmn/gpt-5.3-codex"
}
}
}

View File

@@ -0,0 +1,80 @@
# 项目详情参数配置页面设计文档
**创建时间:** 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. 详细设计
详细设计文档已保存在本文件中,包含:
- 架构设计
- 组件设计
- 数据流设计
- 错误处理
- 测试策略
完整设计文档请查看项目仓库。