补充结果总览员工结果表前端验证记录

This commit is contained in:
wkc
2026-03-22 12:07:46 +08:00
parent d619a7a34c
commit dda1da78db
2 changed files with 71 additions and 0 deletions

View File

@@ -0,0 +1,31 @@
# 结果总览员工结果表前端实施记录
## 本次改动
- 更新 [`project-overview-api.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/project-overview-api.test.js),补充结果总览 4 个既有接口路径断言,并锁定模型区人员接口继续透传 `projectId``modelCodes``matchMode``keyword``deptId``pageNum``pageSize`
- 更新 [`preliminary-check-api-integration.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-api-integration.test.js),锁定 [`PreliminaryCheck.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/PreliminaryCheck.vue) 仍并发请求仪表盘、风险人员总览、模型卡片 3 类接口,且不感知结果表底层实现。
- 更新 [`preliminary-check-summary-and-people.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-summary-and-people.test.js)、[`preliminary-check-risk-people-binding.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-risk-people-binding.test.js),锁定风险仪表盘指标文案、风险人员总览列结构、核心异常点标签拆分与空数组保护。
- 更新 [`preliminary-check-model-and-detail.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-and-detail.test.js)、[`preliminary-check-model-linkage-flow.test.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/tests/unit/preliminary-check-model-linkage-flow.test.js),锁定模型区 `ANY / ALL`、关键词筛选、部门筛选、重置与分页参数构造,以及风险明细区静态结构。
## 处理说明
- 本次前端未新增页面、路由、交互,也未调整结果总览现有组件拆分。
- 本次未修改 [`projectOverview.js`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/api/ccdi/projectOverview.js)、[`PreliminaryCheck.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/PreliminaryCheck.vue)、[`RiskPeopleSection.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/RiskPeopleSection.vue)、[`RiskModelSection.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/RiskModelSection.vue) 源码;新增断言后源码已满足契约,因此本轮实施以测试加固为主。
- 本次重点是把“后端切换为员工结果表出数后,前端 API 消费方式与展示边界保持不变”沉淀为显式回归保护,避免后续改动误触接口路径、请求参数或页面结构。
- 本次未启动前后端开发服务,仅执行 Node 单测脚本,因此不存在额外进程清理动作。
## 验证情况
- 已于 2026-03-22 执行以下定向验证:
```bash
cd ruoyi-ui
node tests/unit/project-overview-api.test.js
node tests/unit/preliminary-check-api-integration.test.js
node tests/unit/preliminary-check-summary-and-people.test.js
node tests/unit/preliminary-check-model-and-detail.test.js
node tests/unit/preliminary-check-risk-people-binding.test.js
node tests/unit/preliminary-check-model-linkage-flow.test.js
```
- 上述 6 条命令全部 `exit 0`,说明结果总览页 API 契约、展示契约和模型区联动边界在当前实现下保持稳定。

View File

@@ -0,0 +1,40 @@
# 结果总览员工结果表前端验证记录
## 验证范围
- 结果总览既有接口路径保持不变
- 模型区人员查询参数透传保持不变
- 结果总览入口页并发取数结构保持不变
- 风险仪表盘、风险人员总览、模型区与风险明细区展示边界保持不变
- 页面不重新引入已移除的 TOP10 区块
## 执行日期
- 2026-03-22
## 验证命令
```bash
cd ruoyi-ui
node tests/unit/project-overview-api.test.js
node tests/unit/preliminary-check-api-integration.test.js
node tests/unit/preliminary-check-summary-and-people.test.js
node tests/unit/preliminary-check-model-and-detail.test.js
node tests/unit/preliminary-check-risk-people-binding.test.js
node tests/unit/preliminary-check-model-linkage-flow.test.js
```
## 每条命令结果
- `node tests/unit/project-overview-api.test.js``exit 0`,确认 `/ccdi/project/overview/dashboard``/ccdi/project/overview/risk-people``/ccdi/project/overview/risk-models/cards``/ccdi/project/overview/risk-models/people` 4 个接口路径仍为当前前端契约,模型区人员分页参数继续按既有字段透传。
- `node tests/unit/preliminary-check-api-integration.test.js``exit 0`,确认入口页仍通过 `Promise.all` 并发请求仪表盘、风险人员总览、模型卡片 3 类接口,未感知结果表底层实现。
- `node tests/unit/preliminary-check-summary-and-people.test.js``exit 0`,确认风险仪表盘继续展示 `总人数``高风险``中风险``低风险``无风险人员`,风险人员总览继续展示姓名、身份证号、所属部门、风险等级、命中模型数、核心异常点。
- `node tests/unit/preliminary-check-model-and-detail.test.js``exit 0`,确认模型区仍保留 `ANY / ALL`、关键词筛选、部门筛选与异常标签展示,风险明细区静态结构未被破坏。
- `node tests/unit/preliminary-check-risk-people-binding.test.js``exit 0`,确认风险人员总览仍绑定 `overviewList`,核心异常点支持标签归一化,且未回退到 `topRiskList`
- `node tests/unit/preliminary-check-model-linkage-flow.test.js``exit 0`,确认模型卡片选中/取消、重置、分页与参数构造仍按既有联动流程工作。
## 结论
- 结果总览页前端未新增页面和交互,当前实现已满足“后端改为员工结果表出数后前端契约不变”的要求。
- 本轮主要收益是把现有稳定行为沉淀为显式单测,降低后续改动引入接口漂移、展示漂移或联动回归的风险。
- 本轮验证仅执行前端 Node 单测脚本,未启动额外前后端进程,因此无需执行进程清理。