diff --git a/docs/test-records/model-param-frontend-alignment-test.md b/docs/test-records/model-param-frontend-alignment-test.md new file mode 100644 index 00000000..80f6d8d3 --- /dev/null +++ b/docs/test-records/model-param-frontend-alignment-test.md @@ -0,0 +1,71 @@ +# 模型参数前端动态展示验证记录 + +## 验证时间 + +- 2026-03-16 + +## 验证环境 + +- 前端地址:`http://localhost` +- 后端地址:`http://localhost:62318` +- 登录账号:`admin/admin123` +- 本次验证复用了本地已在运行的开发服务: + - 前端 `vue-cli-service serve` + - 后端 `RuoYiApplication` +- 本次验证未额外启动新的前后端进程,因此测试结束时没有新增进程需要关闭 + +## 联调前基线核对 + +- 全局参数接口:`GET /ccdi/modelParam/listAll?projectId=0` + - 返回 `5` 个模型、`16` 个参数 +- 默认项目样本:`projectId=36` + - `GET /ccdi/project/36` 返回 `configType=default` + - `GET /ccdi/modelParam/listAll?projectId=36` 返回 `5` 个模型、`16` 个参数 +- 历史 custom 项目样本:`projectId=32` + - `GET /ccdi/project/32` 返回 `configType=custom` + - `GET /ccdi/modelParam/listAll?projectId=32` 返回 `0` 个模型、`0` 个参数 + +## 全局参数页验证 + +- 页面路径:`/modelParam` +- 验证结果: + - 页面按接口返回动态渲染出 `5` 张模型卡片 + - 模型标题、参数名称、描述、单位均直接展示接口返回值 + - 输入框录入 `1111000` 时页面未自动插入千分位逗号 + - 修改一个参数后提示 `已修改 1 个参数` + - 点击保存后页面重新拉取接口,修改值保留 + - 无修改时再次点击保存,提示 `没有需要保存的修改` + +## 项目参数页验证 + +- 默认项目页面路径:`/ccdiProject/detail/36?tab=config` +- 默认项目验证结果: + - 初始页面标签显示 `默认配置` + - 页面展示完整 `5` 个模型,与系统默认参数全集一致 + - 修改一个参数后提示 `已修改 1 个参数` + - 保存并整页刷新后,页面标签切换为 `自定义配置` + - 刷新后修改值仍与接口返回一致 + +- 历史 custom 项目页面路径:`/ccdiProject/detail/32?tab=config` +- 历史 custom 项目验证结果: + - 页面标签显示 `自定义配置` + - 页面展示空状态 `暂无参数配置数据` + - 未补齐系统默认模型和参数,符合“仅展示自身已有参数”的接口驱动行为 + +## 数据清理 + +- 为避免联调污染现有测试数据,验证完成后已执行恢复: + - 全局参数 `projectId=0 / LARGE_TRANSACTION / SINGLE_TRANSACTION_AMOUNT` 恢复为 `1111` + - 删除 `projectId=36` 测试保存产生的项目参数副本 + - 将 `projectId=36` 的 `configType` 恢复为 `default` +- 清理后复核结果: + - `GET /ccdi/project/36` 返回 `configType=default` + - `GET /ccdi/modelParam/listAll?projectId=36` 再次返回系统默认参数全集 + +## 结论 + +- 前端页面已满足以下目标: + - 展示完全由接口返回驱动 + - 不再包含千分位格式化设计 + - 修改计数、无修改保存提示、保存后回刷行为一致 +- 默认项目与历史 custom 项目在页面表现上均与当前后端接口语义一致