feat: 支持无SKU目录导入策略 (#141)

2026-08-11 11:03:18 +08:00
parent 6386d76488
commit 4259be0e55
17 changed files with 766 additions and 73 deletions
@@ -429,6 +429,15 @@ CREATE INDEX idx_syb_orders_list   ON syb_orders(updated_at DESC, syb_id DESC);
  仍存在于最新 `skus_json`。
 - `shopee_sku_id` 只为兼容历史数据保留；顺运宝同步、弹窗、映射和建采购任务均不再读写它。

+MySQL schema v8 将 `shopee_skus.sku_id` 保留为系统内部记录主键（兼容历史引用），
+新增可空且唯一的 `shopee_sku_id` 保存真实外部 ID，并用唯一
+`(goods_id, spec_key)` 标识无真实 ID 的规格。既有行将真实 ID复制到新列；新记录没有
+真实 ID 时只生成内部主键，页面和接口不得把内部值冒充真实 SKU ID。`source` 和
+`source_observed_at` 用于限制同来源更新，`is_manual=1` 始终优先保护。
+`field_sources` 与 `field_observed_at` 是只含颜色、尺码、建议和 SKU 编码的 JSON
+来源表；`fill_missing` 补字段时分别登记，`overwrite_same_source` 只更新来源属于本次
+调用方且观测时间不旧的字段，避免不同脚本各补一部分后互相覆盖。
+
 蝦皮详情把 `syb_orders` 按 `(shopee_goods_id, spec_key)` 聚合为“顺运宝观测规格”：
 订单数按唯一 `syb_id` 行计数，累计数量求和，最近一行提供历史台币售价和图片。
 该读模型不写入 `shopee_skus`。只有同一商品下恰好一条正式 SKU 的 `spec_raw`