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

docs/reports/implementation/2026-06-24-external-person-warning-implementation.md

@@ -0,0 +1,64 @@
+# 外部人员预警实施记录
+
+## 保存路径确认
+
+- 后端实施计划：`docs/plans/backend/2026-06-24-external-person-warning-backend-implementation.md`
+- 前端实施计划：`docs/plans/frontend/2026-06-24-external-person-warning-frontend-implementation.md`
+- 实施记录：`docs/reports/implementation/2026-06-24-external-person-warning-implementation.md`
+- 测试数据 SQL：`sql/migration/2026-06-24-add-external-person-warning-test-data.sql`
+
+## 修改内容
+
+1. 结果总览后端新增外部人员预警接口：
+   - `GET /ccdi/project/overview/external-persons`
+   - `POST /ccdi/project/overview/external-persons/export`
+   - `GET /ccdi/project/overview/external-risk-models/cards`
+   - `GET /ccdi/project/overview/external-risk-models/people`
+   - `POST /ccdi/project/overview/external-risk-models/people/export`
+2. 后端新增外部人员预警 DTO、VO、Excel 导出对象。
+3. Mapper 新增外部人员聚合查询，基于本方 `cret_no` 排除员工和员工亲属后识别外部人员。
+4. 外部人员主体类型支持中介、客户、外部人员。
+5. 风险明细涉疑交易增加 `EXTERNAL_PERSON` 筛选口径。
+6. 前端风险人员区域增加靠后的“外部人员预警” Tab，员工风险人员仍为默认入口。
+7. 前端风险模型区域后置展示外部人员预警模型，模型导出按钮改为真实导出当前筛选命中明细。
+8. 新增外部人员预警联调测试数据 SQL。
+
+## 业务口径
+
+1. 员工仍然是结果总览默认主视图，原员工风险人员、员工模型和员工项目分析不变。
+2. 外部人员预警和员工使用同一页面风格，但不展示员工专属字段。
+3. 外部人员不进入资产分析、负面征信、部门岗位和员工画像详情。
+4. 外部人员预警模型限定为交易和关系类：
+   - 外部人员大额交易
+   - 外部人员异常交易
+   - 外部人员可疑赌博
+   - 外部人员可疑关系
+5. 中介识别优先使用中介库本人证件号匹配，不使用姓名作为主体识别依据。
+
+## 验证情况
+
+1. 已执行后端编译：
+   - `mvn -pl ccdi-project -am compile -DskipTests`
+   - 结果：通过。
+2. 测试数据 SQL 已生成。因本机执行 `bash bin/mysql_utf8_exec.sh sql/migration/2026-06-24-add-external-person-warning-test-data.sql` 失败，已改用 Java/JDBC 显式执行 `SET NAMES utf8mb4` 和 `SET collation_connection = utf8mb4_general_ci` 后入库成功。
+3. 前端执行前已按项目要求检查 Node：
+   - `.nvmrc` 为 `14.21.3`
+   - 当前 `node -v` 为 `v14.21.3`
+   - 当前环境 `npm` 不在 PATH，改用 `C:\Users\20696\AppData\Roaming\nvm\v14.21.3\node.exe node_modules/@vue/cli-service/bin/vue-cli-service.js build`
+   - 结果：构建通过，仅有既有资源体积 warning。
+4. 数据库验证：
+   - 测试项目 `90624001` 已入库 2 个外部人员主体：测试中介王某、测试客户赵某。
+   - 外部人员模型命中结果已入库 4 类：外部人员大额交易、外部人员异常交易、外部人员可疑赌博、外部人员可疑关系。
+5. 本机已有后端服务监听 `62318`，但未通过脚本重启到最新代码；项目重启脚本依赖 bash/lsof/pgrep，当前 Windows 环境缺可用 bash/WSL。
+6. 真实接口登录验证受运行环境 Redis 超时影响，`POST /login/test` 返回 `Redis command timed out`，因此未完成浏览器页面验证。
+
+## 后续验证建议
+
+1. 在具备 bash/lsof/pgrep 的环境使用 `bin/restart_java_backend.sh` 重启后端。
+2. Redis 恢复后登录系统，在真实结果总览页面验证：
+   - 员工风险人员默认展示不变。
+   - 外部人员预警 Tab 可分页加载。
+   - 外部人员预警导出可下载。
+   - 外部人员模型卡片后置展示。
+   - 风险模型导出可按当前筛选下载。
+   - 风险明细可筛选“外部人员预警”。

docs/reports/implementation/2026-06-24-external-risk-overview-prototype.md

@@ -0,0 +1,34 @@
+# 外部人员结果总览预警原型实施记录
+
+## 保存路径确认
+
+- 原型文件：`docs/prototypes/external-risk-overview-prototype.html`
+- 实施记录：`docs/reports/implementation/2026-06-24-external-risk-overview-prototype.md`
+
+## 修改内容
+
+1. 新增“结果总览 - 外部人员预警”静态 HTML 原型。
+2. 在风险主体区域保留原员工风险入口，并增加“外部人员预警”切换入口。
+3. 增加外部人员主体列表，字段包含风险主体、主体类型、证件号、风险等级、命中模型数、核心风险点和操作。
+4. 增加外部人员模型卡片，覆盖外部人员大额交易、外部人员异常交易、外部人员可疑赌博、外部人员可疑关系。
+5. 增加涉疑交易明细展示，体现外部人员与员工、员工亲属、其他外部人员之间的资金往来。
+6. 增加右侧外部人员风险详情区，展示身份识别、命中标签、核心风险点、关联交易和暂未接入的外部人员图谱空状态。
+
+## 业务口径
+
+1. 本方证件号未命中员工及员工亲属时，按外部人员进入结果总览预警。
+2. 本方证件号命中中介库本人证件号时，主体类型显示为“中介”。
+3. 除员工、员工亲属外，其余本方主体统一归入外部人员口径。
+4. 涉及员工或员工亲属的外部人员资金往来，纳入“外部人员可疑关系”模型展示。
+
+## 影响范围
+
+- 本次仅新增静态原型和实施记录。
+- 未修改 Java 后端、Vue 前端、SQL 脚本或运行配置。
+- 不影响现有系统运行逻辑。
+
+## 验证情况
+
+- 已确认目标目录存在。
+- 原型为独立 HTML 文件，可直接在浏览器打开查看。
+- 本次未启动前后端服务，未执行构建命令。

docs/reports/implementation/2026-06-25-external-person-detail-and-overall-risk-summary.md

@@ -0,0 +1,45 @@
+# 外部人员详情与整体风险统计实施记录
+
+## 修改时间
+
+2026-06-25
+
+## 修改内容
+
+- 顶部风险总览改为项目整体口径，按员工统计与外部人员预警汇总相加展示。
+- 风险总览卡片新增拆分说明，展示“员工 X · 外部 Y”。
+- 新增外部人员风险汇总接口 `/ccdi/project/overview/external-persons/summary`，按外部人员高风险、中风险、低风险、无风险返回汇总。
+- 外部人员列表与外部风险模型命中人员的操作改为“查看详情”。
+- 新增外部人员详情弹窗，包含基本信息、命中模型、交易明细入口、关系图谱空状态、关联对象入口。
+- 风险模型区域从左侧窄列表改回上下结构，上方展示紧凑模型统计块，下方展示筛选条件与命中人员表。
+- 外部人员详情弹窗改为复用员工项目分析详情的视觉结构，采用标题区、左侧人物档案、右侧页签工作区；外部人员不展示资产分析、征信摘要等员工专属页签。
+- 风险模型统计块只对外部模型展示“外部”来源标识，员工模型不再额外展示“员工”标识。
+- 外部人员汇总口径改为“导入流水中的外部主体全集”，再左关联外部预警命中结果，避免未命中模型的外部人员被排除在总人数之外。
+- 本地前端开发服务补充 history 路由回退配置，避免直接打开 `/login`、`/ccdiProject/detail/{projectId}` 等路由时返回 404。
+- 结果总览一键 PDF 报告补充外部人员内容，包括外部风险汇总、外部模型汇总、外部人员预警明细。
+- 外部人员可疑关系关联对象补充“信贷客户”：员工、员工亲属、中介库人员、信贷客户统一优先按对手方账号命中账号库；员工、员工亲属、中介库人员在账号未命中时再按对手方证件号或名称兜底；信贷客户不按名称兜底，只按对手方账号识别。
+- 外部人员可疑关系 SQL 剔除本方名称等于对手方名称的交易，避免外部主体本人账户之间互转被识别为关联关系。
+
+## 影响范围
+
+- 前端结果总览：风险总览卡片、风险人员列表、风险模型区域、外部人员详情弹窗。
+- 后端结果总览：新增外部人员风险汇总接口与 Mapper 查询。
+- 后端外部人员汇总 SQL：新增外部主体全集片段，外部预警列表仍只展示命中外部模型的人员。
+- 后端 PDF 报告导出：新增外部人员预警段落，列表导出与一键报告口径保持一致。
+- 外部人员可疑关系展示口径：按外部模型命中流水聚合，关联对象按账号库优先识别员工、员工亲属、中介库人员、信贷客户。
+- 暂不改变图谱生成逻辑，图谱入口当前为空状态。
+
+## 验证计划
+
+- 后端编译：`mvn -pl ccdi-project -am compile -DskipTests`。
+- 前端构建：使用 Node 14.21.3 执行 Vue 构建。
+- 本地页面验证：进入真实项目详情页结果总览，确认顶部统计展示员工/外部拆分，外部人员“查看详情”弹窗可打开，交易明细入口可切到流水明细查询，风险模型区域为上下结构。
+
+## 本次追加验证
+
+- 已执行 `mvn -pl ccdi-project -am compile -DskipTests`，编译通过。
+- 已使用 `C:\Users\20696\AppData\Roaming\nvm\v14.21.3\node.exe` 执行前端构建，构建通过。
+- 前端构建存在既有包体积告警，且 `ruoyi-ui/public` 下临时 docx 文件被打包进 dist；该问题不属于本次外部人员展示逻辑变更。
+- 已重启本地前端服务至 `http://localhost:8080/`，使用浏览器请求头验证 `/login` 与 `/ccdiProject/detail/90624001` 直链返回 200。
+- 已再次执行 `mvn -pl ccdi-project -am compile -DskipTests`，验证 PDF 报告外部人员字段编译通过。
+- 已再次执行 `mvn -pl ccdi-project -am compile -DskipTests`，验证外部人员可疑关系 SQL 补充信贷客户账号匹配后编译通过。

docs/reports/implementation/2026-06-25-external-person-warning-overview-fix.md

@@ -0,0 +1,24 @@
+# 外部人员预警总览与查看交易修复实施记录
+
+## 修改时间
+
+2026-06-25
+
+## 修改内容
+
+- 修复结果总览“外部人员预警”列表中“查看交易”仅提示、不跳转的问题。
+- “查看交易”现在切换到项目详情的“流水明细查询”页签，并按外部人员本方证件号过滤流水。
+- 流水明细查询新增 `ourCertNos` 查询条件，对应后端按 `ccdi_bank_statement.cret_no` 过滤。
+- 修复风险总览统计口径，顶部“总人数 / 高风险 / 中风险 / 低风险 / 无风险人员”跟随当前风险人员页签展示：员工页签展示员工口径，外部人员预警页签展示外部人员口径。
+
+## 影响范围
+
+- 前端项目详情页：结果总览、流水明细查询页签。
+- 后端流水明细查询接口：新增可选查询字段 `ourCertNos`。
+- 结果总览页面：风险统计卡片会随“员工风险人员 / 外部人员预警”页签切换口径。
+
+## 验证计划
+
+- 后端编译：`mvn -pl ccdi-project -am compile -DskipTests`。
+- 前端构建：使用 Node 14.21.3 执行 Vue 构建。
+- 本地页面验证：进入真实项目详情页，点击外部人员预警“查看交易”，确认切到“流水明细查询”并展示该外部人员本方流水。

docs/reports/implementation/2026-06-25-risk-model-section-compact-redesign.md

@@ -0,0 +1,23 @@
+# 风险模型区域紧凑化实施记录
+
+## 修改时间
+
+2026-06-25
+
+## 修改内容
+
+- 将结果总览“风险模型”区域由大卡片网格改为“左侧模型预警统计列表 + 右侧命中人员明细”的紧凑工作区。
+- 将模型操作文案由“点击加入联动 / 再次点击取消”调整为“筛选 / 已筛选”，降低业务用户理解成本。
+- 将触发方式文案由“任意触发 / 同时触发”调整为“命中任一模型 / 同时命中全部”，明确多模型筛选时的计算含义。
+- 新增“当前筛选”展示区，已选模型以标签形式展示，可单个移除或一键清空。
+- 保留原有员工模型、外部人员模型、分页、导出、查看明细和模型筛选逻辑，不新增后端接口。
+
+## 影响范围
+
+- 前端项目详情页：结果总览中的风险模型区域。
+- 不影响风险人员总览统计、专项排查、流水明细查询和后端模型计算逻辑。
+
+## 验证计划
+
+- 前端构建：使用 Node 14.21.3 执行 Vue 构建。
+- 本地页面验证：进入真实项目详情页结果总览，确认风险模型区域展示为紧凑列表，模型筛选、清空、模型关系切换、分页和导出入口可正常使用。

docs/reports/implementation/2026-06-29-external-person-bank-tag-rules.md

@@ -0,0 +1,47 @@
+# 外部人员预警打标规则实施记录
+
+## 1. 修改内容
+
+- 新增外部人员真实打标规则接入，打标任务执行后可自动向 `ccdi_bank_statement_tag_result` 写入 `EXTERNAL_*` 命中结果。
+- 新增外部人员主体识别共用 SQL：本方证件号 `bs.cret_no` 非空，且未命中员工、员工亲属；若同一主体同时存在于员工和信贷客户/中介数据中，员工/员工亲属优先，不进入外部人员口径；同时排除本方与对手方姓名或账号相同的本人账户互转。
+- 新增 4 条流水级规则：
+  - `EXTERNAL_SINGLE_LARGE_AMOUNT`：外部人员单笔大额交易，复用 `LARGE_TRANSACTION` 的 `FREQUENT_TRANSFER` 阈值。
+  - `EXTERNAL_NIGHT_TRANSACTION`：外部人员夜间交易，识别 22:00 至次日 06:00 的外部主体交易。
+  - `EXTERNAL_GAMBLING_MEMO`：外部人员疑似赌博摘要，识别摘要、交易类型或对手方名称中的赌博敏感词。
+  - `EXTERNAL_TO_STAFF_FAMILY_TRANSACTION`：外部人员与员工或员工亲属交易，按对手方账号或对手方名称命中员工/员工亲属，不使用对手方证件号。
+- 新增 3 条对象级规则：
+  - `EXTERNAL_CUMULATIVE_TRANSACTION_AMOUNT`：外部人员累计交易金额超限，按外部人员证件号聚合，复用 `LARGE_TRANSACTION` 的 `CUMULATIVE_TRANSACTION_AMOUNT` 阈值。
+  - `EXTERNAL_ANNUAL_TURNOVER`：外部人员近一年流水超限，按外部人员证件号聚合，复用 `LARGE_TRANSACTION` 的 `ANNUAL_TURNOVER` 阈值。
+  - `EXTERNAL_MULTI_PARTY_GAMBLING_TRANSFER`：外部人员疑似多人牌局/赌博资金往来，按同一外部人员、同一交易日、多个对手方聚合，复用 `SUSPICIOUS_GAMBLING` 的 `MULTI_PARTY_AMT_MIN`、`MULTI_PARTY_AMT_MAX` 阈值。
+- 新增规则元数据迁移脚本：`sql/migration/2026-06-29-add-external-person-bank-tag-rules.sql`。
+- 打标服务 `CcdiBankTagServiceImpl` 新增外部人员流水级、对象级规则分发。
+- 参数解析器 `BankTagRuleConfigResolver` 新增跨模型参数映射：外部人员大额类规则读取 `LARGE_TRANSACTION` 阈值，外部人员疑似赌博对象规则读取 `SUSPICIOUS_GAMBLING` 阈值。
+- 风险等级口径调整为：外部人员单笔大额、累计交易超限、年流水交易额超限为中风险；外部人员与员工/亲属交易、同日多对手方疑似赌博交易为高风险。
+- 结果总览外部人员来源 SQL 同时纳入流水级命中和对象级命中；对象级命中按外部人员证件号关联，展示涉及对象为“资金”。
+- 外部人员对手方关联对象识别调整为账号优先：对手方账号命中信贷客户账号时展示“信贷客户”；对手方账号命中员工/员工亲属账号时展示“员工/员工亲属”；只有对手方账号未命中任何已维护账号时，员工/员工亲属才按对手方名称补充识别。
+
+## 2. 影响范围
+
+- 后端打标链路：`CcdiBankTagServiceImpl`、`BankTagRuleConfigResolver`、`CcdiBankTagAnalysisMapper`。
+- 数据库规则元数据：`ccdi_bank_tag_rule` 新增外部人员 7 条规则。
+- 结果总览外部人员预警会消费 `ccdi_bank_statement_tag_result` 中的 `EXTERNAL_*` 流水级与对象级命中结果。
+
+## 3. 验证情况
+
+- 相关单测通过：`mvn -pl ccdi-project "-Dtest=CcdiBankTagAnalysisMapperXmlTest,CcdiBankTagServiceImplTest,BankTagRuleConfigResolverTest,CcdiProjectOverviewMapperSqlTest" test`，共 54 个用例通过。
+- 后端模块编译通过：`mvn -pl ccdi-project -am compile -DskipTests`。
+- 本地数据库迁移执行成功：`bin/mysql_utf8_exec.sh sql/migration/2026-06-29-add-external-person-bank-tag-rules.sql`。
+- 查询 `ccdi_bank_tag_rule` 确认 7 条外部人员规则均已落库且 `enabled=1`。
+- 验证覆盖：
+  - 外部人员规则 SQL 存在且不是占位 SQL。
+  - 外部人员关系规则包含对手方账号、名称命中员工或员工亲属的判断，不使用对手方证件号。
+  - 外部人员总览的对手方关联对象展示优先按账号判断，账号命中信贷客户时不再被同名员工覆盖；员工、员工亲属也是账号优先，账号未命中时才按名称判断。
+  - 打标服务能分发外部人员流水级和对象级规则。
+  - 外部人员大额类规则能复用原大额交易阈值。
+  - 外部人员疑似赌博对象规则能复用原疑似赌博阈值。
+  - 结果总览外部人员来源能同时包含流水级和对象级命中。
+
+## 4. 后续运行说明
+
+- 真实环境需要先执行 `sql/migration/2026-06-29-add-external-person-bank-tag-rules.sql`，使 7 条外部人员规则进入 `ccdi_bank_tag_rule`。
+- 执行项目流水打标重算后，外部人员规则会自动生成 `EXTERNAL_*` 命中结果，结果总览外部人员预警即可展示真实命中数据。

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

@@ -0,0 +1,34 @@
+# 外部人员详情页异常明细与资金流向页签调整实施记录
+
+## 1. 修改内容
+
+- 调整 `ExternalPersonDetailDialog.vue`：外部人员详情的“异常明细”复用员工查看详情中的 `ProjectAnalysisAbnormalTab` 展示结构。
+- 外部人员异常明细拆分为“流水异常明细”和“对象异常明细”：流水型命中展示具体流水表格，对象型命中仅列出规则、异常原因和摘要。
+- 将原“交易明细”跳转入口移除，不再从外部人员详情跳转到流水明细查询。
+- 将原“关联对象”页签移除，新增明确的“资金流向”页签，直接展示资金图谱组件 `ProjectAnalysisFundFlowTab`。
+- 清理 `PreliminaryCheck.vue` 中外部人员详情跳转流水明细的事件绑定和处理方法。
+
+## 2. 影响范围
+
+- 影响页面：项目详情 > 结果总览 > 外部人员预警 > 查看详情。
+- 不修改后端接口、SQL 口径、菜单权限和导出接口。
+- 原员工风险人员“查看详情”不受影响。
+
+## 3. 验证情况
+
+- 前端生产构建：`npm run build:prod` 通过，仅有既有资源体积 warning。
+- 同步调整 `ProjectAnalysisFundFlowTab.vue`：资金流向页签按 `initialGraphTab='fund'` 进入资金布局，支持外部人员详情只展示资金流向能力。
+- 本地真实页面地址：`http://localhost:8080/#/ccdiProject/detail/90624001?tab=overview`。
+
+## 4. 二次调整
+
+- 外部人员“异常明细”不再把每个模型做成主体字段卡片。
+- 新增按外部人员证件号加载流水明细，命中流水型外部模型的记录展示在“流水异常明细”表格中。
+- 只有能在外部人员流水明细命中标签中匹配到的规则进入“流水异常明细”；没有对应具体流水的对象型规则进入“对象异常明细”，例如年流水超限。
+- 对象型外部模型不展示主体字段堆叠，只在“对象异常明细”中列出模型规则、异常原因和摘要。
+- 外部人员详情仍只保留“异常明细”和“资金流向”两个页签；员工专属的资产、征信等模块不在外部人员详情中展示。
+
+## 5. 三次调整
+
+- 删除外部人员详情弹窗头部右侧“分析主体 xxx”信息块，避免与左侧人物档案重复展示。
+- 在外部人员详情头部右侧增加关闭 `X`，点击后关闭详情弹窗并返回列表。

docs/reports/implementation/2026-06-29-external-person-detail-loading.md

@@ -0,0 +1,25 @@
+# 外部人员详情加载态修正实施记录
+
+## 修改内容
+
+- 修正外部人员“查看详情”弹窗打开时先显示前端拼装的“对象异常明细”兜底内容的问题。
+- 加载流水异常明细前先清空 `statementRows`。
+- `detailLoading` 为 `true` 时不渲染异常明细组件，仅展示独立加载区域。
+- 流水接口返回后再渲染真实异常明细内容。
+- 加载完成后，未匹配到单笔流水的对象级规则仍保留为“对象异常明细”分组。
+
+## 影响范围
+
+- 影响页面：项目详情 > 结果总览 > 外部人员预警 > 查看详情。
+- 影响文件：`ruoyi-ui/src/views/ccdiProject/components/detail/ExternalPersonDetailDialog.vue`。
+- 不影响员工风险人员详情弹窗。
+- 不调整后端接口。
+
+## 验证情况
+
+- 已完成静态链路验证：
+  - `detailLoading` 为 `true` 时不再挂载 `ProjectAnalysisAbnormalTab`。
+  - 加载前会清空 `statementRows`，避免沿用上一轮流水数据。
+  - 加载期间只显示 `.external-detail-loading` 独立加载区域。
+  - `abnormalDetailData` 只在加载完成后计算；未匹配到单笔流水的 `riskTags` 仍会生成 `EXTERNAL_OBJECT_WARNING` 对象异常分组。
+- 真实页面验证受当前结果总览接口状态限制：刷新 `http://localhost:8080/ccdiProject/detail/90624001` 后页面进入“暂无结果总览数据”，无法稳定打开外部人员详情做端到端复核。

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 依赖不可用；本次真实浏览器自动化验证未完成，已用接口、编译和组件逻辑完成替代验证。

docs/reports/implementation/2026-06-29-external-person-warning-acceptance-doc-and-verification.md

@@ -0,0 +1,21 @@
+# 外部人员预警验收文档与验证实施记录
+
+## 1. 修改内容
+
+- 新增外部人员预警结果总览验收清单：`docs/tests/plans/2026-06-29-external-person-warning-acceptance-checklist.md`。
+- 新增外部人员预警结果总览测试用例：`docs/tests/plans/2026-06-29-external-person-warning-test-cases.md`。
+- 后续测试执行记录保存到：`docs/tests/records/2026-06-29-external-person-warning-verification-record.md`。
+
+## 2. 影响范围
+
+- 本次仅新增测试计划、测试用例与验证记录文档。
+- 不修改业务代码、SQL 口径、菜单、权限或构建配置。
+- 验收重点为：外部人员预警、空身份证号排除、外部人员详情、流水明细证件号联动、导出与报告内容。
+
+## 3. 验证计划
+
+- 后端执行 `mvn -pl ccdi-project -am compile -DskipTests`。
+- 前端命令执行前先尝试 `nvm use` 并记录 Node 版本。
+- 使用本地真实服务验证外部人员预警接口。
+- 使用 `browser-use` 打开真实项目详情页结果总览，不打开原型页。
+- 测试完成后关闭本轮启动的前后端进程。

docs/reports/implementation/2026-06-29-external-person-warning-table-semantics.md

@@ -0,0 +1,21 @@
+# 外部人员预警列表字段语义修正实施记录
+
+## 修改内容
+
+- 移除外部人员预警列表中的“命中模型数 / 命中模型”列。
+- “核心异常点”继续展示 `riskPointTagList[].ruleName`。
+- “涉及对象”继续展示后端 `relatedObject`，用于表达交易对手方对象类型。
+
+## 影响范围
+
+- 影响页面：项目详情 > 结果总览 > 外部人员预警。
+- 影响文件：`ruoyi-ui/src/views/ccdiProject/components/detail/RiskPeopleSection.vue`。
+- 不影响员工风险人员列表。
+- 不新增后端接口，不调整后端查询口径。
+
+## 验证情况
+
+- 已使用真实页面验证 `http://localhost:8080/ccdiProject/detail/90624001`：
+  - 切换到结果总览“外部人员预警(2)”Tab。
+  - 表头保留“核心异常点 / 涉及对象”，不再显示“命中模型数 / 命中模型”列。
+  - “核心异常点”展示规则名称，如“外部人员夜间集中交易、外部人员单笔大额交易、外部人员与员工亲属交易”。

docs/reports/implementation/2026-06-29-overview-report-risk-summary-pdf-fix.md

@@ -0,0 +1,31 @@
+# 导出报告风险总览口径修复实施记录
+
+## 修改时间
+
+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` 不可用；未关闭用户现有浏览器进程。

docs/reports/implementation/2026-06-29-project-analysis-feature-list.md

@@ -0,0 +1,77 @@
+# 项目分析功能清单
+
+## 范围说明
+
+本清单汇总项目详情页结果总览、外部人员预警、风险明细导出和专项分析相关能力，包含近期已保存的外部人员相关改动，以及 2026-06-29 沟通中确认的小调整。
+
+## 外部人员预警
+
+- 结果总览支持展示“外部人员预警”列表。
+- 支持按外部人员主体展示姓名、证件号、主体类型、风险等级、风险次数、核心异常点和涉及对象。
+- 核心异常点展示命中规则名称，不再展示“命中模型数 / 命中模型”列。
+- 涉及对象展示交易对手方对象类型，用于区分外部人员关联对象语义。
+- 外部人员预警列表与员工风险人员列表在同一区域分 Tab 展示。
+- 当外部人员预警数量为 0 时，不显示“外部人员预警”Tab。
+- 后端保留外部人员预警列表导出能力，但前端列表右上角的小型导出入口已移除。
+
+## 外部人员详情
+
+- 外部人员预警支持“查看详情”。
+- 详情弹窗展示外部人员基础信息和风险摘要。
+- 详情页只保留“异常明细”和“资金流向”两个页签。
+- 异常明细复用项目分析异常明细结构。
+- 流水型命中展示在“流水异常明细”中，包含具体流水记录和命中标签。
+- 对象型命中展示在“对象异常明细”中，仅展示规则、异常原因和摘要。
+- 详情加载期间清空上一轮流水数据，只展示加载态，避免先显示前端拼装的兜底异常明细。
+- 详情头部已移除重复的“分析主体”信息块，保留右上角关闭入口。
+
+## 外部人员资金流向页签
+
+- 外部人员详情新增“资金流向”页签。
+- 资金流向页签使用与员工“资金流向”一致的资金图谱配置。
+- 外部人员详情不展示员工专属的资产、征信等页签。
+- 原“关联对象”页签和“交易明细”跳转入口已移除。
+
+## 结果总览与报告
+
+- 结果总览顶部统计卡将“无风险人员”调整为“外部人员”。
+- 统计卡不再额外展示“员工 X / 外部 Y”拆分说明。
+- 导出报告 PDF 顶部风险指标按“高风险 + 中风险 + 低风险 + 外部人员”汇总。
+- PDF 第三章标题调整为“风险总览”。
+- 当项目没有外部人员风险统计、外部模型汇总和外部人员预警明细时，PDF 不输出外部人员预警空段落。
+- 单纯存在无风险外部主体但没有外部预警命中时，PDF 不输出“外部人员预警”段落。
+- 结果总览顶部“导出报告”入口保留。
+
+## 风险明细导出
+
+- 涉疑交易明细导出字段已对齐流水明细查询导出结构。
+- 导出字段为：交易时间、本方账户、本方主体、对方名称、对方账户、关联员工、摘要、交易类型、异常标签、交易金额。
+- 风险明细整体导出继续包含“涉疑交易明细 / 员工负面征信信息 / 异常账户人员信息”三个工作表。
+- 单独涉疑交易导出和风险明细整体导出中的涉疑交易工作表使用同一字段结构。
+
+## 风险人员列表入口清理
+
+- 移除结果总览“风险人员”区域 Tab 右侧的小型“导出”按钮。
+- 保留结果总览顶部“导出报告”入口。
+- 保留后端员工风险人员和外部人员预警导出接口。
+
+## 专项分析
+
+- 专项分析位于项目详情页，用于围绕项目员工开展员工家庭资产负债核查和业务拓展查询。
+- 员工范围口径已调整为项目流水员工：`ccdi_bank_statement.project_id` 匹配当前项目，且流水 `cret_no` 能关联到 `ccdi_base_staff.id_card`。
+- 调整后，项目流水中存在的员工即使没有打标命中，也会进入专项分析范围。
+- 员工家庭资产负债专项核查展示员工本人及配偶的收入、资产、负债汇总，并按核查结果展示正常、存在风险、高风险、缺少信息。
+- 专项分析包含资金图谱入口。
+- 拓展查询包含采购拓展、招聘拓展和调动拓展。
+
+## 验收与测试文档
+
+- 已保存外部人员预警验收清单。
+- 已保存外部人员预警测试用例。
+- 后续验证记录路径已规划到 `docs/tests/records/`。
+
+## 未改变的口径
+
+- 员工风险人员结果总览仍按打标命中结果统计。
+- 打标命中结果表和风险人数统计不因专项分析范围调整而改变。
+- 负面征信和异常账户查询逻辑不在本清单调整范围内。

docs/reports/implementation/2026-06-29-project-analysis-ui-and-interface-check.md

@@ -0,0 +1,38 @@
+# 项目分析页 UI 与接口排查实施记录
+
+## 修改时间
+
+2026-06-29
+
+## 修改范围
+
+- 员工预警查看详情弹窗
+- 外部人员预警详情弹窗
+- 结果总览风险模型命中人员列表
+- 本地结果总览相关接口排查
+
+## 修改内容
+
+1. 员工预警查看详情弹窗右上角补充关闭按钮，交互与外部人员详情弹窗保持一致。
+2. 外部人员预警详情页签文案由“资金”调整为“资金流向”。
+3. 风险模型区域在未筛选特定模型时，默认展示全部模型命中人员：
+   - 员工模型命中人员与外部人员模型命中人员合并展示；
+   - 表格增加“来源”列区分员工和外部；
+   - 未筛选模型时不显示部门筛选，避免仅员工维度条件影响全部列表；
+   - 选中员工模型或外部模型后，仍按对应模型类型调用原有分页接口。
+4. 本地接口排查结果：
+   - 登录、风险总览、员工风险人员、风险模型卡片、员工模型命中人员、外部模型命中人员、涉疑交易、征信负面、外部人员汇总接口均返回 200；
+   - 报告导出接口可成功生成 PDF；
+   - 报告导出实测耗时超过前端普通请求 10 秒超时阈值，已将通用下载请求超时时间调整为 120 秒；
+   - 日志中历史报错主要为客户端断开连接、导出超时和 Druid 慢 SQL 按 ERROR 级别输出，并非当前接口不可用。
+
+## 影响范围
+
+- 前端页面行为变更限于项目详情结果总览内的弹窗、页签文案、风险模型人员列表和通用下载超时时间。
+- 后端接口本次未修改。
+
+## 验证情况
+
+- 已通过本地 HTTP 调用验证核心结果总览接口均返回成功。
+- 已验证报告导出生成 PDF 文件。
+- 已查看前端开发服务日志，最新编译成功。

docs/reports/implementation/2026-06-29-risk-people-list-export-entry-removal.md

@@ -0,0 +1,22 @@
+# 结果总览人员列表导出入口移除实施记录
+
+## 修改内容
+
+- 移除结果总览“风险人员”区域 Tab 右侧的小型“导出”按钮。
+- 删除前端组件中对应的 `handleRiskPeopleExport` 方法。
+- 保留顶部“导出报告”入口，项目级 PDF 报告导出不受影响。
+- 保留后端员工风险人员与外部人员预警列表导出接口，本次不做接口删除。
+
+## 影响范围
+
+- 影响页面：项目详情 > 结果总览 > 员工风险人员 / 外部人员预警。
+- 影响文件：`ruoyi-ui/src/views/ccdiProject/components/detail/RiskPeopleSection.vue`。
+- 不影响：结果总览顶部“导出报告”、风险模型导出、风险明细导出、后端导出接口。
+
+## 验证情况
+
+- 已静态搜索确认前端组件内不再存在人员列表导出按钮调用。
+- 已使用真实页面验证 `http://localhost:8080/ccdiProject/detail/90342?tab=overview`：
+  - 顶部“导出报告”入口仍正常展示。
+  - “员工风险人员 / 外部人员预警”Tab 正常展示。
+  - 风险人员列表右上角不再显示小型“导出”入口。

docs/reports/implementation/2026-06-29-special-check-project-employee-scope.md

@@ -0,0 +1,19 @@
+# 专项分析项目员工范围实施记录
+
+## 修改内容
+
+- 将专项分析公共员工范围从“项目打标命中员工”调整为“项目流水对应员工”。
+- 修改文件：`ccdi-project/src/main/resources/mapper/ccdi/project/CcdiProjectSpecialCheckMapper.xml`。
+- 员工范围来源改为 `ccdi_bank_statement`，通过 `project_id` 和 `cret_no` 关联 `ccdi_base_staff.id_card`。
+
+## 影响范围
+
+- 未命中打标规则但在项目流水中存在的员工，会进入专项分析。
+- 专项分析下资产负债核查、采购拓展、招聘拓展、调动拓展共用调整后的员工范围。
+- 不改变打标结果表和结果总览风险人员汇总口径。
+
+## 验证情况
+
+- 已核对银行流水实体 `CcdiBankStatement` 包含 `projectId` 与 `cretNo` 字段。
+- 已核对项目目标人数修复脚本使用相同口径：银行流水身份证号匹配员工主数据。
+- 已执行 `mvn -pl ccdi-project -am compile`，编译通过。

docs/reports/implementation/2026-06-29-suspicious-transaction-export-fields.md

@@ -0,0 +1,24 @@
+# 涉疑交易明细导出字段调整实施记录
+
+## 1. 修改内容
+
+- 调整涉疑交易明细导出字段，改为对齐“流水明细查询”导出结构。
+- 导出字段变更为：交易时间、本方账户、本方主体、对方名称、对方账户、关联员工、摘要、交易类型、异常标签、交易金额。
+- 涉疑交易导出复用报告涉疑交易查询，确保导出包含本方/对方账户信息和异常标签。
+- 结果总览风险明细页顶部“导出”按钮继续调用风险明细整体导出接口，仍导出“涉疑交易明细 / 员工负面征信信息 / 异常账户人员信息”三个工作表。
+- 风险明细整体导出中的“涉疑交易明细”工作表同步使用新字段。
+
+## 2. 影响范围
+
+- 影响页面：项目详情 > 结果总览 > 风险明细 > 导出。
+- 影响接口：`/ccdi/project/overview/risk-details/export` 与 `/ccdi/project/overview/suspicious-transactions/export` 的涉疑交易字段结构。
+- 不修改涉疑交易页面分页查询口径，不修改负面征信和异常账户查询逻辑。
+
+## 3. 验证情况
+
+- 后端模块编译：`mvn -pl ccdi-project -am compile -DskipTests` 通过；存在既有 `ccdi-info-collection` 重复依赖 warning。
+- 前端生产构建：`npm run build:prod` 通过；存在既有资源体积 warning 和 `public` 下临时 docx 被打包 warning。
+- 应用打包：`mvn -pl ruoyi-admin -am package -DskipTests` 通过。
+- 本地后端已使用新包重启，端口 `62318` 当前监听进程为新启动的 Java 进程。
+- 实际调用 `/ccdi/project/overview/risk-details/export` 下载 Excel，确认“涉疑交易明细”表头为：交易时间、本方账户、本方主体、对方名称、对方账户、关联员工、摘要、交易类型、异常标签、交易金额；同时保留“员工负面征信信息”“异常账户人员信息”两个工作表。
+- 实际调用 `/ccdi/project/overview/suspicious-transactions/export` 下载 Excel，确认单独涉疑交易导出表头同样为上述新字段。

docs/reports/implementation/2026-06-30-local-production-release-feature-list.md

@@ -0,0 +1,295 @@
+# 2026-06-30 单提交生产发布功能清单
+
+## 1. 发布范围
+
+本清单说明本地分支 `dev-ui` 相对远程 `origin/dev-ui` 的单提交发布内容。
+
+本次生产发布建议以当前本地 `HEAD` 单提交 `完善外部人员预警与项目分析上线内容` 为准，准确提交号以 `git log -1 --oneline` 输出为准。
+
+对比基线：
+
+- 远程基线：`origin/dev-ui`，当前提交为 `4e90e22e 优化项目详情资金流向图谱展示`。
+- 本地提交：当前本地 `HEAD`，提交说明为 `完善外部人员预警与项目分析上线内容`。
+- 提交数量：1 个。
+- 文件范围：76 个文件，覆盖后端、前端、SQL、测试与实施文档。
+
+## 2. 本次提交改了哪些内容
+
+### 2.1 后端接口与领域对象
+
+改动范围：
+
+- 修改 `CcdiProjectOverviewController`，新增外部人员预警、外部风险模型卡片、外部模型命中人员和导出入口。
+- 新增外部人员查询 DTO、外部风险模型命中人员 DTO。
+- 新增外部人员预警列表 VO、汇总 VO、外部风险汇总 VO。
+- 新增外部人员预警导出对象、风险模型命中人员导出对象。
+- 调整涉疑交易明细导出对象，补齐流水基础字段和关联员工字段。
+
+实现结果：
+
+- 结果总览具备外部人员预警接口能力。
+- 外部人员模型命中人员可以分页查询和导出。
+- 风险明细导出的“涉疑交易明细”更接近流水明细查询导出格式。
+
+### 2.2 后端 SQL 与服务逻辑
+
+改动范围：
+
+- 修改 `CcdiProjectOverviewMapper.xml`，新增外部人员识别、汇总、列表、外部模型、外部模型命中人员 SQL。
+- 修改 `CcdiBankTagAnalysisMapper.xml`，新增外部人员规则打标 SQL。
+- 修改 `CcdiBankStatementMapper.xml`，支持按本方证件号查询流水。
+- 修改 `CcdiProjectSpecialCheckMapper.xml`，调整专项分析员工范围。
+- 修改 `BankTagRuleConfigResolver`、`CcdiBankTagServiceImpl`，接入外部人员规则参数和执行分发。
+- 修改 `CcdiProjectOverviewServiceImpl`，组装外部人员预警、风险模型、详情导出、PDF 数据。
+- 修改 `CcdiProjectRiskDetailWorkbookExporter` 和 `CcdiProjectOverviewReportPdfExporter`。
+
+实现结果：
+
+- 外部人员以流水本方证件号 `bs.cret_no` 识别。
+- 外部主体必须证件号非空，且不是员工、不是员工亲属。
+- 外部主体再匹配中介库、信贷客户库，区分“中介 / 客户 / 外部人员”。
+- 外部人员对象级命中和流水级命中都能进入结果总览。
+- 专项分析员工范围改为项目流水覆盖员工，而不是只看打标命中员工。
+
+### 2.3 前端页面与交互
+
+改动范围：
+
+- 新增 `ExternalPersonDetailDialog.vue`。
+- 修改结果总览入口 `PreliminaryCheck.vue`。
+- 修改风险人员区 `RiskPeopleSection.vue`。
+- 修改风险模型区 `RiskModelSection.vue`。
+- 修改项目分析弹窗、侧栏、资金流向 Tab、流水明细查询标题等组件。
+- 修改 `projectOverview.js`，补充外部人员相关 API。
+
+实现结果：
+
+- 结果总览风险人员区域新增“外部人员预警”页签。
+- 外部人员详情在当前页面弹窗打开，不再跳转流水明细查询。
+- 外部人员详情只保留“异常明细”和“资金流向”两个页签。
+- 外部人员没有员工专属的资产、征信等模块。
+- 风险模型区域同时支持员工模型和外部人员模型。
+- 修复外部模型重复渲染导致的 Vue duplicate key 问题。
+
+### 2.4 测试、文档和 SQL
+
+改动范围：
+
+- 新增或调整后端单测，覆盖外部人员 SQL、规则参数、服务分发、PDF、Excel 导出。
+- 新增后端和前端实施计划、实施记录、验收记录。
+- 新增外部风险总览原型文档。
+- 新增外部人员规则生产 SQL。
+- 新增外部人员预警测试数据 SQL。
+
+实现结果：
+
+- 提交内包含可追溯的实施文档和验收记录。
+- 生产 SQL 和测试 SQL 已拆开说明，避免生产误执行测试数据。
+
+## 3. 做了什么
+
+### 3.1 专项分析员工范围调整
+
+做了：
+
+- 将专项分析的员工范围从“项目打标命中员工”调整为“项目流水对应员工”。
+- 通过 `ccdi_bank_statement.project_id` 和流水本方证件号 `cret_no` 关联 `ccdi_base_staff.id_card`。
+
+实现了：
+
+- 项目流水中存在的员工，即使没有命中风险模型，也能进入专项分析范围。
+- 员工家庭资产负债、采购拓展、招聘拓展、调动拓展使用同一项目员工范围。
+- 不改变结果总览风险人员统计口径，不改变打标结果表。
+
+### 3.2 外部人员识别与预警
+
+做了：
+
+- 新增外部人员识别逻辑。
+- 外部人员主体口径为：流水 `bs.cret_no` 非空，且该证件号不是员工、不是员工亲属。
+- 新增外部人员预警汇总、列表、模型卡片、模型命中人员等后端查询能力。
+
+实现了：
+
+- 结果总览可以分析员工以外的中介、信贷客户、其他外部主体。
+- 外部人员可以按“中介 / 客户 / 外部人员”等主体类型展示。
+- 仅有无风险外部主体时，不展示外部人员预警空 Tab，不在 PDF 里输出外部人员空段落。
+- 对象级外部人员命中也能进入结果总览统计。
+
+### 3.3 外部人员 7 条流水规则
+
+做了：
+
+- 新增 SQL 迁移脚本：`sql/migration/2026-06-29-add-external-person-bank-tag-rules.sql`。
+- 新增 7 条外部人员流水打标规则，并接入后端打标服务分发。
+
+实现了以下规则：
+
+1. 外部人员单笔大额交易：外部主体单笔交易金额超过大额阈值。
+2. 外部人员累计交易超限：外部主体累计交易金额超过累计阈值。
+3. 外部人员年流水交易额超限：外部主体近一年流水交易额超过年累计阈值。
+4. 外部人员夜间集中交易：外部主体在 22:00 至次日 06:00 发生交易。
+5. 外部人员疑似赌博摘要：摘要、交易类型或对手方名称命中赌博敏感词。
+6. 外部人员同日多对手方疑似赌博交易：同日多笔、多对手方、金额位于疑似赌博区间。
+7. 外部人员与员工或员工亲属交易：外部主体与员工或员工亲属发生资金往来。
+
+规则口径：
+
+- 外部人员大额类规则复用已有 `LARGE_TRANSACTION` 参数。
+- 外部人员疑似赌博对象规则复用已有 `SUSPICIOUS_GAMBLING` 参数。
+- 外部人员单笔大额、累计交易超限、年流水交易额超限为中风险；外部人员与员工/亲属交易、同日多对手方疑似赌博交易为高风险。
+- 不使用对手方证件号判断，因为流水没有可靠的对方证件号。
+- 外部人员与信贷客户/中介交易时，优先按对手方账号识别。
+- 外部人员与员工/亲属交易时，优先按对手方账号识别；账号没有命中已维护账号时，才按对手方名称匹配员工或亲属。
+- 如果对手方账号命中信贷客户，即使名称与员工相同，也按信贷客户展示。
+
+### 3.4 结果总览页面
+
+做了：
+
+- 结果总览增加外部人员统计。
+- 风险人员区域增加“外部人员预警”页签。
+- 风险模型区域同时展示员工模型和外部人员模型。
+- 修复外部模型重复渲染导致的 Vue duplicate key 问题。
+
+实现了：
+
+- 顶部统计卡保持 dev-ui 原结构，展示总人数、高风险、中风险、低风险、无风险。
+- 顶部统计卡数值按员工与外部主体合并计算：总人数等于员工总人数加外部总人数，高中低和无风险分别加上外部对应人数。
+- 当外部总人数大于 0 时，统计卡显示“员工 X / 外部 Y”拆分小字；外部总人数为 0 时不显示拆分小字。
+- 外部人员预警列表展示：姓名、证件号、主体类型、风险等级、核心异常点、涉及对象、最近交易时间。
+- 涉及对象显示业务词，如员工、员工亲属、中介库人员、信贷客户、资金。
+- 不再展示不清晰的“关联对象”文案。
+- 风险模型区可以筛选员工模型和外部模型，并查看命中人员。
+
+### 3.5 外部人员详情
+
+做了：
+
+- 新增外部人员详情弹窗。
+- 外部人员详情只保留“异常明细”和“资金流向”两个页签。
+- 右上角提供关闭按钮。
+- 移除右上角重复的“分析主体：xxx”。
+- 移除“跳转流水明细查询”的交互。
+
+实现了：
+
+- 点击外部人员“查看详情”后，在当前结果总览内打开详情弹窗。
+- 异常明细按员工详情的异常明细方式展示。
+- 流水型异常展示流水明细。
+- 对象型异常展示对象命中原因，例如年流水超限。
+- 资金流向页签使用与员工资金流向一致的资金图谱能力。
+
+### 3.6 涉疑交易明细与导出
+
+做了：
+
+- 调整风险明细工作簿中“涉疑交易明细”sheet 的字段。
+- 保留“员工负面征信信息”和“异常账户人员信息”sheet。
+
+实现了：
+
+- 风险明细导出包含 3 个 sheet：
+  - 涉疑交易明细。
+  - 员工负面征信信息。
+  - 异常账户人员信息。
+- “涉疑交易明细”字段为：
+  - 交易时间。
+  - 本方账户。
+  - 本方主体。
+  - 对方名称。
+  - 对方账户。
+  - 关联员工。
+  - 摘要。
+  - 交易类型。
+  - 异常标签。
+  - 交易金额。
+
+### 3.7 PDF 报告
+
+做了：
+
+- 调整结果总览 PDF 的风险汇总展示。
+- 增加外部人员相关汇总输出。
+- 避免无外部风险时输出空的外部人员段落。
+
+实现了：
+
+- PDF 顶部风险指标按总人数、高风险、中风险、低风险、无风险汇总，并合并外部人员对应风险等级。
+- PDF 第三章标题为“风险总览”。
+- 存在外部人员风险时，输出外部人员风险汇总、外部模型汇总、外部人员预警明细。
+- 不存在外部风险命中时，不输出外部人员预警空段落。
+
+### 3.8 页面交互细节
+
+做了：
+
+- 移除流水明细查询页头部多余副标题。
+- 移除风险人员区域 Tab 右侧的小型导出入口。
+- 保留结果总览顶部“导出报告”入口。
+- 修复项目分析弹窗和外部人员详情交互中的细节问题。
+
+实现了：
+
+- 页面更贴合实际业务操作路径。
+- 外部人员详情不会引导用户跳到流水明细查询。
+- 外部人员没有员工专属的资产、征信等模块。
+
+## 4. 包含的接口能力
+
+本次代码中涉及或完善的接口能力包括：
+
+- 外部人员预警列表：`/ccdi/project/overview/external-persons`
+- 外部人员预警汇总：`/ccdi/project/overview/external-persons/summary`
+- 外部风险模型卡片：`/ccdi/project/overview/external-risk-models/cards`
+- 外部风险模型命中人员：`/ccdi/project/overview/external-risk-models/people`
+- 外部风险模型命中人员导出：`/ccdi/project/overview/external-risk-models/people/export`
+- 风险明细导出：`/ccdi/project/overview/risk-details/export`
+- 涉疑交易明细查询和导出仍保留现有入口，并补齐导出字段。
+
+## 5. 包含的数据库脚本
+
+生产需要执行：
+
+- `sql/migration/2026-06-29-add-external-person-bank-tag-rules.sql`
+
+该脚本用于写入外部人员 7 条流水打标规则，支持重复执行更新规则口径。
+
+提交内还包含测试数据脚本：
+
+- `sql/migration/2026-06-24-add-external-person-warning-test-data.sql`
+
+该脚本只用于本地或测试环境造数验证，生产不要执行。
+
+本次提交不包含表结构变更，不需要新增业务表、系统表、菜单表或字典表。
+
+## 6. 不包含的内容
+
+本次提交不包含以下内容：
+
+- 不提交 `tongweb_62318.properties`，该文件包含本机路径。
+- 不提交 `ruoyi-admin/src/main/resources/application-dev.yml` 中未确认的 `allow-circular-references: true`。
+- 不提交随机 `.docx` 文件。
+- 不提交 `ruoyi-ui/public/*.docx`，这些文件会污染前端生产 `dist`。
+- 不提交历史 5 月文档、SQL 和原型图片。
+- 不改变员工风险人员结果总览的打标统计口径。
+- 不改变负面征信和异常账户的业务规则。
+
+## 7. 验证结论
+
+已完成以下验证：
+
+- 后端外部人员规则、SQL、服务分发、导出、PDF 相关单元测试通过。
+- 后端针对性单测共 13 个测试类、82 个用例，0 失败、0 错误。
+- `mvn -pl ccdi-project -am compile -DskipTests` 通过。
+- `mvn -pl ruoyi-admin -am package -DskipTests` 通过。
+- 前端使用 Node `22.22.3` 执行 `npm run build:prod` 通过。
+- 真实页面登录并进入项目 `90629002` 验证通过：
+  - 结果总览可打开。
+  - 外部人员预警 Tab 可展示。
+  - 外部人员详情弹窗可打开。
+  - 异常明细在详情弹窗内展示。
+  - 风险模型区域无 duplicate key 控制台错误。
+- 风险明细导出实测通过，导出的 xlsx 包含 3 个 sheet，涉疑交易明细字段符合本清单。
+
+结论：本地已提交的业务功能可以作为生产发布候选；发布时必须使用干净提交产物，不要使用当前脏工作区直接打包。

docs/reports/implementation/2026-06-30-production-readiness-acceptance-and-risk-model-key-fix.md

@@ -0,0 +1,34 @@
+# 2026-06-30 上线前验收与风险模型重复 Key 修复实施记录
+
+## 1. 修改背景
+
+上线前总体验收时，真实页面进入项目结果总览后，浏览器控制台出现 `RiskModelSection` 的 Vue duplicate key 错误，重复 key 包括 `EXTERNAL_ABNORMAL_TRANSACTION`、`EXTERNAL_LARGE_TRANSACTION`、`EXTERNAL_SUSPICIOUS_GAMBLING`、`EXTERNAL_SUSPICIOUS_RELATION`。
+
+## 2. 修改内容
+
+- `RiskModelSection.vue`：
+  - 员工模型卡片列表中过滤 `EXTERNAL_` 开头的外部模型。
+  - 外部模型仍由 `/external-risk-models/cards` 专门接口加载。
+  - 避免同一个外部模型同时出现在员工模型卡片和外部模型卡片中，消除重复 key。
+
+## 3. 影响范围
+
+- 仅影响结果总览中的风险模型卡片渲染。
+- 不调整模型统计接口、不调整外部人员识别规则、不调整导出字段。
+
+## 4. 验证情况
+
+- 后端针对性单测：13 个测试类、82 个用例全部通过。
+- 后端编译：`mvn -pl ccdi-project -am compile -DskipTests` 通过。
+- 主应用打包：`mvn -pl ruoyi-admin -am package -DskipTests` 通过。
+- 前端构建：`npm run build:prod` 通过。
+- 浏览器真实页面验收：
+  - 项目 `90629002` 进入结果总览成功。
+  - 风险总览、外部人员预警、风险模型、涉疑交易明细可见。
+  - 外部人员详情弹窗可打开，右上角关闭按钮可见，异常明细在弹窗内展示。
+  - 修复后控制台 0 error、0 warning。
+
+## 5. 遗留风险
+
+- `ruoyi-ui/public/` 下存在 3 个随机 `.docx` 文件，会被复制进 `dist`，生产打包前必须移除或排除。
+- `tongweb_62318.properties` 包含本机路径，不应进入生产提交。