This commit is contained in:
liufumingren 2026-04-11 17:08:55 +08:00
parent 54189de2db
commit 460ce119c5
2 changed files with 98 additions and 0 deletions

View File

@ -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

View File

@ -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 变更 |