4.0 KiB
4.0 KiB
wms_order_delivery* / wms_order_items* 库表变更 — 影响面分析(供决策)
目的:回答「改库是否影响当前所有涉及 order 发货单表的逻辑」;未连真实库,结论基于代码静态分析。
关联:order_todo.md§0.7、§2.3a;核对清单docs/order-cancel-db-checklist.md。
1. 结论摘要(是否可直接做迁移)
| 变更类型 | 对现有逻辑的典型影响 | 建议 |
|---|---|---|
| 仅核对列已存在、不做 DDL | 无 | 推荐先做(清单 order-cancel-db-checklist.md) |
新增可空列 + 默认值(NULL 默认 / DEFAULT) |
Sequelize create/update/find 一般 不崩;未赋值的 create 不写该列则用库默认 |
低面影响,但仍须 同步 app/model/order_delivery.js + order_delivery_factory.js 的 createPhysicalTable DDL,且 所有已存在分表 需同一 migration 补列 |
| 新增 NOT NULL 无默认 | 旧 create/bulkCreate 可能 插入失败 |
高面影响,禁止在未改全链路前做 |
| 改 ENUM 取值 / 删列 / 改列类型 | order.* 列表 where、奇门/入库、报表可能 全链路受影响 |
高面影响,须单独评审与回归 |
| 仅改索引 / 注释(不改列语义) | 一般低;大表加索引注意锁表 | 可个案评估 |
当前结论(在未跑 §0.7 清单、未选定「取消进 M4」专用列名之前):
不在仓库内自动提交新的 ALTER migration。 代码侧已具备 status.cancel、intercept_status.cancelled、step(含 9 关闭)等枚举(见 order-state-machine-dictionary.md),若跑库确认列已齐全,则「取消进 M4」可先不增列,仅做应用筛选逻辑 — 此时 无需表迁移。
若跑库确认 缺列 或产品 强制 要独立标记列 → 属有面影响变更,请在你确认 列名、类型、默认值、是否只加 current 或含 history 后再做 migration。
(已更新) 本机 wms 库经 wms-db-agent 只读抽样结果见 docs/order-cancel-db-checklist.md §5:两张分表目标列齐全,可先不增列;基表缺列、勿作业务筛选;全量仓与 _history 须另跑。
2. 代码侧「会吃到表结构」的路径
2.1 动态模型来源(关键)
OrderDeliveryFactory/OrderItemsFactory使用app.model.OrderDelivery.rawAttributes(及OrderItems)动态define每张分表。- 新建物理表时,
createPhysicalTable内 手写 DDL 片段 与模型字段 必须长期一致,否则新仓新表与 ORM 不一致。
2.2 业务入口(非穷举,均为 getCurrentModel 链)
| 区域 | 文件 |
|---|---|
| System 订单 method | app/service/systemMethods/order/*.js(经 base.js#getOrderModels) |
| 业务发货单 | app/service/systems/delivery_order.js(create / update / bulkCreate 明细等) |
| 奇门 | app/service/qimenMethods/deliveryorder.js |
| 测试 / 探针 | app/service/apiMethods/test.js(命名 WmsOrderDeliveryFactory 需与挂载一致,否则仅测试路径) |
2.3 写入方式
DeliveryModel.create(orderData)、OrderItemsModel.bulkCreate(lineData):对象字段驱动;新增 可空 列且模型已声明时,旧代码路径 通常无需改 即可插入。
3. 若你决定「要做加列迁移」时的必做清单
- 产品确认:列名、含义、是否可空、默认值、是否写 history 表。
- Migration:
findOrderDeliveryTables风格 遍历wms_order_delivery/wms_order_delivery_*(及若需要则wms_order_items_*)。 app/model/order_delivery.js增加字段定义。app/model/order_delivery_factory.js中createPhysicalTable同步列定义。- 回归:
npm run test:local中与delivery_order/order相关用例;奇门若有联调则单独测。
4. 修订
| 日期 | 说明 |
|---|---|
| 2026-04-10 | 初版:静态影响面结论;未提交 migration |