docs: 归档任务 #68

docs/task/68-admin统一蝦皮与顺运宝PDD关联入口.md

@@ -0,0 +1,56 @@
+# 68 Admin：统一蝦皮关联 PDD 与采集入口
+
+- 类型：需求
+- 父级大工单：#14
+- 所属 MVP / 版本：#15 Admin 四模块可用闭环
+- 状态：已完成
+- 日期：2026-08-09
+- Gitea 工单：<http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/68>
+
+## 背景与目标
+
+蝦皮详情的 PDD 关联和采集入口原先返回 501，顺运宝处理弹窗也无法在订单上下文中完成关联。此次让两个入口共用一套事务服务，并继续复用 PDD 商品模块已经验证过的采集任务规则。
+
+## 最终方案
+
+- 完整 PDD 链接先解析 `goods_id`，再在一个事务内复用或复活 PDD 商品档案并更新蝦皮商品当前关联。
+- 已有关联与新 `goods_id` 不同时，只有明确勾选确认才允许更换；不删除旧 PDD 档案和旧规格映射。
+- 蝦皮详情和顺运宝处理详情都提供关联、创建采集任务和失败重试入口，调用同一个 Service。
+- 采集仍然只是创建无主任务，沿用已有的去重、采集中跳过和超时重试规则。
+- PDD 商品页继续承担档案浏览、批量采集和故障诊断。
+
+未修改数据库结构、Client 四接口、规格映射、采购任务和真实下单逻辑。
+
+## 改了哪些文件
+
+- `admin/repository/shopee.go`：增加当前 PDD 关联更新方法。
+- `admin/service/shopee_pdd.go`：增加共享关联事务及按蝦皮/顺运宝上下文创建采集任务。
+- `admin/service/shopee_list.go`、`admin/service/syb.go`：补充详情所需的 PDD 和采集状态。
+- `admin/handler/web/shopee.go`、`admin/handler/web/others.go`、`admin/handler/web/web.go`：实现表单处理、路由和列表状态保留。
+- `admin/templates/shopee/`、`admin/templates/syb/detail_modal.html`：增加渐进式关联和采集入口。
+- `admin/service/shopee_pdd_test.go`、`admin/handler/web/pagination_test.go`：覆盖事务、换品确认、复活、采集和跳转状态。
+- `docs/admin/01-requirements.md`、`docs/admin/05-ui-specification.md`：更新稳定需求和界面规则。
+
+## 验收结果
+
+| 验收标准 | 结果 |
+|---|---|
+| 蝦皮详情和顺运宝详情共用关联逻辑 | 通过 |
+| 同一 PDD 商品复用，软删除商品可复活 | 通过 |
+| 无效和短链接不写数据 | 通过 |
+| 更换 PDD 商品必须确认且旧映射不删除 | 通过 |
+| 采集任务沿用幂等、跳过和超时重试规则 | 通过 |
+| 页面显示当前采集状态和明确下一步 | 通过 |
+| 不修改数据库、Client 四接口和实际采购 | 通过 |
+| Go 1.23.0 build、test、vet 通过 | 通过 |
+
+## 测试
+
+- 从 `admin/` 执行：`node --check static/js/app.js`、Go 1.23.0 的 `go build ./...`、`go test ./... -count=1`、`go vet ./...`。
+- 从仓库根目录执行：`git diff --check -- admin docs/admin`。
+- 结果：全部通过。
+- **未验证到的部分**：未让真实 Client 领取新建采集任务；未在真实浏览器人工检查弹窗布局。
+
+## 相关提交
+
+- `518e6df` 统一蝦皮与顺运宝 PDD 关联入口