86 lines
3.3 KiB
Markdown
86 lines
3.3 KiB
Markdown
# LSFX Mock Server 异常账户后端实施记录
|
||
|
||
## 1. 实施范围
|
||
|
||
本次改动仅覆盖 `lsfx-mock-server` 后端 Mock 造数主链路，目标是在不新增接口的前提下，为异常账户规则补齐稳定命中能力。
|
||
|
||
涉及规则：
|
||
|
||
- `SUDDEN_ACCOUNT_CLOSURE`
|
||
- `DORMANT_ACCOUNT_LARGE_ACTIVATION`
|
||
|
||
## 2. 主要改动
|
||
|
||
### 2.1 FileRecord 新增异常账户计划与事实
|
||
|
||
在 `lsfx-mock-server/services/file_service.py` 中扩展了 `FileRecord`：
|
||
|
||
- 新增 `abnormal_account_hit_rules`
|
||
- 新增 `abnormal_accounts`
|
||
|
||
同时把异常账户规则池并入现有规则命中计划生成逻辑：
|
||
|
||
- `subset` 模式下按 `logId` 稳定随机命中异常账户规则
|
||
- `all` 模式下自动纳入全部异常账户规则
|
||
- 在上传链路与 `fetch_inner_flow(...)` 中同步生成最小异常账户事实
|
||
|
||
最小账户事实字段包括：
|
||
|
||
- `account_no`
|
||
- `owner_id_card`
|
||
- `account_name`
|
||
- `status`
|
||
- `effective_date`
|
||
- `invalid_date`
|
||
|
||
### 2.2 新增两类异常账户样本生成器
|
||
|
||
在 `lsfx-mock-server/services/statement_rule_samples.py` 中新增：
|
||
|
||
- `build_sudden_account_closure_samples(...)`
|
||
- `build_dormant_account_large_activation_samples(...)`
|
||
|
||
口径落实如下：
|
||
|
||
- `SUDDEN_ACCOUNT_CLOSURE` 的样本流水全部落在销户日前 30 天窗口内
|
||
- `DORMANT_ACCOUNT_LARGE_ACTIVATION` 的首笔流水晚于开户满 6 个月
|
||
- 休眠激活样本同时满足累计金额阈值与单笔最大金额阈值
|
||
|
||
### 2.3 接入现有种子流水主链路
|
||
|
||
未新增平行入口，直接复用现有：
|
||
|
||
- `FileService -> FileRecord`
|
||
- `StatementService._generate_statements(...)`
|
||
- `build_seed_statements_for_rule_plan(...)`
|
||
|
||
接入方式：
|
||
|
||
- 在统一种子流水构造入口增加 `abnormal_account_hit_rules` 分支
|
||
- 根据 `abnormal_accounts` 为每条异常账户规则选择匹配账户事实
|
||
- 生成的异常账户样本继续与既有规则样本一起补噪声、编号、打乱和分页
|
||
|
||
## 3. 测试补充
|
||
|
||
新增并通过的关键测试包括：
|
||
|
||
- `test_fetch_inner_flow_should_attach_abnormal_account_rule_plan`
|
||
- `test_sudden_account_closure_samples_should_stay_within_30_days_before_invalid_date`
|
||
- `test_dormant_account_large_activation_samples_should_exceed_threshold_after_6_months`
|
||
- `test_generate_statements_should_follow_abnormal_account_rule_plan_from_file_record`
|
||
|
||
## 4. 联动修正
|
||
|
||
在 `all` 模式安全噪声测试中，原有用例只清空了旧规则维度，未同步清空新增的 `abnormal_account_hit_rules`。本次已将该测试夹具补齐，保证它继续只验证“月固定收入 + 安全噪声”的原始语义。
|
||
|
||
在合并到 `dev` 后的运行态验证中，又发现 `getBSByLogId` 返回前统一回填主绑定时，会把异常账户样本原本正确的 `accountMaskNo` 覆盖成主账号，导致 HTTP 实际返回数据无法体现异常账户事实。对此补充了以下修正：
|
||
|
||
- 新增回归用例 `test_get_bank_statement_should_preserve_abnormal_account_mask_no`
|
||
- 将 `StatementService._apply_primary_binding(...)` 调整为只兜底缺失账号，不覆盖已有的异常账户样本账号
|
||
|
||
修正后，接口返回中的异常账户流水可以保留各自独立的账号，与异常账户事实保持一致。
|
||
|
||
## 5. 结果
|
||
|
||
异常账户命中计划、最小账户事实、样本生成器和服务层主链路均已落地，现有 Mock 服务可以为同一个 `logId` 稳定提供异常账户命中流水样本。
|