refactor: 切换蝦皮数据到目录接口 (#135)

This commit is contained in:
chengma
2026-08-11 10:16:48 +08:00
parent 8f68845dfd
commit 0588ef18c8
20 changed files with 84 additions and 1043 deletions
+6 -9
View File
@@ -369,23 +369,20 @@ POST /am/stock/detail/listByStock?hist=0
### 6.3 `productSpec` 的格式和蝦皮报表完全一致
```text
蝦皮 Excel「商品規格」 黑色,M【建議40-50公斤】
蝦皮目录 `spec_raw` 黑色,M【建議40-50公斤】
顺运宝 productSpec 白色,L【建議50-60公斤】
黑色+白色【純棉兩件裝】 簡約親膚,L【建議52.5-60公斤】
```
`[必须]` **直接复用 `service.ParseSpec()`**(#38 实现),不要另写一份解析。
两处各写一份,规则迟早不一致,而解析出的颜色尺码要拿去下单。
`[必须]` 第二个例子里颜色部分自带 `【】`,`ParseSpec` 已覆盖这种情况
(按第一个逗号切开)。
`[必须]` 规格身份统一复用 `spec.SpecKey()`:只折叠空白,不猜颜色、尺码或建议。
第三方目录脚本提交 `spec_raw` 和明确的解析结果;顺运宝匹配不到时交给人工确认。
### 6.4 由此推导出的匹配路径
```text
productId ──→ shopee_products.goods_id 商品级,直接相等
productSpec ──→ ParseSpec() ──→ 颜色 + 尺码
──→ 在该商品的 shopee_skus 里比对 ──→ 拿到 sku_id
productSpec ──→ SpecKey() ──→ 稳定规格身份键
──→ 在该商品目录和人工映射中查找
```
`[必须]` 比对不上时**不要猜**,标成待人工匹配。蝦皮报表只含有销售成绩的
@@ -543,4 +540,4 @@ syb:
- 数据落库:[03 数据模型](03-data-model.md)
- 界面:[05 界面规范](05-ui-specification.md) §6 顺运宝数据页
- 安全要求:[06 质量与安全](06-quality-security.md)
- 规格解析:`admin/service/shopee_import.go` 的 `ParseSpec()`
- 规格身份:`admin/spec/speckey.go` 的 `SpecKey()`