# 结果总览风险接口后端实施记录

## 本次改动

- 新增结果总览专用 Controller、Service、Mapper 与 VO
- 新增风险仪表盘、风险人员总览、中高风险人员 TOP10 三个后端接口
- 新增员工维度风险聚合 SQL，按命中去重规则数划分高、中、低风险
- 在项目流水标签重算成功后刷新并回写项目高、中、低风险人数
- 同步补充结构测试、SQL 结构测试、服务层测试、控制器测试以及打标回写测试
- 联调阶段根据真实环境反馈，将代表性规则选择 SQL 从窗口函数改为 MySQL 5.7 兼容的 `not exists` 实现
- 联调阶段根据真实重算反馈，将风险人数汇总结果读取逻辑从 `Integer` 强转改为 `Number.intValue()`，兼容 MySQL 聚合返回 `BigDecimal`

## 未包含内容

- 未扩展风险模型区接口
- 未扩展风险明细区接口
- 未增加设计范围外的导出、降级或补丁逻辑

## 涉及模块

- `ccdi-project`
- `docs/tests/records`
- `docs/reports/implementation`

## 验证情况

- 计划内核心验证 11 个测试全部通过
- 受影响回归用例 8 个测试全部通过
- 真实后端联调已确认 3 个结果总览接口可访问，其中风险人员总览与 TOP10 可返回真实数据
- 真实重算 `projectId=43` 已确认任务成功并写回高风险人数
- 修复 MySQL 5.7 兼容问题与 `BigDecimal` 取值问题后，完整验证总计 21 个测试通过，详见 `docs/tests/records/2026-03-19-results-overview-risk-api-backend-verification.md`
