# 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` 稳定提供异常账户命中流水样本。