docs: add local tickets for huohanhan integration

This commit is contained in:
QiuSW
2026-09-11 15:59:13 +08:00
parent fb72ea9b12
commit 34839eae33
2 changed files with 52 additions and 0 deletions
+24
View File
@@ -0,0 +1,24 @@
# 工单:货憨憨接口契约确认
- 编号:LOCAL-002
- 状态:待验收
- 来源:用户需求(2026-09-11)
## 目标
确认并固化货憨憨登录、认证态和 Shopee 商品查询接口契约,作为 GoAdmin 接入依据。
## 已确认
- cmsp 已实现货憨憨登录和商品查询;
- 商品分页接口为 `/api/product/shop/getPage`;
- 商品 ID 查询使用 `itemIds` 参数;
- 查询流程只读。
## 待验证
- 登录接口请求和响应字段;
- 验证码交互与失败分类;
- Token/Cookie 有效期和失效响应;
- 在线商品与待发布商品的状态参数;
- 单商品详情接口是否存在。
## 验收
形成脱敏接口契约文档和最小模拟响应测试,不记录账号、密码、Cookie 或 Token。
+28
View File
@@ -0,0 +1,28 @@
# 工单:迁移 huohanhan 客户端到 GoAdmin
- 编号:LOCAL-003
- 状态:进行中
- 来源:用户需求(2026-09-11)
- 依赖:LOCAL-002
## 目标
将 `D:\chengma\cmsp\internal\huohanhan` 的登录、验证码、认证态复用和商品查询能力适配到 GoAdmin。
## 范围
- 提取或迁移 huohanhan 客户端;
- 将 cmsp SQLite Store 认证态适配为 GoAdmin 使用的持久化方式;
- 保留登录失效检测、一次重试和敏感信息日志规则;
- 替换 GoAdmin 当前临时的环境变量 Authorization 调用。
## 非目标
不迁移淘宝、视频下载、素材上传和商品写操作。
## 验收
- 无需每次验证码登录即可复用有效认证态;
- 认证失效时按 cmsp 规则处理;
- 商品查询接口通过客户端调用;
- 单元测试覆盖成功、失效、超时和返回格式错误;
- `go test ./...` 通过。
## 实施记录
当前 GoAdmin 已有查询 API 和落库模型;客户端正式迁移待 LOCAL-002 契约确认后完成。