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

2026-08-09 22:40:58 +08:00
parent eb0e296b7c
commit 518e6df349
14 changed files with 429 additions and 98 deletions
@@ -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                  │