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

- 类型：重构
- 父级大工单：#14
- 所属 MVP / 版本：#15 / 商品目录批量接入
- 状态：已完成
- 日期：2026-08-11
- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/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)