Admin：建立顺运宝采购处理状态并识别蝦皮 SKU #67

New Issue

2026-08-09T22:21:12+08:00

ila commented

2026-08-09 22:21:12 +08:00

基本信息

类型：需求
父级大工单：#14
所属 MVP / 版本：#15 Admin 四模块可用闭环
阶段：顺运宝驱动采购闭环
状态：待验收

要解决什么

顺运宝同步已经保存商品明细和蝦皮商品 ID，但当前“已匹配/待匹配”只看 shopee_sku_id，无法区分未找到蝦皮商品、待确认蝦皮 SKU、未关联 PDD、待采集、待做 PDD 规格映射和可采购等阶段。采购员不知道每行下一步应该做什么。

做什么 / 不做什么

做

顺运宝明细按商品 ID 查询蝦皮商品及其 SKU。
规格原文完全一致或颜色尺码唯一一致时自动确认蝦皮 SKU；零候选或多候选不猜测。
提供明确的手动选择蝦皮 SKU 能力，报表缺少规格时允许使用既有手动新增入口补齐后再选择。
列表显示计算得到的处理阶段、说明和唯一“下一步”。
增加处理阶段筛选并保留分页、关键词。
同步更新不得覆盖已经确认的 shopee_sku_id。

不做

不关联 PDD 链接、不创建采集任务（由后续工单实现）。
不保存 PDD 规格映射、不创建采购任务。
不做模糊猜测或自动下单。

怎么做

Repository 用共享 JOIN/筛选查询取得蝦皮商品、SKU、当前 PDD 和采集状态等只读上下文。
Service 将顺运宝行计算为显式阶段；自动识别只接受唯一、确定候选。
Handler 提供详情片段和保存蝦皮 SKU 的 POST 路由，写操作带 CSRF。
模板增加处理阶段、下一步按钮和详情弹窗；服务端渲染，原生 JS 仅复用现有弹窗加载机制。
更新需求、数据/UI 规范和测试，不修改数据库结构。

预计修改：repository/syb.go、repository/shopee.go、service/syb.go、handler/web/others.go、路由、顺运宝模板、公共 JS/CSS、对应测试和 Admin 文档。

验收标准

唯一精确候选能自动识别蝦皮 SKU，零候选或多候选不会自动写入。
手动选择只允许选择当前蝦皮商品下的 SKU。
顺运宝列表不再把“有 shopee_sku_id”误称为完整 PDD 规格已匹配。
处理阶段和下一步有文字，不只靠颜色。
阶段筛选保留关键词和分页，非法页码行为保持一致。
顺运宝再次同步不覆盖人工/自动确认的 SKU。
不修改数据库和 Client 四接口。
Go 1.23.0 build、test、vet 通过。

怎么验证

从 admin/ 执行 GOTOOLCHAIN=go1.23.0 go build ./...、go test ./... -count=1、go vet ./...，并覆盖唯一候选、无候选、多候选、越权选择和重同步保留结果测试。

风险和回退

自动识别错误会把订单导向错误规格，因此仅允许原文精确匹配或解析后颜色尺码的唯一精确匹配；不确定时必须人工确认。回退本工单恢复旧列表，不涉及数据迁移。

## 基本信息 - 类型：需求 - 父级大工单：#14 - 所属 MVP / 版本：#15 Admin 四模块可用闭环 - 阶段：顺运宝驱动采购闭环 - 状态：待验收 ## 要解决什么顺运宝同步已经保存商品明细和蝦皮商品 ID，但当前“已匹配/待匹配”只看 `shopee_sku_id`，无法区分未找到蝦皮商品、待确认蝦皮 SKU、未关联 PDD、待采集、待做 PDD 规格映射和可采购等阶段。采购员不知道每行下一步应该做什么。 ## 做什么 / 不做什么 ### 做 - 顺运宝明细按商品 ID 查询蝦皮商品及其 SKU。 - 规格原文完全一致或颜色尺码唯一一致时自动确认蝦皮 SKU；零候选或多候选不猜测。 - 提供明确的手动选择蝦皮 SKU 能力，报表缺少规格时允许使用既有手动新增入口补齐后再选择。 - 列表显示计算得到的处理阶段、说明和唯一“下一步”。 - 增加处理阶段筛选并保留分页、关键词。 - 同步更新不得覆盖已经确认的 `shopee_sku_id`。 ### 不做 - 不关联 PDD 链接、不创建采集任务（由后续工单实现）。 - 不保存 PDD 规格映射、不创建采购任务。 - 不做模糊猜测或自动下单。 ## 怎么做 - Repository 用共享 JOIN/筛选查询取得蝦皮商品、SKU、当前 PDD 和采集状态等只读上下文。 - Service 将顺运宝行计算为显式阶段；自动识别只接受唯一、确定候选。 - Handler 提供详情片段和保存蝦皮 SKU 的 POST 路由，写操作带 CSRF。 - 模板增加处理阶段、下一步按钮和详情弹窗；服务端渲染，原生 JS 仅复用现有弹窗加载机制。 - 更新需求、数据/UI 规范和测试，不修改数据库结构。预计修改：`repository/syb.go`、`repository/shopee.go`、`service/syb.go`、`handler/web/others.go`、路由、顺运宝模板、公共 JS/CSS、对应测试和 Admin 文档。 ## 验收标准 - [x] 唯一精确候选能自动识别蝦皮 SKU，零候选或多候选不会自动写入。 - [x] 手动选择只允许选择当前蝦皮商品下的 SKU。 - [x] 顺运宝列表不再把“有 shopee_sku_id”误称为完整 PDD 规格已匹配。 - [x] 处理阶段和下一步有文字，不只靠颜色。 - [x] 阶段筛选保留关键词和分页，非法页码行为保持一致。 - [x] 顺运宝再次同步不覆盖人工/自动确认的 SKU。 - [x] 不修改数据库和 Client 四接口。 - [x] Go 1.23.0 build、test、vet 通过。 ## 怎么验证从 `admin/` 执行 `GOTOOLCHAIN=go1.23.0 go build ./...`、`go test ./... -count=1`、`go vet ./...`，并覆盖唯一候选、无候选、多候选、越权选择和重同步保留结果测试。 ## 风险和回退自动识别错误会把订单导向错误规格，因此仅允许原文精确匹配或解析后颜色尺码的唯一精确匹配；不确定时必须人工确认。回退本工单恢复旧列表，不涉及数据迁移。

ila referenced this issue

2026-08-09 22:22:30 +08:00

[Epic] Admin 采集采购管理端 #14

ila referenced this issue

2026-08-09 22:22:30 +08:00

[MVP] Admin 四模块可用闭环 #15

ila commented

2026-08-09 22:22:31 +08:00

已开始实施第一阶段。先建立安全的蝦皮 SKU 识别与顺运宝处理状态骨架；自动识别只接受唯一精确候选，不触碰 PDD 映射、采购任务或真实下单。工作区原有 Client、图片和根目录改动不纳入提交。

ila commented

2026-08-09 22:34:56 +08:00

实现完成，已进入待验收。

实现提交：c6ef54d、57a6484
归档提交：eb0e296
归档文档：docs/task/67-admin顺运宝采购处理状态.md
验证：Go 1.23.0 go build ./...、go test ./... -count=1、go vet ./...，以及 node --check static/js/app.js、git diff --check 均通过。
未验证：真实顺运宝商业数据同步及真实浏览器视觉检查。

按项目流程保持工单开启，等待用户验收；父工单清单暂不勾选。

实现完成，已进入待验收。 - 实现提交：`c6ef54d`、`57a6484` - 归档提交：`eb0e296` - 归档文档：`docs/task/67-admin顺运宝采购处理状态.md` - 验证：Go 1.23.0 `go build ./...`、`go test ./... -count=1`、`go vet ./...`，以及 `node --check static/js/app.js`、`git diff --check` 均通过。 - 未验证：真实顺运宝商业数据同步及真实浏览器视觉检查。按项目流程保持工单开启，等待用户验收；父工单清单暂不勾选。

ila referenced this issue

2026-08-10 11:04:41 +08:00

Admin：顺运宝主链路重构——规格映射改键，蝦皮报表降级为参考数据 #88

ila referenced this issue

2026-08-10 11:07:41 +08:00

Admin：顺运宝主链路重构——规格映射改键，蝦皮报表降级为参考数据 #88

ila referenced this issue

2026-08-10 11:23:23 +08:00

Admin：顺运宝主链路重构——规格映射改键，蝦皮报表降级为参考数据 #88

ila commented

2026-08-10 23:22:31 +08:00