WMS_MAIN/temp/docs/migration_execution_plan.md

2.2 KiB

migration_execution_plan

更新时间: 2026-03-22

1. 执行原则

  • 先解决 SequelizeMeta 漂移,再补新增 migration。
  • 先补静态基表,再补关联表,再补日志/配置/打印等扩展表。
  • 动态分表与视图单独治理,不混入普通 createTable 批次。
  • 所有 migration 需保证幂等,避免现有环境重复执行报错。

2. 推荐顺序

步骤 1: 漂移核对

  • 核对以下 4 个未进入 SequelizeMeta 的 migration 与当前数据库实际结构是否一致:
    • 20251111083733-create-wms-stock-store.js
    • 20251112085825-create-wms-entry-order.js
    • 20251112085844-create-wms-entry-items.js
    • 20260322061000-add-delivery-time-to-order-delivery-tables.js
  • 若结构已存在且一致,优先制定“补登记基线方案”而不是直接重跑。

步骤 2: 补齐有 model 的静态表 migration

优先级建议:

  1. 权限与组织类
  2. 库位与库存类
  3. 打印类
  4. 日志与国际化类

步骤 3: 补齐无 model 但业务依赖的表 migration

优先补以下类型:

  • system_log / api_log
  • print_log / print_batch / printer_config
  • platform_print_config
  • wave_batch / wave_operation_log
  • order_operation_log

步骤 4: 动态分表治理

  • 为 order_delivery/order_items 动态分表建立统一 migration 策略。
  • 后续迁移以“母表 + 动态建表 SQL 模板/工厂策略同步”为主,不逐仓库表固化。

步骤 5: 视图治理

  • 为以下视图补充 create/drop migration:
    • v_pick_space
    • vw_warehouse_quota

3. 建议批次

  • 批次 A: 漂移核对与基线修正
  • 批次 B: 静态核心表 migration 补齐
  • 批次 C: 日志/配置/打印扩展表 migration 补齐
  • 批次 D: 动态分表与视图治理

4. local/test 演练方案

local

  • 先在本地库回放已有 migration。
  • 再逐批执行新增 migration。
  • 每批完成后执行 schema 对比与关键 API 冒烟。

test

  • 按 local 已验证通过的批次顺序执行。
  • 保留每批执行前后的表结构快照。
  • 若发现 drift 或兼容问题,先暂停后续批次。

5. 阶段 2 目标

  • 明确每类表的 migration 补齐范围。
  • 明确执行顺序和批次边界。
  • 为后续正式补 migration 提供可直接执行的方案基础。