2.2 KiB
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
优先级建议:
- 权限与组织类
- 库位与库存类
- 打印类
- 日志与国际化类
步骤 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 提供可直接执行的方案基础。