feat: 重构顺运宝规格主链路 (#88)

docs/admin/01-requirements.md

@@ -196,11 +196,10 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立
 | 订单号 | |
 | 商品标题 | |
 | 蝦皮商品 ID | 关联蝦皮数据模块 |
-| 规格 SKU | 蝦皮的规格编号 |
 | 数量 | |
 | 价格 | 蝦皮售价，**台币分**，见 §7 |
 | 图片 | 存 URL，表格里显示缩略图 |
-| 处理阶段 | 未找到蝦皮商品 / 待确认蝦皮规格 / 未关联 PDD / 待采集 / 采集中 / 采集失败 / 规格待匹配 / 可采购 / 采购数据异常 / 已创建任务 |
+| 处理阶段 | 采购数据异常（顺运宝未提供规格）/ 未关联 PDD / 待采集 / 采集中 / 采集失败 / 规格待匹配 / 可采购 / 已创建任务 |
 | 下一步 | 每行只显示当前最需要完成的一个操作 |
 | 更新时间 | |
 
@@ -208,15 +207,16 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立
 
 **双击行或点击下一步打开处理弹窗：**
 
-- 顺运宝商品 ID 能找到蝦皮商品后，先确认蝦皮 SKU。规格原文完全一致，或解析后的颜色尺码只有一个唯一候选时可以自动确认；零候选和多候选必须人工选择，不能猜。
-- `shopee_sku_id` 只表示“蝦皮规格已确认”，不等于 PDD 规格已经匹配。完整处理阶段还要检查当前 PDD 关联、采集状态和 `sku_mappings`。
-- 蝦皮 SKU 确认后，可在同一弹窗填写完整 PDD 链接并创建采集任务；链接关联规则与蝦皮详情完全一致。
+- 顺运宝的 `product_spec` 是匹配主链路的真实来源；系统不再要求先确认蝦皮 SKU。
+- “规格身份键” `spec_key` 只对顺运宝规格原文去除首尾空白、折叠连续空白，用于判断是否是同一条规格；颜色、尺寸和建议的解析只用于显示与推荐，不改变身份。
+- 找到蝦皮商品后，可在同一弹窗填写完整 PDD 链接并创建采集任务；链接关联规则与蝦皮详情完全一致。
 
 - 显示蝦皮规格原文和当前 PDD 商品 `skus_json` 里的动态规格组合与人民币价格；
 - PDD 维度来自采集结果的 `dimensions`，不得写死成颜色、尺码两个维度；
 - 操作员选好对应关系，点保存；
-- `[必须]` 保存的是**可复用的 SKU 映射**，不是这一张订单的临时数据。
-  下次遇到同一个蝦皮 SKU 自动带出，操作员只需确认。
+- `[必须]` 保存的是**可复用的商品规格映射**，键为
+  `(蝦皮商品 ID, spec_key, PDD 商品 ID)`，不是这一张订单的临时数据。
+  下次遇到同商品、同规格和同 PDD 商品时自动带出。
 - `[必须]` 该商品尚未采集（`skus_json` 为空）时，弹窗直接展示关联和创建采集任务入口，
   而不是显示一个空列表让人困惑。
 
@@ -333,7 +333,7 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立
 
 1. 该蝦皮商品已填 PDD 链接；
 2. 当前 PDD 商品已采集成功（`skus_json` 非空）；
-3. 该蝦皮 SKU 已有 PDD 规格映射；
+3. 该顺运宝规格非空，且已有当前 PDD 商品的规格映射；
 4. 数量大于 0；
 5. **价格上限已填且大于 0** —— 默认从当前映射的 PDD 规格价格带出，操作员可改，但不允许为空；
 6. 已选择分配的客户端；
@@ -470,9 +470,8 @@ MVP 之后：
 - **采集任务不指定客户端**，谁领到算谁的；采购任务仍可分配，也允许留空。
 - 任务**分配给指定客户端**，Client 只领分给自己的。
 - **不加心跳接口**；设置页显式登记，领取接口保留兼容登记，在线状态由最近活动时间派生。
-- SKU 映射**独立成表且可复用**，同一蝦皮 SKU 只人工匹配一次。
-- 货运单的"规格 SKU"**直接对应蝦皮 `商品規格ID`**，不需要转换。
-  但**不加外键**——本地查不到该 SKU 是常态，见 [03 数据模型](03-data-model.md) §4。
+- 规格映射**独立成表且可复用**，按 `(蝦皮商品 ID, spec_key, PDD 商品 ID)` 隔离；换 PDD 商品不会误用旧映射，换回时可继续复用。
+- 货运单的规格原文来自顺运宝；不再依赖蝦皮 `商品規格ID` 才能关联 PDD 和建立规格映射。
 - Admin 不提供固定默认密码；第一次启动由用户创建第一个管理员，之后初始化入口永久关闭。
 - 账号只有 `admin`（管理员）和 `purchaser`（采购员）两种固定角色；采购员不能管理用户。
 - Web 登录只保护 HTML 页面，`/api/v1/client/*` 不使用网页登录 Session，现有 Client 行为保持不变。