# 导出报告风险总览口径修复实施记录

## 修改时间

2026-06-29

## 修改内容

- 修复结果总览“导出报告”PDF 中风险总览指标仍使用员工单侧口径的问题。
- PDF 顶部风险指标改为“总人数 = 高风险 + 中风险 + 低风险 + 外部人员”口径。
- PDF 第三章标题由“风险模型”调整为“风险总览”，避免标题与指标内容不一致。
- 当项目没有外部人员风险统计、外部模型汇总和外部人员预警明细时，PDF 不再输出“外部人员预警”空段落。
- 不在 PDF 中额外展示“员工 X / 外部 Y”拆分说明，风险总览五项指标为总人数、高风险、中风险、低风险、外部人员。
- 同步调整结果总览页面顶部统计卡，删除“员工 X · 外部 Y”拆分说明，并将“无风险人员”替换为“外部人员”。
- 删除流水明细查询页标题下的“按项目范围查询交易明细并查看详情”备注。

## 影响范围

- 后端结果总览 PDF 报告导出器。
- 后端 PDF 导出单元测试。
- 前端结果总览统计卡。
- 前端流水明细查询标题区。

## 验证情况

- 已执行 `mvn -pl ccdi-project -DskipTests compile`，后端主代码编译通过。
- 已执行 `mvn -pl ccdi-project -Dtest=CcdiProjectOverviewReportPdfExporterTest test`，主代码编译通过，测试编译阶段被当前工作区既有的涉疑交易导出字段测试阻塞；阻塞点为 `CcdiProjectSuspiciousTransactionExcel` 已切换到新字段，而部分既有测试仍引用 `setSuspiciousPersonName`、`getSummaryAndCashType` 等旧字段。
- 已使用 `C:\Users\20696\AppData\Roaming\nvm\v14.21.3\node.exe` 执行前端生产构建，构建通过。
- 前端构建存在既有包体积告警，且 `ruoyi-ui/public` 下临时 docx 文件被打包进 dist；该问题不属于本次统计口径调整。
- 已通过 `Invoke-WebRequest http://localhost:8080/` 确认当前前端服务返回 200。
- 浏览器自动化验证受环境限制未完成：Chrome DevTools 通道被当前本机 Chrome profile 占用，终端 Playwright 前置 `npx` 不可用；未关闭用户现有浏览器进程。
