调整兰溪本地流水条数为200

docs/plans/backend/2026-03-19-lsfx-inner-flow-count-backend-implementation.md

@@ -0,0 +1,58 @@
+# lsfx-mock-server 兰溪本地流水条数调整实施文档
+
+## 变更目标
+
+将 `lsfx-mock-server` 中兰溪本地流水相关链路的条数统一调整为固定 `200` 条，保证以下两个口径一致：
+
+- `/watson/api/project/getJZFileOrZjrcuFile` 创建的 `FileRecord.total_records`
+- `/watson/api/project/getBSByLogId` 返回的 `data.totalCount`
+
+## 实施内容
+
+### 1. 调整流水列表总条数
+
+修改文件：
+
+- `lsfx-mock-server/services/statement_service.py`
+
+实施内容：
+
+- 新增 `StatementService.FIXED_TOTAL_COUNT = 200`
+- 将 `get_bank_statement` 首次缓存生成总条数的逻辑由随机 `1200-1500` 调整为固定 `200`
+
+### 2. 调整兰溪本地流水落库条数
+
+修改文件：
+
+- `lsfx-mock-server/services/file_service.py`
+
+实施内容：
+
+- 新增 `FileService.INNER_FLOW_TOTAL_RECORDS = 200`
+- 将 `fetch_inner_flow` 创建 `FileRecord` 时的 `total_records` 由随机 `100-300` 调整为固定 `200`
+
+### 3. 补充测试
+
+修改文件：
+
+- `lsfx-mock-server/tests/test_statement_service.py`
+- `lsfx-mock-server/tests/test_file_service.py`
+
+实施内容：
+
+- 增加 `get_bank_statement` 总条数固定为 `200` 的断言
+- 增加 `fetch_inner_flow` 创建的 `FileRecord.total_records` 固定为 `200` 的断言
+
+## 验证记录
+
+执行命令：
+
+```bash
+python3 -m pytest lsfx-mock-server/tests/test_statement_service.py -k fixed_total_count_200 -q
+python3 -m pytest lsfx-mock-server/tests/test_file_service.py -k fetch_inner_flow_persists_primary_binding_record -q
+```
+
+验证结果：
+
+- 两条目标测试均通过
+- 当前环境存在 `PydanticDeprecatedSince20` 警告，但不影响本次条数调整