cmautobuy/docs/task/135-蝦皮数据切换目录接口.md

135 Admin：移除蝦皮 Excel 导入并切换到目录接口

• 类型：重构
• 父级大工单：#14
• 所属 MVP / 版本：#15 / 商品目录批量接入
• 状态：已完成
• 日期：2026-08-11
• Gitea 工单：#135

背景与目标

固定“最佳表現商品”格式的蝦皮 Excel 上传已无法适配当前不同来源文件。在商品目录 接口和导入记录完成后，移除误导入口和重复解析逻辑，统一数据写入语义。

最终方案

删除蝦皮 Excel 按钮、POST 路由、上传临时文件处理、解析服务及专用测试。蝦皮空页 明确提示由第三方商品目录接口导入，管理员可进入统一导入记录页。PDD 一列式 Excel 批量导入完全保留，因此 excelize v2.9.1 依赖继续保留。长期文档改为当前目录接口 流程，历史任务归档不改写。

改了哪些

• admin/handler/web/、admin/templates/shopee/list.html：移除上传入口和路由。
• 删除 admin/service/shopee_import.go 及专用测试。
• admin/main_test.go：断言旧 URL 为 404、模板无文件上传且有目录记录入口。
• admin/AGENTS.md、docs/admin/：基线切换为商品目录接口，PDD Excel 规则保留。

验收结果

验收标准	结果
蝦皮页无 Excel 文件选择，显示目录接口来源和记录入口	通过
/shopee/import 不再处理上传并返回 404	通过
PDD Excel 与 excelize 依赖保留	通过
蝦皮列表、详情、关联和采集回归通过	通过
目录接口安全 upsert 回归通过	通过
长期文档不再把蝦皮 Excel 作为当前入口	通过

测试

• 执行的命令：go mod tidy；$env:GOTOOLCHAIN="go1.23.0"; go build ./...; go test ./... -count=1; go vet ./...
• 结果：依赖整理未移除 excelize；构建、全量测试和静态检查通过，PDD Excel 测试继续通过。
• 没验证到的部分：未在浏览器人工检查蝦皮页面视觉布局；未部署生产环境。

相关提交

• 0588ef1 refactor: 切换蝦皮数据到目录接口 (#135)