2.4 KiB
2.4 KiB
订单表结构与 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. 后续建议
- 若以主表为准,需回退 model 字段定义到主表现状,避免 ORM 读写异常。
- 若以模型为准,补充 migration,将主表补齐到动态表同等结构。
- 在服务中明确当前读写表策略(主表或动态表),避免混用导致字段可用性不一致。
8. 备注
本文件为临时工作流文件,可在结构收敛后删除或迁移到正式文档。