设计涉疑交易筛选一致性优化

docs/plans/backend/2026-07-16-suspicious-transaction-filter-consistency-backend-implementation.md

@@ -0,0 +1,28 @@
+# 涉疑交易明细筛选一致性后端实施计划
+
+## 目标
+
+- 完成员工模型与外部人员模型隔离。
+- 列表接口批量返回当前筛选范围内的标签和展示字段。
+- 详情与风险明细导出的涉疑交易标签复用相同筛选口径。
+- 保持分页查询性能，不引入逐行 SQL。
+
+## 实施步骤
+
+1. 在涉疑交易查询标准化逻辑中识别员工模型与 `EXTERNAL_*` 外部模型，并按 `suspiciousType` 限制模型范围。
+2. 修改 `suspiciousTransactionModelHitSql`，使 `MODEL_RULE` 只读取员工模型、`EXTERNAL_PERSON` 只读取外部模型。
+3. 优化外部人员分支开关：仅 `ALL + 全部/外部模型` 或 `EXTERNAL_PERSON` 查询检查外部人员主体。
+4. 扩展涉疑交易行 VO 和分页 SQL，直接返回账户等列表展示字段。
+5. 扩展流水标签批量查询，支持 `modelCode` 和 `suspiciousType` 范围，并返回 `modelCode`。
+6. 涉疑交易分页完成后，对当前页流水 ID 执行一次标签批量查询并装配。
+7. 流水详情接口增加可选 `modelCode`、`suspiciousType` 参数，按相同标签范围查询。
+8. 风险明细导出接收涉疑交易筛选参数，涉疑交易工作表按当前筛选生成；其他工作表保持原逻辑。
+9. 修改涉疑交易导出标签聚合，使其按当前模型范围过滤。
+
+## 测试
+
+- Service：员工/外部模型范围、外部分支开关、当前页批量标签装配。
+- Mapper SQL：模型范围条件、账户字段、标签批量查询和导出标签条件。
+- Controller：详情与风险明细导出参数透传。
+- 性能结构：分页 Service 每次最多调用一次标签批量查询，不按行调用。
+