# TC-REQ-通用-006-预生产测试通道

> **版本**: v1.0 | **日期**: 2026-08-11 | **状态**: [待评审]
> **作者**: 宋献（测试） | **审核**: —
> **关联REQ**: REQ-通用-006
> **关联PRD**: `../../01-产品文档/00-产品规划/PRD-REQ-通用-006-预生产测试通道-v1.0.md`
> **关联技术方案**: `../../02-技术文档/技术方案-REQ-通用-006-预生产测试通道-v1.0.md`
> **测试环境**: 预生产（10.90.5.110 / itsupport.servyou.com.cn）

---

## 1. 测试范围

| 项 | 说明 |
|----|------|
| 在测功能 | 预生产测试通道：DEV_MODE mock 登录、nginx 内网闸门、前端测试登录入口 |
| 不在测 | 企微 OAuth 主登录（仅回归）、新生产 K8s 改造 |
| 前置条件 | 预生产 compose 注入 `DEV_MODE=true` 且后端已重启；nginx 闸门已生效 |

---

## 2. 测试用例

### 2.1 后端测试通道

| 用例ID | 场景 | 步骤 | 预期结果 |
|--------|------|------|----------|
| TC-001 | 内网 mock 登录（坐席角色） | 内网 `GET /api/dev/login?userid=dev-agent-001&name=李四&role=agent` | HTTP 200，`data.token` 非空 |
| TC-002 | 内网 mock 登录（管理员角色） | 内网 `GET /api/dev/login?userid=dev-admin-001&role=admin` | HTTP 200，token 有效 |
| TC-003 | 多角色登录 | 内网 `GET /api/dev/login?userid=dev-multi-001&role=user,agent,supervisor` | HTTP 200，roles 数组含三角色 |
| TC-004 | token 真实有效 | Redis 查询 `user:token:{hash}` | 存在，TTL≈8h |
| TC-005 | dev/users 列表 | 内网 `GET /api/dev/users` | HTTP 200，6 个预设用户 |
| TC-006 | dev/health 自检 | 内网 `GET /api/dev/health` | HTTP 200，`dev_mode: true` |
| TC-007 | 带 token 调业务接口 | 用 TC-001 token 调 `GET /api/auth/me`（带 Bearer） | HTTP 200，返回 userid=dev-agent-001 |

### 2.2 nginx 闸门（安全）

| 用例ID | 场景 | 步骤 | 预期结果 |
|--------|------|------|----------|
| TC-101 | 公网访问 dev 接口 | 公网 `GET /api/dev/health` | **HTTP 403** |
| TC-102 | 公网访问 dev/login | 公网 `GET /api/dev/login` | **HTTP 403** |
| TC-103 | 业务接口未误伤 | 公网 `GET /api/health` | HTTP 200 |
| TC-104 | 主登录未误伤 | 公网 `GET /api/auth/qrcode` | HTTP 200，返回 ticket |
| TC-105 | 静态页未误伤 | 公网 `GET /itagent/`、`/itadmin/` | HTTP 200 |

### 2.3 前端测试登录入口

| 用例ID | 场景 | 步骤 | 预期结果 |
|--------|------|------|----------|
| TC-201 | 内网坐席登录页显示测试入口 | 内网打开 `/itagent/` | 显示「测试账号登录」面板，角色下拉可选 |
| TC-202 | 内网一键登录坐席端 | 选 agent 角色 → 点击登录 | 进入坐席工作台，业务 API 正常 |
| TC-203 | 内网一键登录管理后台 | 内网打开 `/itadmin/`，选 admin 登录 | 进入管理后台 |
| TC-204 | 内网一键登录 H5 | 内网打开 H5 入口，选 user 登录 | 进入 H5 员工端 |
| TC-205 | 公网登录页无测试入口 | 公网打开三端登录页 | 不显示测试账号面板（health 探测 403） |

### 2.4 回归

| 用例ID | 场景 | 步骤 | 预期结果 |
|--------|------|------|----------|
| TC-301 | 企微扫码登录回归 | 企微内打开任意端 | OAuth 流程正常 |
| TC-302 | 登出清理 | 测试登录后调 `/api/auth/logout` | token 失效，Redis 黑名单生效 |

---

## 3. 缺陷单关联

| 缺陷编号 | 关联用例 | 状态 |
|----------|----------|------|
| （无） | — | — |

---

## 4. 变更记录

| 日期 | 版本 | 变更内容 | 变更人 | 变更原因 |
|------|------|----------|--------|----------|
| 2026-08-11 | v1.0 | 初版 | 宋献 | 预生产测试通道测试用例 |