From aba81d497ae66c23321ffe15f17418c438bf2e03 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Sat, 11 Apr 2026 17:30:06 +0800 Subject: [PATCH] ok --- docs/order-cancel-db-checklist.md | 44 +++++++++++++++++++++++++++++++ order_todo.md | 10 +++++-- script/db-query.ps1 | 22 +++++++++++++--- 3 files changed, 70 insertions(+), 6 deletions(-) diff --git a/docs/order-cancel-db-checklist.md b/docs/order-cancel-db-checklist.md index e8bfa87..d71f579 100644 --- a/docs/order-cancel-db-checklist.md +++ b/docs/order-cancel-db-checklist.md @@ -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`) | diff --git a/order_todo.md b/order_todo.md index 7b54073..9aaba93 100644 --- a/order_todo.md +++ b/order_todo.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** | diff --git a/script/db-query.ps1 b/script/db-query.ps1 index 10b9dce..1504697 100644 --- a/script/db-query.ps1 +++ b/script/db-query.ps1 @@ -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)"