cmautobuy/docs/task/182-蝦皮列表店铺名称搜索.md

182 Admin：蝦皮列表增加店铺名称搜索并收紧搜索框宽度

• 类型：需求
• 父级大工单：#14
• 所属 MVP / 版本：#15 Admin 四模块可用闭环
• 状态：已完成
• 日期：2026-08-12
• Gitea 工单：#182

背景与目标

蝦皮列表原来只能筛选“有店铺 / 无店铺”，不能按具体店铺名称搜索；商品搜索框还会占用过多工具栏空间。本任务增加店铺名称模糊搜索，并把商品、店铺两个搜索框统一为 20% 弹性基础宽度。

最终方案

• 保留现有店铺三态筛选，新增独立 shop_name 模糊搜索条件。
• 商品搜索继续兼容 ID 或名称，页面标签改为“商品 ID / 名称”。
• 两个输入框使用蝦皮页面专用 CSS，各占 20% 弹性基础宽度并继承 160px 最小宽度；不修改其他模块的共用搜索框。
• 列表与统计复用同一参数化 SQL 条件，并对 %、_、! 做 LIKE 转义。
• 分页、详情弹窗、写操作返回及模块切换状态均保留 shop_name。

改了哪些

• admin/repository/shopee.go：增加店铺名称筛选字段和参数化模糊查询。
• admin/service/shopee_list.go：把店铺名称纳入筛选状态判断。
• admin/handler/web/shopee.go：传递并保留 shop_name。
• admin/templates/shopee/：增加店铺名称输入和隐藏状态字段。
• admin/static/css/app.css：增加蝦皮页面专用 20% 输入框样式。
• admin/static/js/app.js：允许模块状态保存 shop_name。
• Admin 相关测试及 docs/admin/05-ui-specification.md：补充行为验证和界面规范。

验收结果

验收标准	结果
两个搜索框有可见标签且基础宽度均为 20%	通过
窄窗口保留最小宽度并自然换行	通过（CSS 规则检查）
店铺名称包含匹配并正确处理 LIKE 特殊字符	通过
可与现有条件组合，列表和统计一致	通过
分页、详情、写操作返回和模块切换保留条件	通过
其他模块搜索框不受影响	通过
固定 Go 1.23.0 验证通过	通过

测试

• 执行的命令：GOTOOLCHAIN=go1.23.0 go vet ./...、go build ./...、go test ./... -count=1
• 结果：Admin 全部包通过；新增店铺组合筛选、LIKE 转义、跳转参数和模块白名单测试通过。
• 没验证到的部分：没有启动浏览器进行 1366×768 人工视觉验收。

相关提交

• 889f568 feat: 增加蝦皮店铺名称搜索 (#182)