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
@@ -1,6 +1,6 @@
-- 122_fulfillment_routing_invariants.sql
-- 120_fulfillment_routing_invariants.sql
--
-- 合并 main 后的履约路由统一迁移(接在 dev 120/121 之后)。
-- 生产迁移 119 之后的履约路由统一迁移。
--
-- 目标:
-- 1. 订单项内部 SKU 只有一个 SQL 解析口径;
@@ -1,7 +1,7 @@
-- 123_internal_sku_single_primary.sql
-- 121_internal_sku_single_primary.sql
--
-- 一个内部 SKU 只能有一个主渠道;其他渠道必须显式标记 is_fallback。
-- 迁移 122 已把人工并列渠道收敛为兜底;这里在任何剩余歧义上显式阻止部署。
-- 迁移 120 已把人工并列渠道收敛为兜底;这里在任何剩余歧义上显式阻止部署。
DO $$
DECLARE
@@ -1,4 +1,4 @@
-- 124_work_order_template_product_projection.sql
-- 122_work_order_template_product_projection.sql
-- 接单模板商品改为事件驱动投影:新模板保存时自动建/更新商品。
-- 本迁移补齐现有模板商品,并统一状态、名称、分类和价格属性。
@@ -1,4 +1,4 @@
-- 125_work_product_rule_pricing_mode.sql
-- 123_work_product_rule_pricing_mode.sql
-- 接单模板显式保存计价方式,金额字段只由商品与成本中心写投影。
-- 历史数据按旧运行口径回填:拼单自动按件优先识别,其次识别“单价>0 且固定金额=0”。
@@ -1,4 +1,4 @@
-- 120_work_order_user_payment_amount_audit.sql
-- 124_work_order_user_payment_amount_audit.sql
-- 工单「用户付款金额」最近一次修正快照:旧价、修改时间、修改人。
-- 完整修改历史仍在 work_order_events.payment_amount_updated。
@@ -1,4 +1,4 @@
-- 121_work_order_payment_amount_history.sql
-- 125_work_order_payment_amount_history.sql
-- 工单「用户付款金额」完整修改历史:每次修改一行。
-- 独立于 work_order_events(默认只保留 180 天),工单删除时级联删除。
@@ -7,7 +7,7 @@ function read(relativeUrl: string) {
}
test('价格历史迁移建表、建索引并回填 payment_amount_updated 事件', async () => {
const sql = await read('../../db/migrations/121_work_order_payment_amount_history.sql')
const sql = await read('../../db/migrations/125_work_order_payment_amount_history.sql')
assert.ok(sql.includes('CREATE TABLE IF NOT EXISTS work_order_payment_amount_history'))
assert.ok(sql.includes('idx_work_order_payment_amount_history_order'))
assert.ok(sql.includes("e.event_type = 'payment_amount_updated'"))
+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 的唯一主渠道索引会阻止旧代码写入并列主渠道。