feat: 统一蝦皮与顺运宝 PDD 关联入口 (#68)

2026-08-09 22:40:58 +08:00
parent eb0e296b7c
commit 518e6df349
14 changed files with 429 additions and 98 deletions
@@ -88,7 +88,7 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立
 ### 4.1 蝦皮数据模块

 **顶部工具条：** 导入按钮、状态筛选（全部 / 待补规格 / 未填 PDD 链接 / 已填链接）、
-商品 ID 搜索框、搜索按钮、删除按钮、批量采集按钮。
+商品 ID 搜索框、搜索按钮、删除按钮。采集从商品详情中发起，避免脱离商品上下文。

 `[必须]` 状态筛选是**刚需**，不是锦上添花（工单 #43）：本页的主要用途是维护
 （找出需要补规格的商品、找出还没关联 PDD 链接的商品），只靠商品 ID 搜索的话，
@@ -100,7 +100,7 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立

 | 列 | 说明 |
 |---|---|
-| 勾选 | 支持批量删除、批量采集 |
+| 勾选 | 支持批量删除 |
 | 商品 ID | 蝦皮商品编号 |
 | 商品名称 | |
 | 颜色 / 尺码 / 建议 | 从规格原文解析，解析不出来留空并标记 |
@@ -110,15 +110,15 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立

 **双击行打开编辑弹窗**，这是**从蝦皮商品出发**填 PDD 链接、发起采集的入口：

- 可编辑：PDD 链接、颜色、尺码、建议；
- 弹窗内提供【采集】按钮，紧挨 PDD 链接输入框；
+- 可编辑当前 PDD 商品链接；规格表继续只读展示；
+- 保存链接时从完整链接解析 `goods_id`，在同一事务内复用或复活 PDD 商品档案并更新当前关联；
+- 更换成不同 `goods_id` 时必须明确勾选确认，旧规格映射保留但不会被当前关联查询误用；
+- 弹窗内提供【创建采集任务】按钮，复用 PDD 商品模块的幂等与超时重试规则；
 - `[必须]` 采集按钮**在本页只出现在弹窗里**，不要放在每个表格行——
  一个商品有 N 个 SKU 行，放行上就是 N 个按钮干同一件事，还会建出 N 个重复任务。

-`[注意]` PDD 商品模块（§4.2）也能录入链接和发起采集，两处并存。
-本页的入口目前**还是骨架**（点了返回 501），
-两者要不要合并、以哪个为准，属于「蝦皮↔PDD 关联入口」的范围，
-由那张工单统一决定，不要在本模块单独改。
+`[注意]` PDD 商品模块（§4.2）继续作为商品档案、采集状态和故障诊断页；
+蝦皮详情和顺运宝处理详情是带业务上下文的关联入口，两者调用同一个 Service。

 **其他要求：**

@@ -210,6 +210,7 @@ PDD 商品之所以单独一个模块，是因为它在数据上就是**独立

 - 顺运宝商品 ID 能找到蝦皮商品后，先确认蝦皮 SKU。规格原文完全一致，或解析后的颜色尺码只有一个唯一候选时可以自动确认；零候选和多候选必须人工选择，不能猜。
 - `shopee_sku_id` 只表示“蝦皮规格已确认”，不等于 PDD 规格已经匹配。完整处理阶段还要检查当前 PDD 关联、采集状态和 `sku_mappings`。
+- 蝦皮 SKU 确认后，可在同一弹窗填写完整 PDD 链接并创建采集任务；链接关联规则与蝦皮详情完全一致。

 - 左边显示蝦皮的颜色尺码，右边显示该商品 `pdd_data` 里的 PDD 颜色尺码；
 - 操作员选好对应关系，点保存；
@@ -124,14 +124,12 @@
 ### 4.1 工具条

 ```text
-[导入 Excel] [批量采集]   状态[全部▾]  商品ID [________] [搜索]   [删除]
+[导入 Excel]   状态[全部▾]  商品ID [________] [搜索]   [删除]
 ```

 - **导入 Excel**：选文件 → POST 上传 → 显示结果统计
  （导入 5195 商品 / 6092 SKU，失败 N 行）。
  `[必须]` 失败行要列出行号和原因，不能静默跳过。
- **批量采集**：勾选若干行 → 服务端**按商品去重**后建采集任务。
-  `[必须]` 已是"采集中"的商品跳过，并在结果里说明跳过了几个。
 - **状态筛选**（`[必须]`，工单 #43）：全部 / 待补规格 / 未填 PDD 链接 / 已填链接。
  这个筛选是**刚需**，不是锦上添花——本页主要用途是维护
  （找出需要补规格的商品、找出还没关联 PDD 链接的商品），只靠商品 ID
@@ -166,10 +164,8 @@

 这是**从蝦皮商品出发**填 PDD 链接、发起采集的入口。

-> `[注意]` PDD 商品页（[§5](#5-pdd-商品页)）也能录入链接和发起采集，
-> 两处并存。本页的入口目前**还是骨架**（点了返回 501），
-> 两者要不要合并、以哪个为准，属于「蝦皮↔PDD 关联入口」的范围，
-> 由那张工单统一决定，不要在本页单独改。
+> PDD 商品页（[§5](#5-pdd-商品页)）负责商品档案和诊断；本弹窗负责在
+> 蝦皮商品上下文中维护“当前 PDD 商品”并发起单商品采集。顺运宝弹窗复用同一逻辑。

 ```text
 ┌─────────────────────────────────────────┐
@@ -182,18 +178,19 @@
 │ 尺码      [M_______________]            │
 │ 建议      [40-50公斤_______]            │
 │                                         │
-│ PDD 链接  [___________________] [采集]  │  ← ★
+│ PDD 链接  [___________________________]  │  ← ★
 │ 采集状态  已采集（2026-08-06 15:20）    │
 ├─────────────────────────────────────────┤
-│                        [取消]  [保存]   │
+│           [创建采集任务] [关闭] [保存关联] │
 └─────────────────────────────────────────┘
 ```

 `[必须]` 几条硬规则：

- **本页的采集按钮只在这个弹窗里出现**，不要放到表格每一行。一个商品有 N 个 SKU 行，
-  放行上就是 N 个按钮干同一件事，还会建出 N 个重复任务。
+- **创建采集任务只在这个弹窗里出现**，不要放到表格每一行或工具条，确保操作员看得到当前关联商品。
 - **规格原文只读且永远显示**。操作员靠它判断颜色尺码该怎么填。
+- 保存链接时展示当前解析出的 PDD 商品 ID；新链接指向其他商品时必须勾选明确确认。
+- 无法解析 `goods_id` 的链接整体不写入；同一商品复用档案，软删除档案可复活。
 - PDD 链接为空时**采集按钮置灰**，旁边提示"请先填写 PDD 链接"。
 - 采集状态是"采集中"时按钮置灰，提示"已在采集中"。
 - 采集失败时显示错误原因，按钮变成"重新采集"。
@@ -491,6 +488,10 @@ HTML 片段，只替换弹窗内部的表格、总数和分页。主货运单表
 `shopee_sku_id`，但同步写入明细后可以根据本地蝦皮数据做确定性唯一匹配。
 后续 PDD 关联、采集和规格映射使用同一个弹窗继续完成。

+确认蝦皮 SKU 后，弹窗先展示当前 PDD 商品 ID、完整链接和采集状态。未关联时
+可直接填写完整链接；换成其他商品需要明确确认。待采集或采集失败时显示
+“创建采集任务”或“重新创建采集任务”，采集中和已采集状态只显示说明。
+
 ```text
 ┌──────────────────────────────────────────────────┐
 │ 规格匹配 · 订单 SO-20260806-001                  │