feat(chat): 新增主站二维码池管理页

docs/Phase2-二维码池验收.md

@@ -0,0 +1,59 @@
+# Phase 2 验收报告（主站二维码池）
+
+> 日期：2026-10-30  
+> 项目：解忧商行（hfb_jysh）  
+> 范围：企业微信群二维码池的列表、统计、新增、编辑、单删与批删  
+> 结论：**页面与路由已落地，tsc/build 通过，只读接口回归 200；写操作未在验收中执行**
+
+---
+
+## 1. 页面与路由
+
+- 页面：`frontend/src/features/admin/AdminQrCodePoolPage.tsx`
+- 路由：`/console-jy8k3m/qrcode-pool`
+- 权限：查看 `qrcode:view`，增删改 `qrcode:manage`
+- 菜单：`frontend/src/layouts/AdminLayout.tsx` 客服组新增「二维码池」，`sectionMeta` 同步
+
+## 2. 接口
+
+| 方法 | 路径 | 说明 |
+|---|---|---|
+| GET | `/api/admin/chats/qrcodes` | 列表（`status`/`keyword`/`bound`/`expire_status`/`wecom_renamed`/`page`/`limit`） |
+| GET | `/api/admin/chats/qrcodes/stats` | 未使用 / 已使用 / 已停用 / 总数 |
+| POST | `/api/admin/chats/qrcodes` | 新增 |
+| PATCH | `/api/admin/chats/qrcodes/:id` | 编辑（群名、备注、状态、企微改名、过期时间） |
+| DELETE | `/api/admin/chats/qrcodes/:id` | 单条删除 |
+| POST | `/api/admin/chats/qrcodes/batch-delete` | 批量删除（最多 100） |
+
+> 注意：该组接口返回 `{ data: ... }` 结构（非 `code/message/data`），前端按 `{ data }` 解包，与其他后台接口不同。
+
+## 3. 能力
+
+- 顶部四项统计直接来自 `stats` 接口。
+- 筛选：关键字（群名/备注）、状态、绑定情况、过期状态、企微改名。
+- 列表：二维码缩略图、群名与备注、状态与「企微已改名」标签、绑定会话、发放/创建时间、过期时间。
+- 新增：上传图片（`POST /api/files/upload`，scene `qrcode`）、群名称、备注、过期时间（留空后端默认 7 天）。
+- 编辑：群名称、备注、状态、企微改名开关、过期时间；清空时间时提交 `clear_expires_at: true`。
+- 批量删除：勾选后二次确认，调用 `batch-delete` 并提示实际删除数量。
+
+## 4. 回归结果
+
+```text
+前端 http://localhost:5289
+后端 http://127.0.0.1:18089
+Cookie /tmp/jysh-admin-cookie2.txt
+```
+
+| 检查项 | 状态 |
+|---|---|
+| `GET /console-jy8k3m/qrcode-pool` | 200 |
+| `GET /api/admin/chats/qrcodes?page=1&limit=5` | 200 |
+| `GET /api/admin/chats/qrcodes/stats` | 200 |
+
+`npx tsc --noEmit` 通过；`npm run build` 通过，主入口 `499.16 kB` / gzip `157.08 kB`（接近 500 kB 阈值，后续新增页面需关注拆包）。
+
+## 5. 未覆盖
+
+- 上传、新增、编辑、删除与批删未执行真实写操作（开发库二维码池为空）。
+- OCR 识别群名（`/chats/qrcodes/ocr-group-name`）依赖 PaddleOCR Token，未接入页面。
+- 未实现「批量添加」（`/chats/qrcodes/batch`）的多图批量录入界面。

docs/项目计划.md

@@ -414,7 +414,7 @@ hfb_jysh/
   - 已落地：`/wallet`（余额 + 流水）、`/wallet/payment-accounts`、`/wallet/withdrawal`、移动端 `/m/wallet/withdrawal`、卖家 `/seller/earnings`、`/seller/handoffs`、`/seller/pickups`。
 - 申诉仲裁、手工订单、提号、客服群、快捷回复。
   - 已落地：客服群组（`/chat-support-groups`，权限 `chat:manage`），角色权限矩阵（`/roles`，权限 `role:manage`），手工录单（`/manual-entries`，权限 `cs_manual_entry:*`），快捷回复（`/chat-quick-replies`，权限 `chat:view` / `chat:send`），线下提号（`/pickup`、`/pickup/:id`，权限 `order:pickup`，口径统一为「线下提号」）。
-  - 待落地：主站二维码池 `/qrcode-pool`、自动欢迎与商品群欢迎配置。
+  - 待落地：自动欢迎与商品群欢迎配置、二维码池 OCR 与批量导入。
 - 分销站点、规则、订单、结算、二维码池、分销用户、公告。
 - 公告、邀请返利、推送、追踪链接。
   - 已落地：公告管理、邀请返利、推广追踪（`/tracking-links`，权限 `ad_tracking:manage`）。