cmautobuy/docs/task/210-蝦皮商品关联全局店铺.md

210 Admin：蝦皮商品关联全局店铺并支持待关联筛选

• 类型：需求
• 父级大工单：#206
• 所属 MVP / 版本：#207
• 状态：已完成
• 日期：2026-08-13
• Gitea 工单：#210

背景与目标

蝦皮商品只有上游店铺原文，无法稳定指向 Admin 中的业务店铺，也无法集中找出未识别的数据。

最终方案

商品目录和 SYB 补建商品时按蝦皮渠道名称精确解析 shop_id，原始 shopee_shop_name 及字段来源保护保持不变。列表新增“业务店铺”列、具体店铺筛选和“待关联”筛选，翻页、详情和写操作继续保留筛选参数；停用店铺仍可筛选历史商品。

改了哪些

• admin/repository/catalog_import.go、admin/repository/shopee.go：写入关联及统一筛选。
• admin/service/shopee_list.go、admin/handler/web/shopee.go：列表视图和参数透传。
• admin/templates/shopee/list.html、admin/static/js/app.js：业务店铺列、筛选和模块状态。
• admin/service/catalog_import_test.go：更新商品目录测试结构。

验收结果

验收标准	结果
精确别名可关联 shop_id	通过
无别名或空店铺名保持待关联	通过
店铺筛选和待关联筛选分页计数一致	通过（列表与计数共用筛选条件）
原始店铺名和字段来源保护不变	通过

测试

• 执行的命令：在 admin/ 执行 go test ./...、go build ./...
• 结果：Go 1.23.0 全部通过。
• 没验证到的部分：未在生产商品目录接口导入真实批次。

相关提交

• 8f70772 建立全局店铺跨渠道管理