cmautobuy/docs/task/134-商品目录导入记录.md

134 Admin：增加商品目录导入记录接口和管理页面

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

背景与目标

让第三方脚本能查询批次处理结果，让管理员能分页查看导入状态、计数和安全的失败 定位信息，不依赖短期日志排错。

最终方案

增加受相同 Bearer Token 保护的批次查询接口；增加仅管理员可访问的商品目录导入记录 页和详情弹窗。列表在数据库中按来源、状态筛选并分页，展示请求、冲突和各类写入 计数。详情只解析保存的安全错误摘要、错误码、可重试标记及数组定位，不显示请求 哈希、Token 或完整负载。

改了哪些

• admin/handler/integration/catalog_api.go：增加按批次号查询摘要。
• admin/repository/catalog_import.go、admin/service/catalog_history.go：数据库分页、筛选和页面视图。
• admin/handler/web/catalog.go、admin/templates/catalog/：管理员列表与详情。
• admin/templates/shopee/list.html、admin/templates/pdd/list.html：统一导入记录入口。

验收结果

验收标准	结果
第三方可查询成功、处理中或失败批次摘要	通过
管理员可分页筛选和查看详情，路由叠加管理员权限	通过
重放只更新同一记录的请求次数	通过
页面与接口不包含凭据、请求哈希或完整请求体	通过
1000 条记录使用数据库计数、筛选、排序和分页	通过
蝦皮和 PDD 页面进入同一记录页	通过

测试

• 执行的命令：$env:GOTOOLCHAIN="go1.23.0"; go build ./...; go test ./... -count=1; go vet ./...
• 结果：构建、全量测试和静态检查通过；页面真实路由渲染通过；1000 条隔离数据分页通过。
• 没验证到的部分：未在真实浏览器以 1366×768 人工检查页面视觉尺寸。

相关提交

• 3ac4467 feat: 增加商品目录导入记录 (#134)