fix(M09-REGRESSION): 完成商品逐单对账与权限收口

2026-08-11 08:25:12 +08:00
parent e91b979128
commit 41b9cf7349
21 changed files with 566 additions and 39 deletions
@@ -0,0 +1,22 @@
+# 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`。