cmautobuy/docs/task/183-顺运宝复用蝦皮PDD关联.md

183 Admin：顺运宝同步复用蝦皮商品已有 PDD 关联并明确展示

• 类型：需求
• 父级大工单：#14
• 所属 MVP / 版本：#15 Admin 四模块可用闭环
• 状态：已完成
• 日期：2026-08-12
• Gitea 工单：#183

背景与目标

顺运宝货运单如果包含已经在蝦皮商品主数据中关联过的蝦皮商品 ID，采购员不应再次手工输入 PDD URL。本任务固定现有动态复用行为，并让列表和详情明确显示关系来源。

最终方案

• 继续通过 syb_orders.shopee_goods_id → shopee_products.pdd_goods_id → pdd_products 动态读取当前有效关联。
• 不向 syb_orders 复制 PDD 商品 ID 或 URL，不新增数据库迁移。
• 关联目标存在且未软删除时，顺运宝明细直接按其采集状态进入待采集、采集中或规格匹配阶段。
• 列表和详情显示“使用蝦皮商品的 PDD 关联：<商品 ID>，无需重复输入链接”。关联输入保留给主动换品。
• 目标 PDD 缺失或软删除时回到未关联阶段，不显示复用提示，也不静默复活。

改了哪些

• admin/service/syb.go：为顺运宝列表和详情生成有效关联来源文案。
• admin/templates/syb/list.html：在处理阶段下显示复用提示。
• admin/templates/syb/detail_modal.html：说明无需重复输入，只有换品时才修改关联。
• admin/service/purchase_workflow_test.go：覆盖先关联后同步、重复同步和 PDD 软删除。
• admin/main_test.go：固定列表和详情的来源提示。
• docs/admin/01-requirements.md、03-data-model.md、05-ui-specification.md：同步业务、数据所有权和界面规则。

验收结果

验收标准	结果
已有关联时新顺运宝明细直接取得 PDD 商品	通过
不再显示未关联并进入正确后续阶段	通过
列表和详情明确显示关系来源	通过
重复同步不覆盖或复制关联	通过
PDD 缺失或软删除时安全判定失效	通过
换绑隔离旧规格映射、换回可复用	通过（现有回归继续通过）
无关联时保留手工输入入口	通过
固定 Go 1.23.0 验证通过	通过

测试

• 执行的命令：定向 go test ./service；固定 Go 1.23.0 的 go vet ./...、go build ./...、go test ./... -count=1。
• 结果：Admin 全部包通过；自动复用、重复同步、软删除、换绑映射隔离和模板提示测试通过。
• 没验证到的部分：未连接真实顺运宝账号发起线上同步；未启动浏览器进行人工视觉验收。

相关提交

• 4c5f061 feat: 明确顺运宝复用 PDD 关联 (#183)