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

## 变更概述

- 新增结果总览风险接口设计文档 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/`。
- 由于本轮用户明确要求直接完成设计与计划，不再分段等待确认，故本记录视为本次设计收口材料。
