chengma/cmautobuy
2
0
Fork 0
Code Issues 89 Pull Requests Actions Packages Projects Releases Wiki Activity

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

New Issue
Closed
opened 2026-08-11 09:50:32 +08:00 by ila · 1 comment
ila commented 2026-08-11 09:50:32 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：重构（移除失效入口）
  • 父级大工单：#14
  • 所属 MVP / 版本：#15
  • 阶段：蝦皮数据来源切换
  • 依赖：#133、#134 联调验收通过
  • 状态：待验收

要解决什么

蝦皮页面现有 Excel 导入只支持固定“最佳表現商品”格式，面对当前不同来源文件已经无效。商品目录接口投入使用后继续保留按钮会误导采购员，并增加两套导入语义漂移风险。

做什么 / 不做什么

  • 做：移除蝦皮页 Excel 导入按钮和 /shopee/import 路由；删除 Shopee 专用上传/解析 handler、service 和测试；页面说明改为“数据由商品目录接口导入”并提供导入记录入口；清理只由 Shopee 导入使用的代码和文档。
  • 不做：不删除 PDD Excel 批量导入及其 excelize 依赖；不删除历史蝦皮数据；不改变列表、PDD 关联、采集、规格匹配和采购流程；不在接口联调完成前移除旧入口。

怎么做

  • 预计修改 admin/templates/shopee/、admin/handler/web/web.go、admin/handler/web/shopee.go、admin/handler/web/csrf.go、admin/service/shopee_import.go 及测试和 Admin UI/数据模型文档。
  • 先确认 #133、#134 在测试/生产配置下可用，再移除旧路由；旧 URL 返回 404 或明确 410 JSON/页面，不再接受文件。
  • 保留
    epository.UpsertShopeeProduct/SKU，它们由新目录接口复用；继续保护 PDD 人工关联、spec_raw 和 is_manual。

验收标准

  • 蝦皮页面不再显示 Excel 文件选择和导入按钮，显示接口数据来源及导入记录入口。
  • /shopee/import 不再处理上传，Shopee 专用上传临时文件不再生成。
  • PDD Excel 批量导入保持可用，excelize 不被误删。
  • 蝦皮列表、详情、PDD 关联、创建采集任务功能无回归。
  • 新目录接口仍复用安全 upsert，不覆盖人工 PDD 关联或规格原文。
  • 长期文档不再把固定蝦皮 Excel 作为当前主入口，历史归档不改写。

怎么验证

Go 1.23 build/test/vet；Web 路由和模板测试确认旧入口消失、新记录入口可达；PDD Excel 导入回归；浏览器人工检查蝦皮列表页。

风险和回退

只有 #133、#134 完成联调后才允许实施。若第三方脚本尚未稳定，保留旧版本部署作为短期应用回退，但不得让两套入口并行长期写入。

实施记录

  • 代码提交：0588ef1
  • 归档提交：7aa49c0
  • 归档：docs/task/135-蝦皮数据切换目录接口.md
  • Go 1.23 build/test/vet 全部通过；PDD Excel 回归通过；未部署生产。
## 基本信息 - 类型：重构（移除失效入口） - 父级大工单：#14 - 所属 MVP / 版本：#15 - 阶段：蝦皮数据来源切换 - 依赖：#133、#134 联调验收通过 - 状态：待验收 ## 要解决什么 蝦皮页面现有 Excel 导入只支持固定“最佳表現商品”格式，面对当前不同来源文件已经无效。商品目录接口投入使用后继续保留按钮会误导采购员，并增加两套导入语义漂移风险。 ## 做什么 / 不做什么 - 做：移除蝦皮页 Excel 导入按钮和 /shopee/import 路由；删除 Shopee 专用上传/解析 handler、service 和测试；页面说明改为“数据由商品目录接口导入”并提供导入记录入口；清理只由 Shopee 导入使用的代码和文档。 - 不做：不删除 PDD Excel 批量导入及其 excelize 依赖；不删除历史蝦皮数据；不改变列表、PDD 关联、采集、规格匹配和采购流程；不在接口联调完成前移除旧入口。 ## 怎么做 - 预计修改 admin/templates/shopee/、admin/handler/web/web.go、admin/handler/web/shopee.go、admin/handler/web/csrf.go、admin/service/shopee_import.go 及测试和 Admin UI/数据模型文档。 - 先确认 #133、#134 在测试/生产配置下可用，再移除旧路由；旧 URL 返回 404 或明确 410 JSON/页面，不再接受文件。 - 保留 epository.UpsertShopeeProduct/SKU，它们由新目录接口复用；继续保护 PDD 人工关联、spec_raw 和 is_manual。 ## 验收标准 - [x] 蝦皮页面不再显示 Excel 文件选择和导入按钮，显示接口数据来源及导入记录入口。 - [x] /shopee/import 不再处理上传，Shopee 专用上传临时文件不再生成。 - [x] PDD Excel 批量导入保持可用，excelize 不被误删。 - [x] 蝦皮列表、详情、PDD 关联、创建采集任务功能无回归。 - [x] 新目录接口仍复用安全 upsert，不覆盖人工 PDD 关联或规格原文。 - [x] 长期文档不再把固定蝦皮 Excel 作为当前主入口，历史归档不改写。 ## 怎么验证 Go 1.23 build/test/vet；Web 路由和模板测试确认旧入口消失、新记录入口可达；PDD Excel 导入回归；浏览器人工检查蝦皮列表页。 ## 风险和回退 只有 #133、#134 完成联调后才允许实施。若第三方脚本尚未稳定，保留旧版本部署作为短期应用回退，但不得让两套入口并行长期写入。 ## 实施记录 - 代码提交：0588ef1 - 归档提交：7aa49c0 - 归档：docs/task/135-蝦皮数据切换目录接口.md - Go 1.23 build/test/vet 全部通过；PDD Excel 回归通过；未部署生产。
ila commented 2026-08-12 10:31:44 +08:00
Author
Owner
Copy Link
Copy Source

用户于 2026-08-12 明确验收通过。已确认本地归档 docs/task/135-蝦皮数据切换目录接口.md 存在，现关闭工单。

用户于 2026-08-12 明确验收通过。已确认本地归档 `docs/task/135-蝦皮数据切换目录接口.md` 存在，现关闭工单。
ila closed this issue 2026-08-12 10:31:45 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: chengma/cmautobuy#135