docs: 更新任务 #259 迁移归档

This commit is contained in:
chengma
2026-08-18 15:37:12 +08:00
parent b685d2ce62
commit 7175af5da8
+5 -4
View File
@@ -13,7 +13,8 @@
## 最终方案
- MySQL v28 在原业务表追加可空二进制排序字段 `source_sku_raw VARCHAR(500)`。
- MySQL v28 在原业务表追加可空二进制排序字段 `source_sku_raw VARCHAR(500)`;v29
兼容已被中间版本按表默认排序规则创建并记录 v28 的数据库,把字段规范为 `utf8mb4_bin`。
- 导入器兼容“原始SKU”“原始sku”“原始 SKU”和带来源说明的表头。数据库保留单元格原文,比较时只去除两端空白。
- 重复导入补充原始 SKU;已回写、回写中或需核对记录仍保留原状态和远端审计。
- 先执行订单、采购字段和规格门禁,再把原始 SKU 与候选 `sku/variationSku` 完全相等比较。唯一命中时允许覆盖分隔符不同造成的档口零命中。
@@ -22,7 +23,7 @@
## 改了哪些
- `admin/repository/mysql_db.go`:增加 MySQL v28 迁移和字段结构自检。
- `admin/repository/mysql_db.go`:增加 MySQL v28 字段迁移、v29 兼容迁移和结构自检。
- `admin/model/inner_code.go`、`admin/repository/inner_code.go`:贯通原始 SKU 的插入、幂等更新、扫描和终态审计保留。
- `admin/service/inner_code_import.go`:兼容可选表头、保留原文、校验长度及同业务键源值一致性。
- `admin/service/inner_code_match.go`:增加精确原始 SKU 证据、旧规则兜底和证据冲突阻断。
@@ -33,7 +34,7 @@
| 验收标准 | 结果 |
|---|---|
| v28 可重放迁移及结构自检 | 通过 |
| v28/v29 可重放迁移及结构自检 | 通过 |
| 17 号 Excel 第 31、32 行读出目标原始 SKU | 通过 |
| 原始 SKU 精确命中 `sku` 或 `variationSku` | 通过 |
| 原始 SKU 缺失或零命中时保留旧档口规则 | 通过 |
@@ -45,7 +46,7 @@
- 执行的命令:`go test ./service ./repository ./syb -run InnerCode -count=1`、`go test ./... -count=1`、`go build ./...`、`go vet ./...`、`git diff --check`(Go 1.23.0)。另对 `raw_data/Shopee线下档口入库码映射_20260817_V3.3-R5.xlsx` 做本地只读解析,确认第 31、32 行原始 SKU。
- 结果:全部通过;实际 Excel 目标两行均成功解析。
- **没验证到的部分**:未连接生产 MySQL 执行 v28;未登录生产顺运宝重新规划目标订单,也未执行任何远端回写。
- **没验证到的部分**:实现提交后尚未连接生产 MySQL 执行 v29;未登录生产顺运宝重新规划目标订单,也未执行任何远端回写。
## 相关提交