# 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)