98 lines
4.2 KiB
Markdown
98 lines
4.2 KiB
Markdown
# 订单取消 / 状态机 — 库表核对清单(§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`) |
|