diff --git a/docs/task/135-蝦皮数据切换目录接口.md b/docs/task/135-蝦皮数据切换目录接口.md new file mode 100644 index 0000000..3d834db --- /dev/null +++ b/docs/task/135-蝦皮数据切换目录接口.md @@ -0,0 +1,48 @@ +# 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)