fix: 补齐不完整的 v9 商品约束 (#144)

2026-08-11 11:30:08 +08:00
parent edb835a9ed
commit 9671202f4e
4 changed files with 17 additions and 9 deletions
@@ -445,9 +445,10 @@ MySQL schema v9 为 `shopee_products` 增加 `image_url` 和 `shopee_shop_name`
 商品主图，与 `syb_orders.image_url` 的历史货运单观测图片是两个独立概念。

 MySQL schema v10（工单 #144）是兼容修复：部分数据库曾在 v8 开发中间状态提前记录
-v8/v9，实际缺少 `field_sources` 或 `field_observed_at`。v10 幂等重放 v8 的逐项建列、
-空值回填和唯一索引逻辑，再核对 v8/v9 完整形状；只有全部通过才记录 v10。它不删除
-或改写旧迁移记录，也不清空商品、SKU 或导入记录。
+v8/v9，实际缺少 `field_sources`、`field_observed_at` 或 v9 图片/店铺人工标记约束。
+v10 幂等重放 v8、v9 的逐项建列、空值回填、约束和唯一索引逻辑，再核对两版完整
+形状；只有全部通过才记录 v10。它不删除或改写旧迁移记录，也不清空商品、SKU 或
+导入记录。

 蝦皮详情把 `syb_orders` 按 `(shopee_goods_id, spec_key)` 聚合为“顺运宝观测规格”：
 订单数按唯一 `syb_id` 行计数，累计数量求和，最近一行提供历史台币售价和图片。
@@ -93,9 +93,10 @@ HTTP/HTTPS URL，最长 2048 字节；店铺名最长 500 个字符。Admin 只
 迁移只增加列和唯一索引，既有 `sku_id` 继续作为内部主键，因此历史引用不变；若检测
 到同商品重复 `spec_key`，迁移会停止且不记录 v8，必须人工确认，不能自动合并。

-若数据库已经记录 v8 或 v9，但缺少 `field_sources`、`field_observed_at` 等后加入的
-v8 结构，v10 会自动补齐并只回填空值。不要通过删除迁移版本、清库或手工伪造字段来
-绕过自检；修复完成且 v8/v9 形状均正确后，程序才会记录 v10。
+若数据库已经记录 v8 或 v9，但缺少 `field_sources`、`field_observed_at` 等 v8 结构，
+或缺少图片、店铺人工标记约束等 v9 结构，v10 会幂等重放两版迁移并只回填空值。
+不要通过删除迁移版本、清库或手工伪造结构来绕过自检；修复完成且 v8/v9 形状均
+正确后，程序才会记录 v10。

 旧版 Admin 不理解无真实 SKU ID 的新记录。应用回退前应暂停目录接口并确认没有此类
 记录；不要删除 v8 列或把内部主键复制成伪造的外部 SKU ID。