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

- 类型：需求
- 父级大工单：#206
- 所属 MVP / 版本：#207
- 状态：已完成
- 日期：2026-08-13
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/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` 建立全局店铺跨渠道管理