# 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 提供可直接执行的方案基础。