Files
ccdi/docs/plans/backend/2026-06-24-external-person-warning-backend-implementation.md

47 lines
2.1 KiB
Markdown
Raw Normal View History

# 外部人员预警后端实施计划
## 目标
在不改变结果总览员工主口径的前提下,新增外部人员预警查询与导出能力,使中介、客户、其他外部人员作为本方流水导入后,也能在结果总览中形成预警结果。
## 实施范围
1. 新增外部人员预警分页接口。
2. 新增外部人员预警导出接口。
3. 新增外部人员模型统计接口。
4. 新增外部人员模型命中人员分页接口。
5. 扩展涉疑交易明细筛选,支持外部人员相关流水。
6. 补充外部人员预警测试数据 SQL。
## 业务口径
1. 本方 `cret_no` 命中员工身份证号时,归入员工。
2. 本方 `cret_no` 命中员工亲属证件号时,归入员工亲属。
3. 本方 `cret_no` 未命中员工和员工亲属时,归入外部人员。
4. 外部人员 `cret_no` 命中中介库本人证件号时,主体类型为中介。
5. 外部人员 `cret_no` 命中信贷客户证件号时,主体类型为客户。
6. 其他外部人员统一显示为外部人员。
7. 外部人员只跑交易和关系类模型,不套用员工资产、负面征信、岗位部门类模型。
## 模型范围
1. `EXTERNAL_LARGE_TRANSACTION`:外部人员大额交易。
2. `EXTERNAL_ABNORMAL_TRANSACTION`:外部人员异常交易。
3. `EXTERNAL_SUSPICIOUS_GAMBLING`:外部人员可疑赌博。
4. `EXTERNAL_SUSPICIOUS_RELATION`:外部人员可疑关系。
## 数据实现
本轮采用直接聚合现有流水和标签结果的最短路径,不新增结果快照表:
1. 外部人员主体来自 `ccdi_bank_statement.cret_no`
2. 命中模型来自 `ccdi_bank_statement_tag_result` 中外部人员模型编码。
3. 与员工或员工亲属的关系来自交易对手证件号、交易对手姓名、账户库命中结果。
4. 中介识别优先使用中介库 `person_id`,不使用姓名作为主体识别依据。
## 验证
1. 执行新增测试数据 SQL。
2. 运行 `mvn test -pl ccdi-project` 相关测试或至少编译 `ccdi-project`
3. 启动后端后验证新增接口返回外部人员预警列表、模型统计和导出接口。