# 风险人员总览疑似违规数口径调整实施记录

## 本次改动

- 为结果总览员工聚合中间 VO 新增 `hitCount` 字段，用于承接归并到员工名下的打标明细数。
- 调整 [`CcdiProjectOverviewMapper.xml`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectOverviewMapper.xml) 员工聚合 SQL，新增 `count(1) as hit_count`。
- 调整 [`CcdiProjectOverviewServiceImpl.java`](/Users/wkc/Desktop/ccdi/ccdi/ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectOverviewServiceImpl.java) 风险人员总览映射逻辑，`riskCount` 改为读取 `hitCount`。
- 保持 `ruleCount` 继续仅用于风险等级计算、TOP10 排序和项目高/中/低风险人数统计，不扩散影响范围。
- 同步补充本次后端、前端计划文档，并更新结果总览风险接口设计文档口径说明。

## 口径说明

- `riskCount`：员工本人及其亲属归并到该员工名下的打标明细数量。
- `ruleCount`：员工命中的去重规则数，仅用于风险等级和相关统计，不再直接展示为“疑似违规数”。

## 前端处理结论

- [`RiskPeopleSection.vue`](/Users/wkc/Desktop/ccdi/ccdi/ruoyi-ui/src/views/ccdiProject/components/detail/RiskPeopleSection.vue) 仍直接渲染接口返回的 `riskCount`。
- 本次无需增加前端计算或格式化补丁，只需回归验证字段绑定未变化。

## 验证情况

- 后端定向测试通过：
  - `mvn test -pl ccdi-project -Dtest=CcdiProjectOverviewServiceImplTest,CcdiProjectOverviewMapperSqlTest`
- 前端回归检查通过：
  - `cd ruoyi-ui && node tests/unit/preliminary-check-risk-people-binding.test.js`

## 未包含内容

- 未调整风险等级分级口径
- 未调整中高风险 TOP10 接口逻辑
- 未调整项目风险人数回写逻辑
