补充第一期流水模型后端实施记录

2026-03-20 13:31:53 +08:00
parent 1bd24497b3
commit c95ed24d04
3 changed files with 114 additions and 9 deletions
--- a/docs/reports/implementation/2026-03-20-bank-tag-real-rule-phase1-backend-record.md
+++ b/docs/reports/implementation/2026-03-20-bank-tag-real-rule-phase1-backend-record.md
@@ -0,0 +1,76 @@
+# 银行流水真实规则第一期后端实施记录
+
+## 第一期规则范围
+- `GAMBLING_SENSITIVE_KEYWORD`
+- `SPECIAL_AMOUNT_TRANSACTION`
+- `SUSPICIOUS_INCOME_KEYWORD`
+- `FOREX_BUY_AMT`
+- `FOREX_SELL_AMT`
+- `LARGE_PURCHASE_TRANSACTION`
+- `STOCK_TFR_LARGE`
+- `WITHDRAW_CNT`
+- `LARGE_STOCK_TRADING`
+
+## 修改内容
+- 补齐第一期规则参数映射
+- 替换第一期 8 条明细型占位 SQL
+- 接通 `WITHDRAW_CNT` 对象型真实 SQL 与阈值分发
+- 对齐第一期规则元数据脚本与实施/验证文档
+
+## 参数映射调整
+- 在 `BankTagRuleConfigResolver` 中补齐第一期阈值规则映射：
+  - `FOREX_BUY_AMT -> SINGLE_PURCHASE_AMOUNT`
+  - `FOREX_SELL_AMT -> SINGLE_SETTLEMENT_AMOUNT`
+  - `WITHDRAW_CNT -> WITHDRAW_CNT`
+  - `STOCK_TFR_LARGE -> STOCK_TFR_LARGE`
+  - `LARGE_STOCK_TRADING -> STOCK_TFR_LARGE`
+- 明确无阈值规则仍返回空参数集，不为第一期无参规则补虚假参数。
+
+## XML 真实 SQL 替换
+- 在 `CcdiBankTagAnalysisMapper.xml` 中将以下占位 SQL 替换为真实规则：
+  - 赌博敏感词支出流水
+  - 非配偶/子女特殊金额交易流水
+  - 收入关键词转入流水
+  - 单笔购汇超阈值流水
+  - 单笔结汇超阈值流水
+  - 单笔大额采购事项
+  - 银证转账超阈值流水
+  - 三方资管超阈值流水
+  - 微信/支付宝单日频繁提现对象
+- 明细型规则统一继续输出 `bankStatementId/groupId/logId/reasonDetail`。
+- `LARGE_PURCHASE_TRANSACTION` 由于来源为采购交易表，不直接来自银行流水表，保留明细结果字段别名并在 `reasonDetail` 中输出采购事项、金额和供应商信息。
+
+## Service 分发调整
+- `CcdiBankTagServiceImpl` 为以下规则改为显式透传解析后的阈值：
+  - `FOREX_BUY_AMT`
+  - `FOREX_SELL_AMT`
+  - `STOCK_TFR_LARGE`
+  - `LARGE_STOCK_TRADING`
+  - `WITHDRAW_CNT`
+- `WITHDRAW_CNT` 命中为空时仍保持任务成功，不回退任务状态与风险人数刷新链路。
+
+## 元数据脚本调整
+- 在 `sql/2026-03-16-bank-tagging.sql` 中对齐第一期规则元数据：
+  - `FOREX_BUY_AMT.indicator_code` 改为 `SINGLE_PURCHASE_AMOUNT`
+  - `FOREX_SELL_AMT.indicator_code` 改为 `SINGLE_SETTLEMENT_AMOUNT`
+  - `LARGE_STOCK_TRADING.indicator_code` 改为 `STOCK_TFR_LARGE`
+- 将第一期已落地规则的 `remark` 从“占位规则，待补充真实SQL”更新为真实规则描述。
+
+## 与第二期边界
+- 第二期规则仍保持原有占位 SQL，不在本次修改范围内：
+  - `LOW_INCOME_RELATIVE_LARGE_TRANSACTION`
+  - `MULTI_PARTY_GAMBLING_TRANSFER`
+  - `MONTHLY_FIXED_INCOME`
+  - `FIXED_COUNTERPARTY_TRANSFER`
+  - `HOUSE_REGISTRATION_MISMATCH`
+  - `PROPERTY_FEE_REGISTRATION_MISMATCH`
+  - `TAX_ASSET_REGISTRATION_MISMATCH`
+  - `SUPPLIER_CONCENTRATION`
+  - `SALARY_QUICK_TRANSFER`
+  - `SALARY_UNUSED`
+
+## 验证执行
+- 执行 `mvn test -pl ccdi-project -Dtest=BankTagRuleConfigResolverTest`，补齐参数映射后通过。
+- 执行 `mvn test -pl ccdi-project -Dtest=CcdiBankTagAnalysisMapperXmlTest`，第一期 8 条明细规则结构测试通过。
+- 执行 `mvn test -pl ccdi-project -Dtest=CcdiBankTagAnalysisMapperXmlTest,CcdiBankTagServiceImplTest`，对象规则与分发测试通过。
+- 执行 `mvn test -pl ccdi-project -Dtest=CcdiBankTagAnalysisMapperXmlTest,BankTagRuleConfigResolverTest,CcdiBankTagServiceImplTest,CcdiBankTagServiceRiskCountRefreshTest`，第一期回归共 27 个测试全部通过。
--- a/docs/tests/records/2026-03-20-bank-tag-real-rule-phase1-backend-verification.md
+++ b/docs/tests/records/2026-03-20-bank-tag-real-rule-phase1-backend-verification.md
@@ -0,0 +1,29 @@
+# 银行流水真实规则第一期后端验证记录
+
+## 执行命令
+
+```bash
+mvn test -pl ccdi-project -Dtest=BankTagRuleConfigResolverTest
+mvn test -pl ccdi-project -Dtest=CcdiBankTagAnalysisMapperXmlTest
+mvn test -pl ccdi-project -Dtest=CcdiBankTagAnalysisMapperXmlTest,CcdiBankTagServiceImplTest
+mvn test -pl ccdi-project -Dtest=CcdiBankTagAnalysisMapperXmlTest,BankTagRuleConfigResolverTest,CcdiBankTagServiceImplTest,CcdiBankTagServiceRiskCountRefreshTest
+```
+
+## 执行时间
+- 2026-03-20 12:38 执行 `BankTagRuleConfigResolverTest` 红灯验证，确认第一期规则参数映射未补齐。
+- 2026-03-20 13:21 重新执行 `BankTagRuleConfigResolverTest`，6 个测试全部通过。
+- 2026-03-20 13:23 执行 `CcdiBankTagAnalysisMapperXmlTest` 红灯验证，确认第一期 8 条明细规则仍存在占位 SQL。
+- 2026-03-20 13:26 重新执行 `CcdiBankTagAnalysisMapperXmlTest`，7 个测试全部通过。
+- 2026-03-20 13:27 执行 `CcdiBankTagAnalysisMapperXmlTest,CcdiBankTagServiceImplTest` 红灯验证，确认 `WITHDRAW_CNT` 仍是占位 SQL，且阈值未接入分发链路。
+- 2026-03-20 13:28 重新执行 `CcdiBankTagAnalysisMapperXmlTest,CcdiBankTagServiceImplTest`，19 个测试全部通过。
+- 2026-03-20 13:30 执行最终回归命令 `mvn test -pl ccdi-project -Dtest=CcdiBankTagAnalysisMapperXmlTest,BankTagRuleConfigResolverTest,CcdiBankTagServiceImplTest,CcdiBankTagServiceRiskCountRefreshTest`，27 个测试全部通过，0 failure，0 error。
+- 2026-03-20 13:31 在补齐规则元数据脚本与文档后再次执行最终回归命令，27 个测试全部通过，0 failure，0 error。
+
+## 结果摘要
+- 第一期开启真实 SQL 的 9 条规则中，8 条明细型规则已完成 XML 替换，1 条对象型规则已完成阈值分发与对象命中 SQL。
+- 第一期开启真实 SQL 后，`CcdiBankTagServiceRiskCountRefreshTest` 继续通过，风险人数回写链路未回退。
+- 第一期规则元数据脚本已对齐真实状态，`indicator_code` 与参数编码保持全大写。
+
+## 结论
+- 第一阶段后端实现已完成，第一期 9 条规则均已接入现有项目级打标链路。
+- 当前验证仅执行 Maven 单元测试，未启动额外前后端进程，因此无需执行进程清理。
--- a/sql/2026-03-16-bank-tagging.sql
+++ b/sql/2026-03-16-bank-tagging.sql
@@ -82,25 +82,25 @@ VALUES
 ('ABNORMAL_TRANSACTION', '异常交易', 'ABNORMAL_CUSTOMER_TRANSACTION', '与客户之间非正常资金往来', NULL, 'STATEMENT', 'HIGH', '员工及关系人与客户及关系人之间有超过1000元以上的资金往来；客户指信贷类客户包括贷款户、担保人，中介库人员，包括中介注册的主体及主体关系人。', 1, 10, 'system', '占位规则，待补充真实SQL'),
 ('ABNORMAL_TRANSACTION', '异常交易', 'LOW_INCOME_RELATIVE_LARGE_TRANSACTION', '低收入亲属大额交易', NULL, 'OBJECT', 'GENERAL', '关系人中没有收入或月收入低于3000元的人员，累计交易金额超过10万元。', 1, 20, 'system', '占位规则，待补充真实SQL'),
 ('SUSPICIOUS_GAMBLING', '疑似赌博', 'MULTI_PARTY_GAMBLING_TRANSFER', '疑似赌博交易', NULL, 'OBJECT', 'HIGH', '多人（2人及以上）、多次（2次以上）、相近时间（同一天）内，有转账、微信转账、支付宝转账发生，且额度在可疑区间。金额区间可在排查设置页面进行设置', 1, 10, 'system', '占位规则，待补充真实SQL'),
-('SUSPICIOUS_GAMBLING', '疑似赌博', 'GAMBLING_SENSITIVE_KEYWORD', '疑似敏感交易', NULL, 'STATEMENT', 'HIGH', '备注或交易摘要、对手有“游戏、抖币、体彩、福彩”等字眼。', 1, 20, 'system', '占位规则，待补充真实SQL'),
-('SUSPICIOUS_RELATION', '可疑关系', 'SPECIAL_AMOUNT_TRANSACTION', '特殊金额交易', NULL, 'STATEMENT', NULL, '除与配偶、子女外，发生特殊金额交易，如1314元、520元等具有特殊含义的金额。', 1, 10, 'system', '占位规则，待补充真实SQL'),
+('SUSPICIOUS_GAMBLING', '疑似赌博', 'GAMBLING_SENSITIVE_KEYWORD', '疑似敏感交易', NULL, 'STATEMENT', 'HIGH', '备注或交易摘要、对手有“游戏、抖币、体彩、福彩”等字眼。', 1, 20, 'system', '真实规则：识别摘要或对手方命中赌博敏感词的支出流水'),
+('SUSPICIOUS_RELATION', '可疑关系', 'SPECIAL_AMOUNT_TRANSACTION', '特殊金额交易', NULL, 'STATEMENT', NULL, '除与配偶、子女外，发生特殊金额交易，如1314元、520元等具有特殊含义的金额。', 1, 10, 'system', '真实规则：识别与非配偶子女发生的特殊金额交易'),
 ('SUSPICIOUS_PART_TIME', '可疑兼职', 'MONTHLY_FIXED_INCOME', '疑似兼职', 'MONTHLY_FIXED_INCOME', 'OBJECT', NULL, '除本行工资收入外，每月有固定收入，固定收入金额自行设置。', 1, 10, 'system', '占位规则，待补充真实SQL'),
 ('SUSPICIOUS_PART_TIME', '可疑兼职', 'FIXED_COUNTERPARTY_TRANSFER', '疑似兼职', 'FIXED_COUNTERPARTY_TRANSFER', 'OBJECT', NULL, '每季或每年从固定交易对手转入金额，金额可设区间值，如5000-10000。', 1, 20, 'system', '占位规则，待补充真实SQL'),
-('SUSPICIOUS_PART_TIME', '可疑兼职', 'SUSPICIOUS_INCOME_KEYWORD', '疑似兼职', NULL, 'STATEMENT', 'HIGH', '转入资金摘要有“工资”、“分红”、“红利”、“利息（非银行结息）”等收入', 1, 30, 'system', '占位规则，待补充真实SQL'),
+('SUSPICIOUS_PART_TIME', '可疑兼职', 'SUSPICIOUS_INCOME_KEYWORD', '疑似兼职', NULL, 'STATEMENT', 'HIGH', '转入资金摘要有“工资”、“分红”、“红利”、“利息（非银行结息）”等收入', 1, 30, 'system', '真实规则：识别非本行工资代发的收入关键词转入流水'),
 ('SUSPICIOUS_PROPERTY', '可疑财产', 'HOUSE_REGISTRATION_MISMATCH', '购房交易与房产登记不匹配', NULL, 'STATEMENT', NULL, '员工及关系人有购房交易，但名下房产无新增登记；有新增登记购房，但无相关购房交易记录。', 1, 10, 'system', '占位规则，待补充真实SQL'),
 ('SUSPICIOUS_PROPERTY', '可疑财产', 'PROPERTY_FEE_REGISTRATION_MISMATCH', '物业缴费与房产登记不匹配', NULL, 'STATEMENT', NULL, '员工及关系人有物业缴费记录，但名下房产无新增登记。', 1, 20, 'system', '占位规则，待补充真实SQL'),
 ('SUSPICIOUS_PROPERTY', '可疑财产', 'TAX_ASSET_REGISTRATION_MISMATCH', '大额纳税与资产登记不匹配', NULL, 'STATEMENT', NULL, '员工及关系人有5000元以上的纳税记录，但名下无房产车产新增登记。', 1, 30, 'system', '占位规则，待补充真实SQL'),
 ('SUSPICIOUS_PROPERTY', '可疑财产', 'INCOME_ASSET_MISMATCH', '收入资产不符', NULL, 'STATEMENT', 'HIGH', '豪华房产价值超家庭年收入10倍', 1, 40, 'system', '占位规则，待补充真实SQL'),
-('SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易', 'FOREX_BUY_AMT', '可疑外汇交易', 'FOREX_BUY_AMT', 'STATEMENT', NULL, '单笔购汇金额超限', 1, 10, 'system', '占位规则，待补充真实SQL'),
-('SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易', 'FOREX_SELL_AMT', '可疑外汇交易', 'FOREX_SELL_AMT', 'STATEMENT', NULL, '单笔结汇金额超限', 1, 20, 'system', '占位规则，待补充真实SQL'),
+('SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易', 'FOREX_BUY_AMT', '可疑外汇交易', 'SINGLE_PURCHASE_AMOUNT', 'STATEMENT', NULL, '单笔购汇金额超限', 1, 10, 'system', '真实规则：识别单笔购汇金额超过阈值的流水'),
+('SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易', 'FOREX_SELL_AMT', '可疑外汇交易', 'SINGLE_SETTLEMENT_AMOUNT', 'STATEMENT', NULL, '单笔结汇金额超限', 1, 20, 'system', '真实规则：识别单笔结汇金额超过阈值的流水'),
 ('SUSPICIOUS_FOREIGN_EXCHANGE', '可疑外汇交易', 'CROSS_BORDER_AMT', '可疑外汇交易', 'CROSS_BORDER_AMT', 'STATEMENT', NULL, '单笔跨境汇款金额超限', 1, 30, 'system', '占位规则，待补充真实SQL'),
 ('SUSPICIOUS_INTEREST_PAYMENT', '可疑付息', 'INTEREST_PAYMENT_BY_OTHERS', '可疑付息', NULL, 'OBJECT', 'HIGH', '客户经理管户的客户在智柜、柜面连续代交利息，且代交人数超过2人。', 1, 10, 'system', '占位规则，待补充真实SQL'),
-('SUSPICIOUS_PURCHASE', '可疑采购', 'LARGE_PURCHASE_TRANSACTION', '可疑采购', NULL, 'STATEMENT', NULL, '单笔采购金额超过10万元。', 1, 10, 'system', '占位规则，待补充真实SQL'),
+('SUSPICIOUS_PURCHASE', '可疑采购', 'LARGE_PURCHASE_TRANSACTION', '可疑采购', NULL, 'STATEMENT', NULL, '单笔采购金额超过10万元。', 1, 10, 'system', '真实规则：识别单笔采购金额超过10万元的采购事项'),
 ('SUSPICIOUS_PURCHASE', '可疑采购', 'SUPPLIER_CONCENTRATION', '可疑采购', NULL, 'OBJECT', NULL, '单个供应商采购额占总采购额比例超过70%。', 1, 20, 'system', '占位规则，待补充真实SQL'),
-('ABNORMAL_BEHAVIOR', '异常行为', 'STOCK_TFR_LARGE', '可疑银证大额转账', 'STOCK_TFR_LARGE', 'STATEMENT', NULL, '家庭老人/非关系人银证大额转账', 1, 10, 'system', '占位规则，待补充真实SQL'),
-('ABNORMAL_BEHAVIOR', '异常行为', 'WITHDRAW_CNT', '微信支付宝频繁提现', 'WITHDRAW_CNT', 'OBJECT', NULL, '微信、支付宝单日提现次数超过设置次数', 1, 20, 'system', '占位规则，待补充真实SQL'),
+('ABNORMAL_BEHAVIOR', '异常行为', 'STOCK_TFR_LARGE', '可疑银证大额转账', 'STOCK_TFR_LARGE', 'STATEMENT', NULL, '家庭老人/非关系人银证大额转账', 1, 10, 'system', '真实规则：识别银证转账金额超过阈值的流水'),
+('ABNORMAL_BEHAVIOR', '异常行为', 'WITHDRAW_CNT', '微信支付宝频繁提现', 'WITHDRAW_CNT', 'OBJECT', NULL, '微信、支付宝单日提现次数超过设置次数', 1, 20, 'system', '真实规则：识别微信支付宝单日提现次数超过阈值的对象'),
 ('ABNORMAL_BEHAVIOR', '异常行为', 'WITHDRAW_AMT', '微信支付宝提现超额', 'WITHDRAW_AMT', 'OBJECT', NULL, '微信、支付宝单日累计提现金额超过限额', 1, 30, 'system', '占位规则，待补充真实SQL'),
 ('ABNORMAL_BEHAVIOR', '异常行为', 'SALARY_QUICK_TRANSFER', '工资快速转出', NULL, 'OBJECT', NULL, '工资发放后24小时内转出超过80%的资金', 1, 40, 'system', '占位规则，待补充真实SQL'),
 ('ABNORMAL_BEHAVIOR', '异常行为', 'SALARY_UNUSED', '工资无使用记录', NULL, 'OBJECT', NULL, '工资发放后除代扣项目外，连续30天犖奕魏蜗鸦蜃思锹肌', 1, 50, 'system', '占位规则，待补充真实SQL'),
-('ABNORMAL_BEHAVIOR', '异常行为', 'LARGE_STOCK_TRADING', '大额炒股', NULL, 'STATEMENT', 'HIGH', '单次三方资管交易金额超过100万元。', 1, 60, 'system', '占位规则，待补充真实SQL'),
+('ABNORMAL_BEHAVIOR', '异常行为', 'LARGE_STOCK_TRADING', '大额炒股', 'STOCK_TFR_LARGE', 'STATEMENT', 'HIGH', '单次三方资管交易金额超过100万元。', 1, 60, 'system', '真实规则：识别单笔三方资管交易金额超过阈值的流水'),
 ('ABNORMAL_BEHAVIOR', '异常行为', 'PROXY_ACCOUNT_OPERATION', '疑似代理他人账户', NULL, 'OBJECT', NULL, NULL, 1, 70, 'system', '占位规则，待补充真实SQL');