feat: 展示蝦皮主图和店铺 (#142)

2026-08-11 11:18:51 +08:00
parent a441dfef87
commit 38d6a0a04b
22 changed files with 555 additions and 101 deletions
@@ -438,6 +438,12 @@ MySQL schema v8 将 `shopee_skus.sku_id` 保留为系统内部记录主键（兼
 来源表；`fill_missing` 补字段时分别登记，`overwrite_same_source` 只更新来源属于本次
 调用方且观测时间不旧的字段，避免不同脚本各补一部分后互相覆盖。

+MySQL schema v9 为 `shopee_products` 增加 `image_url` 和 `shopee_shop_name`。两者分别
+使用 `image_source/image_observed_at/image_is_manual` 与
+`shop_name_source/shop_name_observed_at/shop_name_is_manual` 记录来源边界。目录接口只
+能补空或更新同来源的新观测，空值、跨来源、旧观测和人工字段均不覆盖。该图片是蝦皮
+商品主图，与 `syb_orders.image_url` 的历史货运单观测图片是两个独立概念。
+
 蝦皮详情把 `syb_orders` 按 `(shopee_goods_id, spec_key)` 聚合为“顺运宝观测规格”：
 订单数按唯一 `syb_id` 行计数，累计数量求和，最近一行提供历史台币售价和图片。
 该读模型不写入 `shopee_skus`。只有同一商品下恰好一条正式 SKU 的 `spec_raw`