qipai/docs/devlogs/2026-08-11-M09-REGRESSION-商品全链路对账.md

2026-08-11 M09-REGRESSION 商品全链路对账

工程结果

• 商品订单服务新增管理侧逐单对账，只读聚合不可变订单项、成功支付与退款、库存流水 metadata 以及订单来源寄存记录/明细。
• 对账输出九项确定性检查，覆盖订单金额、数量、行数、实收、退款、库存占用余额、库存销售余额和寄存账实；任一漂移会返回失败项的应有值与实际值。
• Vue 商品运营工作台新增逐单对账视图，并在普通订单详情展示支付单、退款单和不可变状态事件，便于从聚合差异追溯原始业务流水。
• 修正商品订单与库存的 platform.manage 权限口径，使菜单可见、路由鉴权和服务层门店范围保持一致；空门店范围的平台运营账号可按租户显式门店参数工作，普通门店员工仍被拒绝。
• 真实 MySQL 回归发现库存列表/流水的分页预处理参数在 MySQL 8.4 + Node 26 下返回 ER_WRONG_ARGUMENTS；分页整数经边界校验后安全内联，列表与流水同类路径一并修复。

验证结果

• node scripts/check-m09-regression.mjs：PASS。
• 后端 TypeScript build、全量单元与路由测试：PASS；新增一致、金额/退款/寄存漂移、取消释放库存三组纯对账样例。
• Vue TypeScript 检查、生产构建与导航测试：PASS；订单详情和对账视图独立懒加载分块 gzip 约 8.19 KiB。
• WSL 原生副本 + MySQL 8.4.10：up → verify → down → up → verify PASS，217 条 up、159 条 verify、199 条 down；实测全额退款净收入、LOCK/DEDUCT 销售余额、订单寄存取完余额和 platform.manage 空门店范围。
• 中断清理探针 PASS，临时数据库、账号和 /home/f/qipai-wsl-test 已清理。
• Windows scripts/dev/windows/test-all.ps1：PASS。

阶段状态

M09-REGRESSION=DONE，M09 内部工程闭环；真实微信商品支付继续按既有规则保持 BLOCKED_EXTERNAL，不阻断唯一游标进入 M10-A。