51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
|
# 204 Admin：确定性解析 SYB 规格并补建蝦皮 SKU
|
||
|
|
|
||
|
|
- 类型：需求
|
||
|
|
- 父级大工单：#14
|
||
|
|
- 所属 MVP / 版本：#15 后续版本
|
||
|
|
- 状态：已完成，待用户验收
|
||
|
|
- 日期：2026-08-13
|
||
|
|
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/204
|
||
|
|
|
||
|
|
## 背景与目标
|
||
|
|
|
||
|
|
SYB 货运单已有蝦皮商品 ID 和颜色尺码原文，但此前只作为只读观测展示，商品主数据
|
||
|
|
缺少对应 SKU。目标是只解析格式明确的数据，避免猜测污染主数据。
|
||
|
|
|
||
|
|
## 最终方案
|
||
|
|
|
||
|
|
新增纯函数解析“颜色,尺码【建议】”二维格式，兼容全角逗号和常见标准尺码；额外维度、
|
||
|
|
未知尺码、空字段或括号不完整时返回失败且不写 SKU。成功记录使用商品 ID 与
|
||
|
|
`spec_key` 生成稳定内部主键，真实蝦皮 SKU ID 保持空，来源标为 `syb`。后续目录接口
|
||
|
|
按同一规格身份补真实 ID，并可把各字段来源提升为权威来源。MySQL v16 回填历史数据。
|
||
|
|
|
||
|
|
## 改了哪些
|
||
|
|
|
||
|
|
- `admin/spec/shopee_spec.go`：确定性解析器。
|
||
|
|
- `admin/service/syb.go`、`admin/repository/syb.go`：同步和历史补建入口。
|
||
|
|
- `admin/repository/catalog_import.go`：同规格权威来源升级。
|
||
|
|
- `admin/repository/mysql_db.go`：增加 MySQL v16 迁移与自检。
|
||
|
|
- `admin/spec/shopee_spec_test.go`、`admin/repository/syb_test.go`：解析与合并测试。
|
||
|
|
- `docs/admin/`：更新“SYB 只读观测”的旧基线。
|
||
|
|
|
||
|
|
## 验收结果
|
||
|
|
|
||
|
|
| 验收标准 | 结果 |
|
||
|
|
|---|---|
|
||
|
|
| 明确的颜色、尺码和建议可解析 | 通过 |
|
||
|
|
| 不明确格式不猜测、不写结构化 SKU | 通过 |
|
||
|
|
| 重复同步使用同一内部记录 | 通过 |
|
||
|
|
| 商品目录可补真实 SKU ID 并升级低优先级字段 | 通过 |
|
||
|
|
| v16 可回填历史 SYB 规格 | 代码与迁移测试已补，待独立 MySQL 8.4 库实跑 |
|
||
|
|
|
||
|
|
## 测试
|
||
|
|
|
||
|
|
- 执行的命令：`$env:GOTOOLCHAIN="go1.23.0"; go vet ./...; go build ./...; go test ./... -count=1`
|
||
|
|
- 结果：解析器和非 MySQL 回归通过；MySQL 集成测试因未启用隔离库而跳过。
|
||
|
|
- **没验证到的部分**：真实 MySQL 8.4 v15→v16 历史回填和重放。`buy` 无
|
||
|
|
`autobuy_test` 权限，未使用生产库代测。
|
||
|
|
|
||
|
|
## 相关提交
|
||
|
|
|
||
|
|
- `ad1ccc2` 完善 SYB 蝦皮主数据与软删除
|