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

外部人员资金流向页签与预警 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 依赖不可用；本次真实浏览器自动化验证未完成，已用接口、编译和组件逻辑完成替代验证。