docs: 添加项目详情参数配置页面设计文档
This commit is contained in:
24
.opencode
Normal file
24
.opencode
Normal 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"
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -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. 详细设计
|
||||
|
||||
详细设计文档已保存在本文件中,包含:
|
||||
- 架构设计
|
||||
- 组件设计
|
||||
- 数据流设计
|
||||
- 错误处理
|
||||
- 测试策略
|
||||
|
||||
完整设计文档请查看项目仓库。
|
||||
Reference in New Issue
Block a user