49 lines
2.1 KiB
Markdown
49 lines
2.1 KiB
Markdown
# 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)
|