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

**日期**: 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 评审环节，改为人工复核文档后进入后续实施计划阶段