# 订单表结构与 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. 备注 本文件为临时工作流文件,可在结构收敛后删除或迁移到正式文档。