ccdi/docs/reports/implementation/2026-03-25-lsfx-mock-all-hit-sql-alignment-record.md

lsfx-mock all 模式 SQL 对齐强命中实施记录

1. 背景

本次实施基于设计文档 2026-03-25-lsfx-mock-all-hit-sql-alignment-design.md，目标是在不修改主工程打标逻辑的前提下，仅通过调整 lsfx-mock-server 的 --rule-hit-mode all 生成策略，使以下 5 条已落地真实 SQL 的规则稳定命中：

• SPECIAL_AMOUNT_TRANSACTION
• MONTHLY_FIXED_INCOME
• SUSPICIOUS_INCOME_KEYWORD
• FIXED_COUNTERPARTY_TRANSFER
• LOW_INCOME_RELATIVE_LARGE_TRANSACTION

2. 实际修改

2.1 规则样本对齐

修改文件：

• statement_rule_samples.py

调整内容：

• SPECIAL_AMOUNT_TRANSACTION
  • 将样本金额从 88888.88 调整为 1314.0
• MONTHLY_FIXED_INCOME
  • 将稳定收入月份从 4 个月扩展到 6 个月
• SUSPICIOUS_INCOME_KEYWORD
  • 将摘要改为 劳务费发放
  • 将交易类型改为 劳务费入账
• FIXED_COUNTERPARTY_TRANSFER
  • 将样本主体从家属证件号切换为员工本人证件号

2.2 低收入亲属基线补齐

修改文件：

• phase2_baseline_service.py
• file_service.py

调整内容：

• 为 LOW_INCOME_RELATIVE_LARGE_TRANSACTION 新增关系表基线 SQL 生成逻辑
• 基线通过 INSERT ... ON DUPLICATE KEY UPDATE 将目标家属 annual_income 收敛到 0.00
• 在 all 模式下，FileService 会将该规则追加到 baseline 服务执行列表
• subset 模式保持原有行为不变

2.3 all 模式噪声收敛

修改文件：

• statement_service.py

调整内容：

• 在 all 模式且存在真实 FileRecord 时，将补齐总数的噪声流水改为“低额支出型安全噪声”
• 安全噪声特征：
  • 仅生成支出流水
  • 金额范围缩窄到 10 ~ 200
  • 使用唯一化商户名和通用消费摘要
• 目的：
  • 避免额外收入干扰 MONTHLY_FIXED_INCOME
  • 避免随机稳定对手干扰 FIXED_COUNTERPARTY_TRANSFER

3. 测试补充

修改文件：

• test_file_service.py
• test_statement_service.py
• test_phase2_baseline_service.py
• test_full_workflow.py

新增验证点：

• all 模式保留目标规则，不引入占位 SQL 规则
• 特殊金额样本仅使用 520/1314
• 月度固定收入覆盖至少 6 个月
• 收入关键词样本直接命中 SQL 关键词集
• 固定对手转入主体为员工本人
• 低收入亲属规则会生成并执行关系表基线 SQL
• all 模式下噪声收敛为安全支出噪声
• 接口链路能返回 5 条目标规则对应的关键样本

4. 验证命令

执行命令：

cd lsfx-mock-server
python3 -m pytest tests/test_file_service.py tests/test_statement_service.py tests/test_phase2_baseline_service.py tests/integration/test_full_workflow.py -v

验证结果：

• 49 passed
• 0 failed

5. 前端影响

本次未修改 ruoyi-ui。

结论：

• 接口结构未变化
• 本轮实现仅影响 Mock 样本和关联表基线
• 前端无需适配代码

6. 未完成项

本次完成了 Mock 侧单元测试和接口级集成测试，但未在本记录中执行真实后端联调与数据库结果核验：

• 未实际启动本地后端并拉取流水
• 未实际查询 ccdi_bank_statement_tag_result

如果后续需要闭环到项目库结果，应再补一次真实联调记录。