From 34839eae33c0afdbe7afbd7a5debf631e2471dc8 Mon Sep 17 00:00:00 2001
From: QiuSW <105186638@qq.com>
Date: Fri, 11 Sep 2026 15:59:13 +0800
Subject: [PATCH] docs: add local tickets for huohanhan integration

---
 tickets/LOCAL-002-huohanhan-contract.md | 24 +++++++++++++++++++++
 tickets/LOCAL-003-huohanhan-client.md   | 28 +++++++++++++++++++++++++
 2 files changed, 52 insertions(+)
 create mode 100644 tickets/LOCAL-002-huohanhan-contract.md
 create mode 100644 tickets/LOCAL-003-huohanhan-client.md

diff --git a/tickets/LOCAL-002-huohanhan-contract.md b/tickets/LOCAL-002-huohanhan-contract.md
new file mode 100644
index 0000000..1fef4af
--- /dev/null
+++ b/tickets/LOCAL-002-huohanhan-contract.md
@@ -0,0 +1,24 @@
+# 工单：货憨憨接口契约确认
+
+- 编号：LOCAL-002
+- 状态：待验收
+- 来源：用户需求（2026-09-11）
+
+## 目标
+确认并固化货憨憨登录、认证态和 Shopee 商品查询接口契约，作为 GoAdmin 接入依据。
+
+## 已确认
+- cmsp 已实现货憨憨登录和商品查询；
+- 商品分页接口为 `/api/product/shop/getPage`；
+- 商品 ID 查询使用 `itemIds` 参数；
+- 查询流程只读。
+
+## 待验证
+- 登录接口请求和响应字段；
+- 验证码交互与失败分类；
+- Token/Cookie 有效期和失效响应；
+- 在线商品与待发布商品的状态参数；
+- 单商品详情接口是否存在。
+
+## 验收
+形成脱敏接口契约文档和最小模拟响应测试，不记录账号、密码、Cookie 或 Token。
diff --git a/tickets/LOCAL-003-huohanhan-client.md b/tickets/LOCAL-003-huohanhan-client.md
new file mode 100644
index 0000000..b531dbc
--- /dev/null
+++ b/tickets/LOCAL-003-huohanhan-client.md
@@ -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 契约确认后完成。