diff --git 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 new file mode 100644 index 00000000..5439ffcc --- /dev/null +++ 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 个测试全部通过。 diff --git 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 new file mode 100644 index 00000000..9dbd108f --- /dev/null +++ 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 单元测试,未启动额外前后端进程,因此无需执行进程清理。 diff --git a/sql/2026-03-16-bank-tagging.sql b/sql/2026-03-16-bank-tagging.sql index b79bfb8e..c0633949 100644 --- 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');