65 lines
3.8 KiB
Markdown
65 lines
3.8 KiB
Markdown
# 外部人员预警实施记录
|
||
|
||
## 保存路径确认
|
||
|
||
- 后端实施计划：`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 可分页加载。
|
||
- 外部人员预警导出可下载。
|
||
- 外部人员模型卡片后置展示。
|
||
- 风险模型导出可按当前筛选下载。
|
||
- 风险明细可筛选“外部人员预警”。
|