From 7e2d33ce620767dbb695d2e8abd162075e4c5e2b Mon Sep 17 00:00:00 2001 From: chengma Date: Wed, 12 Aug 2026 15:13:32 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=BD=92=E6=A1=A3=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#183?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/task/183-顺运宝复用蝦皮PDD关联.md | 52 ++++++++++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 docs/task/183-顺运宝复用蝦皮PDD关联.md diff --git a/docs/task/183-顺运宝复用蝦皮PDD关联.md b/docs/task/183-顺运宝复用蝦皮PDD关联.md new file mode 100644 index 0000000..b42c776 --- /dev/null +++ b/docs/task/183-顺运宝复用蝦皮PDD关联.md @@ -0,0 +1,52 @@ +# 183 Admin：顺运宝同步复用蝦皮商品已有 PDD 关联并明确展示 + +- 类型：需求 +- 父级大工单：#14 +- 所属 MVP / 版本：#15 Admin 四模块可用闭环 +- 状态：已完成 +- 日期：2026-08-12 +- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/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)