WMS_MAIN/tmp-order-schema-workflow.md
2026-03-23 17:10:07 +08:00

2.4 KiB
Raw Blame History

订单表结构与 Model 比对临时工作流

更新时间: 2026-03-22

1. 目标

用于后续排查订单相关问题时,快速复用以下能力:

  • 获取数据库订单表结构
  • 与当前 Model 做字段级比对
  • 识别主表/分仓动态表的结构漂移

2. 本次已确认的订单相关表

  • wms_entry_order
  • wms_order_delivery
  • wms_order_delivery_100000
  • wms_order_items
  • wms_order_items_100000

3. 相关 Model

  • app/model/entry_order.js
  • app/model/order_delivery.js
  • app/model/order_items.js
  • app/model/order_delivery_factory.js
  • app/model/order_items_factory.js

4. 已生成产物

  • 结构与差异总结果: temp/tmp-order-schema-compare.json
  • 比对脚本(可复跑): script/tmp-compare-order-schema.cjs

5. 关键比对结论

5.1 wms_entry_order vs entry_order model

  • 字段数: model 28 / db 28
  • 结论: 完全一致

5.2 wms_order_delivery vs order_delivery model

  • 字段数: model 72 / db 54
  • model 有但主表 db 没有的字段: from_key, items, items_count, items_total, items_weight, items_hash, items_crc, wave_id, post_status, storage_status, pick_status, pack_status, inspection_status, print_status, claim_status, outbound_status, lock_status, intercept_status
  • 结论: 主表结构落后于模型定义

补充:

  • delivery_time(发货时间) 已在主表与动态表补齐,并同步到 model 与动态建表 SQL。

5.3 wms_order_items vs order_items model

  • 字段数: model 18 / db 15
  • model 有但主表 db 没有的字段: stock_id, created_at, updated_at
  • 结论: 主表结构落后于模型定义

5.4 动态表 vs 主表

  • wms_order_delivery_100000 相比 wms_order_delivery 多出 18 个字段(与 modelOnly 一致)
  • wms_order_items_100000 相比 wms_order_items 多出 3 个字段(与 modelOnly 一致)
  • 结论: 动态表更接近当前模型,主表较旧

6. 复用命令

6.1 一键重跑比对

PowerShell:

node .\script\tmp-compare-order-schema.cjs

6.2 快速查看结果摘要

PowerShell:

Get-Content .\temp\tmp-order-schema-compare.json -TotalCount 160

7. 后续建议

  1. 若以主表为准,需回退 model 字段定义到主表现状,避免 ORM 读写异常。
  2. 若以模型为准,补充 migration,将主表补齐到动态表同等结构。
  3. 在服务中明确当前读写表策略(主表或动态表),避免混用导致字段可用性不一致。

8. 备注

本文件为临时工作流文件,可在结构收敛后删除或迁移到正式文档。