WMS_MAIN/docs/order-cancel-db-checklist.md
liufumingren aba81d497a ok
2026-04-11 17:30:06 +08:00

4.2 KiB
Raw Blame History

订单取消 / 状态机 — 库表核对清单(§0.7 执行用)

用途:实施 order_todo.md §2.3a(取消进 M4) 前,对 wms_order_delivery 及分表 做只读核对。
不改变数据库;核对结果记录在工单或 order_todo.md 修订记录。

PowerShell 提示:db-query.ps1 若遇 ConvertFrom-Json 无效 JSON(中文注释导致编码问题),可在同一会话先执行 chcp 65001 再跑查询。

1. 列出本库所有发货单相关表

SELECT TABLE_NAME
FROM INFORMATION_SCHEMA.TABLES
WHERE TABLE_SCHEMA = DATABASE()
  AND (
    TABLE_NAME = 'wms_order_delivery'
    OR TABLE_NAME REGEXP '^wms_order_delivery_[0-9]+(_history)?$'
  )
ORDER BY TABLE_NAME;

2. 对每张表核对关键列是否存在

将 YOUR_TABLE 替换为上一步的表名(含模板表 wms_order_delivery 与各仓 wms_order_delivery_{wh} / _history)。

SELECT COLUMN_NAME, DATA_TYPE, COLUMN_TYPE, IS_NULLABLE, COLUMN_COMMENT
FROM INFORMATION_SCHEMA.COLUMNS
WHERE TABLE_SCHEMA = DATABASE()
  AND TABLE_NAME = 'YOUR_TABLE'
  AND COLUMN_NAME IN (
    'status',
    'intercept_status',
    'step',
    'outbound_status',
    'inspection_status',
    'delivery_time',
    'updated_at',
    'create_at'
  )
ORDER BY COLUMN_NAME;

3. 结论填写(人工)

检查项 是否满足「取消进 M4」筛选与展示
status 含 cancel 枚举(与 ORM 一致)
intercept_status 含 cancelled 等
step 存在且含「9=已关闭」语义
若产品要求 独立「取消进 M4」列 缺则走 migration + 模型 + 工厂 DDL

4. 参考

  • 模型枚举源:app/model/order_delivery.js(StatusEnum、step 注释)
  • 规划说明:仓库根目录 order_todo.md §0.7、§2.3a

5. wms-db-agent 诊断记录(本机一次抽样,2026-04-10)

工具:script/db-query.ps1,client wms,DATABASE() = wms。以下为 只读 结果摘要;其它环境须自行重跑 §1~§2。

5.1 匹配到的表

TABLE_NAME
wms_order_delivery(基表/模板)
wms_order_delivery_100000
wms_order_delivery_1000028

本库本次 未发现 *_history 表。

5.2 目标列是否存在(Y/N)

TABLE_NAME status intercept_status step outbound_status inspection_status
wms_order_delivery Y N Y N N
wms_order_delivery_100000 Y Y Y Y Y
wms_order_delivery_1000028 Y Y Y Y Y

delivery_time / updated_at / create_at 三张表均有(基表 updated_at/create_at 为 YES)。

5.3 与 §0.7 / §2.3a 的对照结论

  • 分表(_100000、_1000028):§0.7 所列 status / intercept_status / step / outbound_status / inspection_status 均存在;intercept_status 含 cancelled,status 含 cancel;可先不增列,用组合条件做「取消进 M4」筛选(产品确认 WHERE 口径即可)。
  • 基表 wms_order_delivery:缺 intercept_status、outbound_status、inspection_status;业务筛选勿依赖基表,以 wms_order_delivery_{warehouseId} 为准。
  • 枚举差异:不同物理表上 status 的 enum 集合不一致(基表与分表、分表之间均有差异);规则与迁移须 按仓/按表 评估,勿假设全局一致。
  • 全量:当前仅抽样 2 张分表;生产请对 全部 wms_order_delivery_* 重跑本清单;若有 _history 须单独对齐列集。

5.4 §3 结论栏(代填,可改)

检查项 是否满足「取消进 M4」筛选与展示
status 含 cancel 枚举(与 ORM 一致) 分表:是;基表:部分(见上 enum 差异)
intercept_status 含 cancelled 等 分表:是;基表:无此列
step 存在且含「9=已关闭」语义 是(int NOT NULL,注释一致)
若产品要求 独立「取消进 M4」列 未检出有;若需要仍须 migration(见 order-delivery-migration-impact.md)