fix(db): 按生产已应用顺序重排 120-125 迁移

生产已按 120-123 应用履约路由四支迁移,dev 新增的付款金额审计与价格历史顺延为 124-125,避免 node-pg-migrate checkOrder 报 Not run migration;同步更新部署清单与历史迁移测试路径。
This commit is contained in:
2026-11-03 11:14:06 +08:00
parent 980cf68915
commit f447b5d73a
8 changed files with 28 additions and 22 deletions
+19 -13
View File
@@ -1,7 +1,7 @@
# 生产部署核对清单(履约与财务分流统一)
日期:2026-11-02
适用:生产当前在迁移 115,本次新增 116–125 + backend/frontend。
适用:生产已应用 116–123(main 合并的履约路由 120–123 已先行上线),本次新增 124–125(工单付款金额审计与价格历史)+ backend/frontend。
## 1. 部署前
@@ -24,25 +24,31 @@
117_internal_sku_mappings
118_internal_sku_channels
119_fulfillment_pending_reason
120_work_order_user_payment_amount_audit
121_work_order_payment_amount_history
122_fulfillment_routing_invariants
123_internal_sku_single_primary
124_work_order_template_product_projection
125_work_product_rule_pricing_mode
120_fulfillment_routing_invariants
121_internal_sku_single_primary
122_work_order_template_product_projection
123_work_product_rule_pricing_mode
124_work_order_user_payment_amount_audit
125_work_order_payment_amount_history
```
> 序号说明:生产在合并 main 后已按 120–123 应用了履约路由四支迁移,因此这四支编号固定不变;
> dev 分支的付款金额审计与价格历史顺延为 124、125,避免 `node-pg-migrate` 的 `checkOrder` 报
> `Not run migration ... is preceding already run migration ...`。
重点检查:
- 116:给已有 `tpv:` 商品补 capability 和 internal_sku 规则;
- 118:按商品能力/规则回填 `internal_sku_channels`;
- SQL 已做聚合,避免同名商品同渠道 `ON CONFLICT` 二次更新报错;
- 119:只加列和索引,风险低。
- 122:建立统一内部 SKU SQL 函数、回填人工配置、迁移可确定的旧 sku_code 规则。
- 123:建立唯一主渠道索引;若仍有并列主渠道会主动阻断迁移。
- 124:按接单模板补齐/刷新 `tpl:` 商品,只做 UPSERT,不删除商品、成本、订单或工单。
- 125:接单模板增加计价方式并回填历史模板,金额字段继续只由商品与成本中心投影。
- SQL 护栏默认只保护到生产已发布的迁移 119;部署 122 后应把 `PUBLISHED_MIGRATION_MAX_VERSION` 提升为 122。
- 120:建立统一内部 SKU SQL 函数、回填人工配置、迁移可确定的旧 sku_code 规则。
- 121:建立唯一主渠道索引;若仍有并列主渠道会主动阻断迁移。
- 122:按接单模板补齐/刷新 `tpl:` 商品,只做 UPSERT,不删除商品、成本、订单或工单。
- 123:接单模板增加计价方式并回填历史模板,金额字段继续只由商品与成本中心投影。
- 124:`work_orders` 增加付款金额旧价、修改时间、修改人三列(`ADD COLUMN IF NOT EXISTS`),幂等且不动存量数据。
- 125:新建 `work_order_payment_amount_history` 并回填已有 `payment_amount_updated` 事件,写入按工单级联删除。
- SQL 护栏默认只保护到生产已发布的迁移 119;部署 120 后应把 `PUBLISHED_MIGRATION_MAX_VERSION` 提升为 120。
## 3. 部署顺序
@@ -169,4 +175,4 @@ npx tsx scripts/reclassify-post-cutover.ts --apply
- 数据库:
- 116–125 均为新增表/列/函数/投影数据,不删旧表,可保留;
- 若必须回滚,恢复到部署前备份;
- 迁移 118–123 不改旧字段语义,回滚代码后旧逻辑仍可运行;123 的唯一主渠道索引会阻止旧代码写入并列主渠道。
- 迁移 118–121 不改旧字段语义,回滚代码后旧逻辑仍可运行;121 的唯一主渠道索引会阻止旧代码写入并列主渠道。