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

外部人员预警实施记录

保存路径确认

• 后端实施计划：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 可分页加载。
   • 外部人员预警导出可下载。
   • 外部人员模型卡片后置展示。
   • 风险模型导出可按当前筛选下载。
   • 风险明细可筛选“外部人员预警”。