# 项目详情风险总览员工列表分页后端验证记录

## 验证范围

- `risk-people` 分页接口契约
- `risk-people` 控制器返回结构
- 风险人员分页 SQL 结构与排序
- 风险人员分页服务映射与默认值

## 设计文档检查

- 已核对设计文档路径：`docs/design/2026-03-29-project-detail-risk-overview-risk-people-pagination-design.md`

## 验证命令

```bash
mvn -pl ccdi-project -am -Dtest=CcdiProjectOverviewServiceStructureTest,CcdiProjectOverviewControllerTest,CcdiProjectOverviewMapperSqlTest,CcdiProjectOverviewServiceImplTest -Dsurefire.failIfNoSpecifiedTests=false test
```

## 验证结果

- 验证日期：2026-03-29
- 首轮契约测试按计划先失败，失败点为缺少 `CcdiProjectRiskPeopleQueryDTO` 与 `CcdiProjectRiskPeopleOverviewVO` 的分页字段访问器。
- 完成分页 DTO、VO、Controller、Service、Mapper 与 XML 改造后，重新执行上述命令，`CcdiProjectOverviewServiceStructureTest`、`CcdiProjectOverviewControllerTest`、`CcdiProjectOverviewMapperSqlTest`、`CcdiProjectOverviewServiceImplTest` 共 25 个测试全部通过。
- Maven 过程中仅出现 Mockito 动态 agent 的现有 JDK 警告，无新增 failure 或 error。

## 结论

- `GET /ccdi/project/overview/risk-people` 已改为标准分页接口，入参为 `projectId + pageNum + pageSize`。
- 接口已稳定返回 `rows + total + pageNum + pageSize`。
- 风险人员查询已基于 `ccdi_project_overview_employee_result` 实现数据库真分页，排序规则保持 `risk_level_sort asc, model_count desc, rule_count desc, staff_id_card asc` 不变。
- `risk-people` 默认分页已固定回落为 `pageNum = 1`、`pageSize = 5`。
