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