docs: 归档任务 #134

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

@@ -0,0 +1,48 @@
+# 134 Admin：增加商品目录导入记录接口和管理页面
+
+- 类型：需求
+- 父级大工单：#14
+- 所属 MVP / 版本：#15 / 商品目录批量接入
+- 状态：已完成
+- 日期：2026-08-11
+- Gitea 工单：http://ilaer.eicp.net:8418/chengma/cmautobuy/issues/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)