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

98 lines
4.2 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.

# 订单取消 / 状态机 — 库表核对清单(§0.7 执行用)
> 用途:实施 `order_todo.md` **§2.3a(取消进 M4)** 前,对 **`wms_order_delivery` 及分表** 做只读核对。
> 不改变数据库;核对结果记录在工单或 `order_todo.md` 修订记录。
**PowerShell 提示**:`db-query.ps1` 若遇 **`ConvertFrom-Json` 无效 JSON**(中文注释导致编码问题),可在同一会话先执行 **`chcp 65001`** 再跑查询。
## 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
---
## 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`) |