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

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 的断言

验证记录

执行命令：

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 警告，但不影响本次条数调整