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

81 lines
2.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

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