# 211 Admin：新增独立店铺管理模块

- 类型：需求
- 父级大工单：#206
- 所属 MVP / 版本：#207
- 状态：已完成
- 日期：2026-08-13
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/211

## 背景与目标

店铺配置原来藏在 SYB 页面，蝦皮等模块无法共同使用。目标是提供管理员专用的独立店铺管理入口。

## 最终方案

新增 `/shops` 管理路由、服务和页面，一行维护业务店铺、SYB 名称、蝦皮名称、全局状态与 SYB 同步状态。所有写操作使用 POST、CSRF 和管理员中间件；删除只允许全局停用且无业务引用的店铺。旧 `/syb/shops` 重定向到新模块，SYB 页面仅保留摘要入口。

## 改了哪些

- `admin/handler/web/shop.go`、`admin/service/shop.go`：管理员管理流程。
- `admin/templates/shop/list.html`：独立管理页。
- `admin/handler/web/web.go`、`admin/templates/partials/header.html`：路由和导航。
- `admin/templates/syb/list.html`：同步摘要链接。
- `admin/main_test.go`、`admin/service/shop_test.go`：权限、状态区分、删除和导航测试。
- `docs/admin/05-ui-specification.md`：记录最终页面职责。

## 验收结果

| 验收标准 | 结果 |
|---|---|
| 管理员可进入并维护店铺及别名 | 通过 |
| 采购员不能访问写接口 | 通过 |
| 页面明确区分店铺启用和 SYB 同步启用 | 通过 |
| 原 SYB 页面只显示摘要并链接新模块 | 通过 |
| 导航和模块状态测试通过 | 通过 |

## 测试

- 执行的命令：在 `admin/` 执行 `go test ./...`、`go build ./...`、`git diff --check`
- 结果：Go 1.23.0 全部通过。
- **没验证到的部分**：尚未在 1366×768 浏览器中进行人工视觉验收。

## 相关提交

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