diff --git a/docs/order-cancel-db-checklist.md b/docs/order-cancel-db-checklist.md new file mode 100644 index 0000000..e8bfa87 --- /dev/null +++ b/docs/order-cancel-db-checklist.md @@ -0,0 +1,53 @@ +# 订单取消 / 状态机 — 库表核对清单(§0.7 执行用) + +> 用途:实施 `order_todo.md` **§2.3a(取消进 M4)** 前,对 **`wms_order_delivery` 及分表** 做只读核对。 +> 不改变数据库;核对结果记录在工单或 `order_todo.md` 修订记录。 + +## 1. 列出本库所有发货单相关表 + +```sql +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`)。 + +```sql +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 diff --git a/docs/order-state-machine-dictionary.md b/docs/order-state-machine-dictionary.md new file mode 100644 index 0000000..658ef31 --- /dev/null +++ b/docs/order-state-machine-dictionary.md @@ -0,0 +1,45 @@ +# 订单发货单 — 状态机字段字典(骨架 v0) + +> **单一事实来源(代码)**:`app/model/order_delivery.js` 内 `StatusEnum` 与 `step` 定义。 +> 本文档为 **v0 骨架**:便于产品 / 数仓 / 报表对齐;**与数仓字段映射、变更登记** 在后续迭代补全(见 `order_todo.md` §5.2)。 + +## 1. 主状态与步骤 + +| 字段 | 类型(ORM) | 枚举或取值 | 说明(摘自模型注释) | +|------|-------------|------------|----------------------| +| `status` | ENUM | `pedding`, `created`, `cancel`, `error` | 订单状态 | +| `step` | INTEGER | `0` 未审核,`1` 已审核,`2` 处理中,`3` 驳回/异常,`4` 配送中,`5` 已完成,`9` 已关闭 | 订单步骤 | + +## 2. 各环节状态机(ENUM) + +| 字段 | 枚举值 | +|------|--------| +| `sync_status` | `padding`, `fin`, `error` | +| `post_status` | `padding`, `fin`, `timeout`, `error`, `none` | +| `storage_status` | `padding`, `fin`, `error`, `none` | +| `pick_status` | `padding`, `fin`, `error`, `none` | +| `pack_status` | `none`, `padding`, `fin`, `error` | +| `inspection_status` | `none`, `padding`, `running`, `fin`, `error` | +| `print_status` | `none`, `padding`, `fin`, `error` | +| `claim_status` | `none`, `padding`, `fin`, `error` | +| `outbound_status` | `none`, `padding`, `fin`, `error` | +| `lock_status` | `none`, `warehouse`, `store` | +| `intercept_status` | `none`, `requesting`, `requested`, `intercepting`, `intercepted_in_transit`, `intercepted_at_warehouse`, `returning`, `returned`, `delivered_by_mistake`, `timeout`, **`cancelled`**, `failed`, `exception` | + +## 3. 其它与展示相关(非 ENUM) + +| 字段 | 说明 | +|------|------| +| `delivery_time` | 发货时间;与 M6 出库时间策略相关 | +| `create_at` / `updated_at` | 创建 / 更新时间 | + +## 4. 待产品补充(v1+) + +- 「取消进 M4」专用标记:若不用 `status`/`step`/`intercept_status` 组合表达,则 **新增列** 后的字典条目与数仓同步表。 +- 与奇门 **不同步** 的克隆续单字段(见 `order_todo.md` §2.4)。 + +## 5. 修订 + +| 版本 | 说明 | +|------|------| +| v0 | 自 `order_delivery.js` 摘录枚举骨架,无 DB 变更 |