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

结果总览风险接口计划记录

变更概述

• 新增结果总览风险接口设计文档 1 份。
• 新增结果总览风险接口后端实施计划 1 份。
• 新增结果总览风险接口前端实施计划 1 份。
• 本次仅完成设计与计划沉淀，尚未进入代码实现阶段。

新增文件

• docs/design/2026-03-19-results-overview-risk-api-design.md
• docs/plans/backend/2026-03-19-results-overview-risk-api-backend-implementation.md
• docs/plans/frontend/2026-03-19-results-overview-risk-api-frontend-implementation.md

设计结论

• 结果总览采用 3 个独立接口：风险仪表盘、风险人员总览、中高风险人员 TOP10。
• 风险人员榜单统一按员工维度聚合，员工亲属命中归并到所属员工。
• 员工风险等级按命中去重规则数分级：
  • 5 条及以上：高风险
  • 2 到 4 条：中风险
  • 1 条：低风险
• 项目表高、中、低风险人数在项目流水标签打标成功后统一回写。

计划结论

• 后端计划聚焦结果总览 Controller、Service、Mapper、聚合 SQL 与打标后人数回写。
• 前端计划聚焦 3 个结果总览风险接口接入，不扩展风险模型区和风险明细区。
• 后续实施阶段需分别补充前后端验证记录与实施记录。

说明

• 本次按仓库规范将设计文档落在 docs/design/，将实施计划分别落在 docs/plans/backend/ 与 docs/plans/frontend/。
• 由于本轮用户明确要求直接完成设计与计划，不再分段等待确认，故本记录视为本次设计收口材料。