ok
This commit is contained in:
parent
18580144c6
commit
aba81d497a
@ -3,6 +3,8 @@
|
||||
> 用途:实施 `order_todo.md` **§2.3a(取消进 M4)** 前,对 **`wms_order_delivery` 及分表** 做只读核对。
|
||||
> 不改变数据库;核对结果记录在工单或 `order_todo.md` 修订记录。
|
||||
|
||||
**PowerShell 提示**:`db-query.ps1` 若遇 **`ConvertFrom-Json` 无效 JSON**(中文注释导致编码问题),可在同一会话先执行 **`chcp 65001`** 再跑查询。
|
||||
|
||||
## 1. 列出本库所有发货单相关表
|
||||
|
||||
```sql
|
||||
@ -51,3 +53,45 @@ ORDER BY COLUMN_NAME;
|
||||
|
||||
- 模型枚举源:`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`) |
|
||||
|
||||
@ -65,7 +65,7 @@
|
||||
|
||||
**实施 §2.3a 前必须执行:**
|
||||
|
||||
0. **核对清单(已产出,小阶段)**:只读 SQL 与步骤见 **`docs/order-cancel-db-checklist.md`**(不在仓库内自动连库执行)。
|
||||
0. **核对清单(已产出,小阶段)**:只读 SQL 与步骤见 **`docs/order-cancel-db-checklist.md`**(不在仓库内自动连库执行)。**库表 DDL 变更影响面**见 **`docs/order-delivery-migration-impact.md`**。
|
||||
1. **对库**:对 `wms_order_delivery` 及 **`wms_order_delivery_%` 分表** 跑字段清单(`INFORMATION_SCHEMA`),确认 **`status` / `intercept_status` / `step` / `outbound_status`** 等与「取消后进 M4」**筛选用例**是否够用。
|
||||
2. **若产品要求独立可辨的「取消进 M4」标记**(例如与 `status=cancel` 但尚未占配送域行的组合区分):**库中无字段则新增**(如 `close_channel`、`cancelled_at`、`m4_reason_code` 等,名称待定),并同步:
|
||||
- `app/model/order_delivery.js`;
|
||||
@ -204,6 +204,8 @@
|
||||
| 日期 | 内容 |
|
||||
|------|------|
|
||||
| 2026-04-10 | **无业务代码 / 无 migration 变更**。新增只读交付物:`docs/order-cancel-db-checklist.md`(§0.7 跑库步骤)、`docs/order-state-machine-dictionary.md`(状态机字典 **v0 骨架**,与 `app/model/order_delivery.js` 摘录一致)。**数仓映射、实际跑库结果** 仍待下一小阶段。 |
|
||||
| 2026-04-10 | **小阶段 A-1(影响面)**:新增 `docs/order-delivery-migration-impact.md`。**结论**:在未跑库确认缺列、且未敲定「取消进 M4」专用列前,**不自动提交 ALTER migration**;若清单验证列已齐,可先 **零表变更** 做应用筛选。详见该文档 **§1**。 |
|
||||
| 2026-04-10 | **小阶段 A-2(wms-db-agent 只读诊断)**:已对 `wms` 库跑清单;结果写入 **`docs/order-cancel-db-checklist.md` §5**。要点:**分表** `100000`/`1000028` 目标列齐全,可先不增列做筛选;**基表**缺三列、**勿**当业务表用;**无 `_history` 样本**;`chcp 65001` 防 JSON 解析失败。 |
|
||||
|
||||
### 阶段 A — 文档与规则冻结
|
||||
|
||||
@ -211,8 +213,10 @@
|
||||
- [ ] M1→M2:库存校验 API、M7 推送接口与回写字段。
|
||||
- [ ] 外部「发货完成」通知与状态机字段的映射表(落到 `outbound_status` / `step` 等)。
|
||||
- [x] **§0.7 清单文档**:`docs/order-cancel-db-checklist.md`(各环境人工执行)。
|
||||
- [ ] **§0.7 跑库与缺列**:按清单在各环境执行;**缺则 migration**;更新模型与工厂 DDL。
|
||||
- [x] **§0.7 跑库(本机 wms 一次)**:见 `docs/order-cancel-db-checklist.md` §5;**分表列齐**;**其它仓/生产须复跑**。
|
||||
- [ ] **§0.7 缺列 migration**:若产品仍要独立「取消进 M4」列或基表对齐,再开 migration;更新模型与工厂 DDL。
|
||||
- [x] **状态机字典 v0 骨架**:`docs/order-state-machine-dictionary.md`(与数仓/报表的 **字段映射表** 仍待补)。
|
||||
- [x] **订单表 DDL 影响面分析**:`docs/order-delivery-migration-impact.md`(结论:**未自动做 migration**,待跑库 + 列名后由你决策)。
|
||||
|
||||
### 阶段 B — 配送域工厂(3 自然月 + 强分区事务)
|
||||
|
||||
@ -275,3 +279,5 @@
|
||||
| 补充 | **§0.7** 取消状态机与分表核对/缺列 migration;**克隆续单不奇门同步、首期人工补单**;**字段字典与数仓报表同步**;**§5a 运维审批预留** |
|
||||
| 补充 | **§5 重写**:区分 **规则层已满足** vs **交付层未完成**;原 checklist 拆入 §5.1 / §5.2 并指向 §4 |
|
||||
| 2026-04-10 | **小阶段 A-0**:新增 `docs/order-cancel-db-checklist.md`、`docs/order-state-machine-dictionary.md`;§0.7 / §4 阶段 A / §5.2 同步;无代码变更 |
|
||||
| 2026-04-10 | **小阶段 A-1**:`docs/order-delivery-migration-impact.md`;**未提交 migration**(待你根据跑库 + 列名决策) |
|
||||
| 2026-04-10 | **小阶段 A-2**:wms-db-agent 只读诊断;`order-cancel-db-checklist.md` §5;**未提交 migration** |
|
||||
|
||||
@ -61,11 +61,17 @@ const { createRequire } = require("module");
|
||||
|
||||
try {
|
||||
const [rows] = await connection.query(query);
|
||||
process.stdout.write(JSON.stringify({
|
||||
const payload = JSON.stringify({
|
||||
client: clientName,
|
||||
rowCount: Array.isArray(rows) ? rows.length : 0,
|
||||
rows,
|
||||
}));
|
||||
});
|
||||
const outPath = process.argv[6];
|
||||
if (outPath) {
|
||||
require('fs').writeFileSync(outPath, payload, 'utf8');
|
||||
} else {
|
||||
process.stdout.write(payload);
|
||||
}
|
||||
} finally {
|
||||
await connection.end();
|
||||
}
|
||||
@ -80,8 +86,12 @@ $tempNodeFile = [System.IO.Path]::ChangeExtension($tempFile.FullName, ".cjs")
|
||||
Move-Item -Path $tempFile.FullName -Destination $tempNodeFile -Force
|
||||
Set-Content -Path $tempNodeFile -Value $nodeScript -Encoding UTF8
|
||||
|
||||
$jsonOutFile = [System.IO.Path]::ChangeExtension(
|
||||
([System.IO.Path]::Combine([System.IO.Path]::GetTempPath(), 'db-query-' + [Guid]::NewGuid().ToString())),
|
||||
'.json'
|
||||
)
|
||||
try {
|
||||
$json = & node $tempNodeFile $projectRoot $configResolved.Path $DbClient $Query
|
||||
$null = & node $tempNodeFile $projectRoot $configResolved.Path $DbClient $Query $jsonOutFile
|
||||
if ($LASTEXITCODE -ne 0) {
|
||||
throw "Node query runner exited with code $LASTEXITCODE."
|
||||
}
|
||||
@ -89,7 +99,11 @@ try {
|
||||
Remove-Item -Path $tempNodeFile -ErrorAction SilentlyContinue
|
||||
}
|
||||
|
||||
$result = $json | ConvertFrom-Json
|
||||
try {
|
||||
$result = Get-Content -LiteralPath $jsonOutFile -Raw -Encoding utf8 | ConvertFrom-Json
|
||||
} finally {
|
||||
Remove-Item -Path $jsonOutFile -ErrorAction SilentlyContinue
|
||||
}
|
||||
Write-Host "Client: $($result.client)"
|
||||
Write-Host "Rows: $($result.rowCount)"
|
||||
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user