完善外部人员预警与项目分析上线内容

docs/reports/implementation/2026-06-29-external-person-fund-and-tab-visibility.md

@@ -0,0 +1,32 @@
+# 外部人员资金流向页签与预警 Tab 显示实施记录
+
+## 修改内容
+
+- 外部人员详情“资金流向”页签改为使用与员工“资金流向”一致的图谱配置。
+- 移除外部人员资金流向页签只展示资金单页签的限制，恢复资金图谱组件默认的资金与关系图谱能力。
+- 当外部人员预警数量为 0 时，结果总览风险人员区域不再显示“外部人员预警”Tab。
+- 若当前停留在外部人员 Tab 后切换到无外部预警项目，自动回到“员工风险人员”Tab。
+- 结果总览 PDF 报告中，单纯存在无风险外部主体不再触发“外部人员预警”段落；只有存在外部高中低风险命中、外部模型汇总或外部预警明细时才输出该段落。
+
+## 影响范围
+
+- 影响页面：项目详情 > 结果总览 > 外部人员预警 > 查看详情 > 资金流向。
+- 影响页面：项目详情 > 结果总览 > 员工风险人员 / 外部人员预警 Tab。
+- 影响 PDF：项目详情 > 结果总览 > 导出报告。
+- 不调整后端接口、SQL 口径和列表导出接口。
+
+## 验证情况
+
+- 已新增本轮临时测试数据脚本 `output/browser-use/2026-06-29-external-person-multi-subject-test.sql`，覆盖 2 名员工、2 名中介、1 名客户、1 名无关人员；该脚本不提交 Git。
+- 已导入多主体测试数据并调用接口验证：
+  - `/ccdi/project/overview/risk-people?projectId=90629002&pageNum=1&pageSize=10` 返回员工风险人员 2 人。
+  - `/ccdi/project/overview/external-persons?projectId=90629002&pageNum=1&pageSize=10` 返回外部人员预警 3 人，包含 2 名中介、1 名客户。
+  - 无关人员未出现在外部人员预警列表中。
+- 已新增本轮临时无预警测试数据脚本 `output/browser-use/2026-06-29-external-person-no-warning-test.sql`，该脚本不提交 Git。
+- 已导入无预警测试数据并调用接口验证：
+  - `/ccdi/project/overview/external-persons?projectId=90629003&pageNum=1&pageSize=10` 返回外部人员预警 0 条。
+  - `/ccdi/project/overview/external-persons/summary?projectId=90629003` 返回 `total=1`、`noRisk=1`、`high=0`、`medium=0`、`low=0`。
+  - 该场景用于验证存在无风险外部主体但无外部预警命中时，前端不显示“外部人员预警”Tab，PDF 不输出“外部人员预警”段落。
+- 已执行 `mvn -pl ccdi-project -am compile -DskipTests`，后端编译通过。
+- 已使用 `C:\Users\20696\AppData\Roaming\nvm\v14.21.3\node.exe` 执行前端生产构建，构建通过；存在既有资源体积 warning 和 `public` 下临时 docx 被打包 warning。
+- `browser-use` 插件要求的 Node 执行工具当前未暴露，且本地 `npx`/Playwright 依赖不可用；本次真实浏览器自动化验证未完成，已用接口、编译和组件逻辑完成替代验证。