ccdi/docs/reports/implementation/2026-03-29-project-detail-risk-overview-risk-people-pagination-design-record.md

项目详情风险总览员工列表分页设计记录

日期: 2026-03-29

本次产出

• 新增正式设计文档 docs/design/2026-03-29-project-detail-risk-overview-risk-people-pagination-design.md
• 将“风险总览员工列表固定 5 条分页展示”收口为“改造现有 risk-people 接口为标准分页接口”方案

设计结论

后端

• 保持 GET /ccdi/project/overview/risk-people 路径不变
• 入参扩展为 projectId + pageNum + pageSize
• 返回结构统一为 rows + total + pageNum + pageSize
• 基于 ccdi_project_overview_employee_result 做数据库分页，不走全量查询后截断
• 排序规则继续沿用现有口径，不新增筛选条件

前端

• PreliminaryCheck.vue 首屏固定请求第一页，每页 5 条
• RiskPeopleSection.vue 改为消费 rows 分页数据并新增分页条
• 翻页时仅刷新风险总览员工列表，不重载风险仪表盘、风险模型和风险明细

边界约束

• 不新增 risk-people/page 之类的补丁接口
• 不在前端做本地数组切片分页
• 不修改风险等级、命中模型数、核心异常点的业务口径
• 不删除现有 top-risk-people 接口
• 本次仅完成设计沉淀，尚未进入代码实施

说明

• 设计文档已按仓库规范保存到 docs/design/
• 由于仓库协作约定禁止开启 subagent，本次不走技能中的 subagent 评审环节，改为人工复核文档后进入后续实施计划阶段