ccdi/docs/reports/implementation/2026-03-19-results-overview-risk-api-backend-implementation.md

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

本次改动

• 新增结果总览专用 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