ShiErFeng/.superpowers/sdd/2026-09-22-test-data-batch-cleanup/task-5-report.md

Task 5 交接报告

Status

INCOMPLETE。当前尝试未完成 Task 5，未提交 commit。

已修改文件

本次 Task 5 尝试涉及 brief 白名单中的 18 个文件：

• shierfeng-fastapi-backend/module_business/controller/inbound_controller.py
• shierfeng-fastapi-backend/module_business/controller/filling_controller.py
• shierfeng-fastapi-backend/module_business/controller/shipment_controller.py
• shierfeng-fastapi-backend/module_business/controller/usage_controller.py
• shierfeng-fastapi-backend/module_business/controller/return_controller.py
• shierfeng-fastapi-backend/module_business/dao/operation_dao.py
• shierfeng-fastapi-backend/module_business/dao/inventory_dao.py
• shierfeng-fastapi-backend/module_business/service/inbound_service.py
• shierfeng-fastapi-backend/module_business/service/filling_service.py
• shierfeng-fastapi-backend/module_business/service/shipment_service.py
• shierfeng-fastapi-backend/module_business/service/usage_service.py
• shierfeng-fastapi-backend/module_business/service/return_service.py
• shierfeng-fastapi-backend/tests/module_business/test_inbound_service.py
• shierfeng-fastapi-backend/tests/module_business/test_filling_service.py
• shierfeng-fastapi-backend/tests/module_business/test_shipment_service.py
• shierfeng-fastapi-backend/tests/module_business/test_usage_service.py
• shierfeng-fastapi-backend/tests/module_business/test_return_service.py
• shierfeng-fastapi-backend/tests/module_business/test_inventory_dao.py

RED 证据

初始聚焦命令运行五类业务 service 与 inventory DAO 测试，共 282 个测试，结果为 38 failures。该 RED 结果用于确认显式 scope 契约、批次锁首语句、派生记录继承和 DAO scope 隔离的缺口。

阶段性结果

随后按单文件继续迁移测试调用和断言，当前结果为：

• test_inbound_service：55 tests，24 failures / 9 errors
• test_return_service：46 tests，16 failures / 9 errors
• test_inventory_dao：42 tests，16 failures / 17 errors

失败根因主要是既有测试中的旧 service/DAO 调用、旧参数顺序和旧 assert_awaited_* 断言尚未完成显式 scope 迁移；同时仍存在真实的跨 scope 校验、测试写入批次锁顺序、既有库存 ownership 保持和相关回滚行为需要继续实现与验证。生产接口当前保持 scope 必填，没有增加默认 formal scope。

未完成项

• 尚未使六个目标测试文件逐组 GREEN。
• 尚未完成五条业务链路的完整跨 scope、批次锁首语句、派生 test_batch_id 和既有库存 ownership 验证。
• 尚未运行 brief 要求的完整 282+ 回归测试。
• 尚未运行最终 Ruff format/check 和 diff check。
• 尚未执行精确白名单 git commit --only，当前没有可提交 SHA。

交接结论

这是 INCOMPLETE 交接，不代表 Task 5 完成。后续应从测试调用/断言迁移继续，修复每个单文件的真实 scope 与锁顺序失败，完成全套验证后再生成正式提交和最终报告。

Task 5 最终结果（2026-09-23）

Status

DONE。18 个白名单文件的 Task 5 实现、测试 scope 迁移和格式修复已完成；未提交 commit。生产代码保留显式 scope 必填，没有添加 formal 默认值；测试/生产数据中 test_batch_id=NULL 仍表示正式数据。

本轮完成

• 完成 test_return_service.py 的旧 DAO 调用、内部 helper 调用和 mock 断言迁移，补齐显式 TestBatchScope。
• 完成 test_inventory_dao.py 的 DAO 签名期望、列表参数顺序、幂等查询、详情/锁查询和写入调用迁移。
• 对 5 个控制器和 6 个业务测试文件执行白名单范围内的 Ruff 导入/格式修复；未修改白名单之外的源码、测试、日志或 pycache。
• 复核生产实现：DAO 根查询及明细查询应用 batch_scope_condition；测试写入口首条数据库语句锁定 active batch；派生订单、明细和事件显式继承 test_batch_id；已有库存未被改写 ownership；入库/发货旧 DELETE 在访问 DAO 前固定抛出批次清理提示；授权、状态机、幂等、锁顺序和回滚回归通过。

验证命令与真实结果

1. PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_inbound_service：Ran 55 tests ... OK。
2. PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_filling_service：Ran 42 tests ... OK。
3. PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_shipment_service：Ran 46 tests ... OK。
4. PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_usage_service：Ran 51 tests ... OK。
5. PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_return_service：Ran 46 tests ... OK。
6. PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_inventory_dao：Ran 42 tests ... OK。
7. 六文件合并命令：PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_inbound_service tests.module_business.test_filling_service tests.module_business.test_shipment_service tests.module_business.test_usage_service tests.module_business.test_return_service tests.module_business.test_inventory_dao -v：Ran 282 tests ... OK。
8. 白名单 ruff format --check：18 files already formatted，exit 0。
9. 白名单 ruff check：All checks passed!，exit 0。
10. 目录级 ruff check module_business/controller module_business/dao module_business/service tests/module_business：All checks passed!，exit 0。
11. 白名单范围 git diff --check -- <18 files>：无输出，exit 0。
12. 全仓 git diff --check：exit 2；首个实际根因为用户已有 shierfeng-fastapi-backend/logs/2026/09/20/info.log 的 trailing whitespace，未修改日志。

Concerns

• 目录级 ruff format --check module_business/controller module_business/dao module_business/service tests/module_business 仍 exit 1，精确列出 4 个非白名单文件：module_business/dao/test_batch_dao.py、module_business/service/test_batch_service.py、tests/module_business/test_sql_contract.py、tests/module_business/test_test_batch_service.py。受本任务 18 文件白名单约束，未修改。
• 全仓 git diff --check 仍被用户已有日志 trailing whitespace 阻断；Task 5 白名单范围检查已通过。

停止长任务交接（2026-09-23）

本次停止请求已立即停止后续工作；当前没有仍在运行的测试或命令，没有回滚工作区改动，也未提交 commit。

本次停止请求本身未启动新命令，因此没有新增命令输出。停止前最近一次真实验证结果保持不变：六个单文件测试分别为 55/55、42/42、46/46、51/51、46/46、42/42，合并回归为 Ran 282 tests ... OK；白名单 Ruff format/check 和白名单 git diff --check 均 exit 0。

剩余阻塞/concerns：

• 目录级 Ruff format 仍因 4 个非白名单文件未格式化而 exit 1：module_business/dao/test_batch_dao.py、module_business/service/test_batch_service.py、tests/module_business/test_sql_contract.py、tests/module_business/test_test_batch_service.py。
• 全仓 git diff --check 仍因用户已有 shierfeng-fastapi-backend/logs/2026/09/20/info.log trailing whitespace 而 exit 2；未修改该日志。

Task 5 Fix Round 1（2026-09-23）

Status

DONE_WITH_CONCERNS。review 指出的生产缺陷已修复，并创建了退回申请 IntegrityError 入口回归和事件历史指针 scope SQL 回归；未执行真实数据库写入或迁移。

修复内容

• ReturnService.request_return_services 现在向 _recover_request_integrity_error 传入 test_scope；入口回归通过真实恢复分支验证同一 TEST batch 的幂等赢家稳定返回。
• 六个 IntegrityError recovery helper 在任何授权或业务查询前调用 lock_active_batch；退回申请的 site 重授权 helper 不再在 site 行锁后锁 batch。退回申请、确认及使用在预读 rollback 后开始的新事务也先重锁 batch。
• InventoryDao.add_event 现在强制接收 scope，历史 last_event_id 查询加入 batch_scope_condition(BizPalletEvent.test_batch_id, scope)；五个服务的全部事件写入调用均传递当前 scope。
• 入库和发货 DELETE OpenAPI summary/description 更新为固定拒绝消息：不支持单条物理删除，请通过测试数据批次清理。
• 业务测试中的事件 DAO 替身更新为四参 API。

TDD 与验证命令（真实输出摘要）

1. RED：cd shierfeng-fastapi-backend && PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_return_service.ReturnRequestTransactionRedTest.test_request_integrity_error_recovers_same_test_batch_idempotently -v：exit 1，TypeError: ReturnService._recover_request_integrity_error() missing 1 required positional argument: 'test_scope'。
2. RED：cd shierfeng-fastapi-backend && PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_inventory_dao.TestDaoPublicContract.test_inventory_dao_critical_parameter_names_are_stable tests.module_business.test_inventory_dao.TestInventoryDao.test_add_event_reads_exact_previous_pointer_and_updates_inventory -v：exit 1，add_event 缺少 scope 参数，调用报 takes 4 positional arguments but 5 were given。
3. GREEN：上述退回入口单测：Ran 1 test in 0.023s，OK。
4. GREEN：TestDaoPublicContract.test_inventory_dao_critical_parameter_names_are_stable 及三个 add_event DAO 单测：Ran 4 tests in 0.021s，OK。
5. 单文件：PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_inbound_service -v：Ran 55 tests ... OK。
6. 单文件：PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_filling_service -v：Ran 42 tests ... OK。
7. 单文件：PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_shipment_service -v：Ran 46 tests ... OK。
8. 单文件：PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_usage_service -v：Ran 51 tests ... OK。
9. 单文件：PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_return_service -v：Ran 47 tests ... OK。
10. 单文件：PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_inventory_dao -v：Ran 42 tests ... OK。
11. 合并：PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m unittest tests.module_business.test_inbound_service tests.module_business.test_filling_service tests.module_business.test_shipment_service tests.module_business.test_usage_service tests.module_business.test_return_service tests.module_business.test_inventory_dao -v：Ran 283 tests in 1.761s，OK。计数为 283 是本轮新增退回恢复回归的结果。
12. PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m ruff format --check <18 个白名单文件>：18 files already formatted，exit 0。
13. PYTHONDONTWRITEBYTECODE=1 conda run -n ShiErFeng python -m ruff check <18 个白名单文件>：All checks passed!，exit 0。
14. git diff --check -- <18 个白名单文件及本报告>：无输出，exit 0（在追加本段前执行；追加后会在提交前重新执行）。

Concerns

• 本轮新增的 TEST scope 入口成功回归目前集中于退回申请；入库、装填、发货和使用的既有业务成功回归仍以 TestBatchScope.formal() 为主。生产路径、DAO SQL scope 条件和六文件回归均已验证，但尚未为这四条链路分别补齐 TEST batch 成功、跨批次拒绝、CLOSED 拒绝、派生字段和 rollback 的专门用例。
• 目录级 Ruff format 和全仓 git diff --check 的既有非白名单阻塞仍按上文保留，未修改用户文件。

Task 5 接管后补充（2026-09-23）

本轮修复

• 为正式模式 SimpleNamespace 仓库替身补齐 test_batch_id=None，保留服务层对已加载对象的强制 scope 校验。
• 入库、装填、发货扫码路径对仓库/现场、托盘、库存和活动装填记录增加显式 assert_record_in_scope 防御校验；不放宽 DAO 过滤。
• 装填与发货各增加 TEST scope 跨批次写入回滚回归；装填与发货扫码各增加跨批次对象拒绝回归。

最新验证

1. 红测：装填与发货跨批次扫码用例在新增服务校验前分别以 ServiceException not raised 失败；两条写入用例同时确认回滚路径可用。
2. 绿测：四条新增回归：Ran 4 tests ... OK。
3. 六文件合并：PYTHONDONTWRITEBYTECODE=1 OPENBLAS_NUM_THREADS=1 OMP_NUM_THREADS=1 /Users/jiaolongyan/miniconda3/envs/ShiErFeng/bin/python -u -m unittest tests.module_business.test_inbound_service tests.module_business.test_filling_service tests.module_business.test_shipment_service tests.module_business.test_usage_service tests.module_business.test_return_service tests.module_business.test_inventory_dao -v：Ran 290 tests ... OK。
4. 18 文件 ruff format --check：18 files already formatted；ruff check：All checks passed!。
5. 18 文件范围 git diff --check：无输出，exit 0。

当前 Task 5 代码已具备提交条件；本报告仍只保留为本地审查材料，不应纳入业务提交。