cmautobuy/docs/task/211-独立店铺管理模块.md

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

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