test-cases-v1.0.0.md 5.0 KB
DoTouch.AI 端到端测试用例 v1.0.0
执行日期：2026-08-08 环境：本地（docker postgres/redis + mock 上游 :19090 + API :8080） 测试账号：
test-e2e@dotouch.ai/Test1234（余额 $100.00 · role=admin） 凭据文件：/tmp/dotouch-test-creds.json（含 API Key 与 JWT） 目标：完整走通「注册 → 登录 → Key → 充值 → 调用 → 计量 → 管理」全链路
测试环境
| 组件 | 地址 | 状态 |
|---|---|---|
| PostgreSQL | localhost:5432 | ✅ 运行中 |
| Redis | localhost:6379 | ✅ 运行中 |
| Mock 上游（模拟百炼） | localhost:19090 | ✅ 运行中（scripts/mock-upstream.mjs） |
| API | localhost:8080（/v1） | ✅ 运行中（DASHSCOPE_BASE_URL 指向 mock） |
约定
- 每条用例记录：执行结果（PASS/FAIL）+ 关键响应内容
- 顺序执行，TC-01~02 为前置（已有账号时可直接跳过验证）
- 依赖 curl / python3；验证码从
/tmp/dotouch-api.log的[EMAIL]行读取（8 位大写字母数字）
TC-01 注册流程（验证码绑定）
| 步骤 | 操作 | 预期 |
|---|---|---|
| 1.1 | POST /v1/auth/send-code {email: new-user@test.ai, purpose: register} | 201 |
| 1.2 | 从 API 日志读取 8 位验证码 | 格式 [A-Z0-9]{8} |
| 1.3 | POST /v1/auth/register {email, password: Test1234, code: 错误码} | 400 验证码错误 |
| 1.4 | POST /v1/auth/register {正确验证码} | 201 注册成功 |
| 1.5 | 同一邮箱重复注册 | 409 已注册 |
TC-02 登录与安全
| 步骤 | 操作 | 预期 |
|---|---|---|
| 2.1 | 正确密码登录 | 200 + accessToken |
| 2.2 | 错误密码 ×5 | 401 ×5 |
| 2.3 | 第 6 次错误密码 | 429 登录限流（15 分钟） |
| 2.4 | 清 Redis 后正确密码 | 200 |
| 2.5 | GET /v1/auth/me（带 JWT） | 200，含 email/role=admin |
TC-03 API Key 全生命周期
| 步骤 | 操作 | 预期 |
|---|---|---|
| 3.1 | POST /v1/keys {name} | 201，返回完整 dt_ Key（仅一次） |
| 3.2 | GET /v1/keys | 200，Key 脱敏（仅 prefix） |
| 3.3 | POST /v1/keys/:id/rotate | 201，返回新 Key |
| 3.4 | 旧 Key 调 POST /v1/chat/completions（带 Bearer） | 401 无效 Key（⚠️ 须用需认证的网关接口，/v1/models 为公开接口） |
| 3.5 | 新 Key 调 /v1/chat/completions | 200（证明轮换生效） |
| 3.6 | DELETE /v1/keys/:id | 撤销成功 |
| 3.7 | 已撤销 Key 调 POST /v1/chat/completions | 401（⚠️ 同上，用网关接口验证） |
TC-04 钱包与充值
| 步骤 | 操作 | 预期 |
|---|---|---|
| 4.1 | GET /v1/wallet（JWT） | 200，balanceCents=10000，含流水 |
| 4.2 | dev-credit +$10（+1000 cents） | 余额 11000 |
| 4.3 | GET /v1/wallet | 200，余额 11000，流水 +1 条 deposit |
TC-05 模型目录（236 全量）
| 步骤 | 操作 | 预期 |
|---|---|---|
| 5.1 | GET /v1/models（无认证） | 200，≥236 个模型 |
| 5.2 | 抽查 glm-5.2 / deepseek-v4 定价元数据 | 含 input/output 价格 |
| 5.3 | 未认证调 /v1/chat/completions | 401 invalid_api_key |
TC-06 OpenAI 兼容网关（mock 上游）
| 步骤 | 操作 | 预期 |
|---|---|---|
| 6.1 | POST /v1/chat/completions {model: glm-5.2, messages, Bearer dt_ Key} | 200 OpenAI 格式响应 |
| 6.2 | 响应含 usage（prompt/completion tokens） | 有 usage 字段 |
| 6.3 | stream: true | SSE 流式响应（data: 块 + [DONE]） |
| 6.4 | 未知模型 {model: no-such-model} | 404 model_not_found |
| 6.5 | 无效 Key | 401 |
| 6.6 | GET /v1/wallet | 余额按 usage 扣减（>0） |
TC-07 用量计量
| 步骤 | 操作 | 预期 |
|---|---|---|
| 7.1 | GET /v1/usage（JWT） | 200，含 6.1/6.3 的请求记录 |
| 7.2 | GET /v1/usage/summary | 200，按日聚合，totalTokens>0 |
| 7.3 | 记录中 costCents 与钱包扣减一致 | 一致 |
TC-08 密码重置
| 步骤 | 操作 | 预期 |
|---|---|---|
| 8.1 | POST /v1/auth/forgot {email} | 200（不泄露存在性） |
| 8.2 | 日志读重置验证码 | 8 位 |
| 8.3 | POST /v1/auth/reset {email, code, newPassword: NewPass567} | 201 重置成功 |
| 8.4 | 旧密码登录 | 401 |
| 8.5 | 新密码登录 | 200 |
| 8.6 | 重置回 Test1234（复用 8.1-8.3 流程） | 201，恢复原密码 |
TC-09 管理后台（admin）
| 步骤 | 操作 | 预期 |
|---|---|---|
| 9.1 | GET /v1/admin/stats（admin JWT） | 200，users/totalRevenueCents/totalTokens |
| 9.2 | GET /v1/admin/users?q=test-e2e | 200，含该用户 |
| 9.3 | PUT /v1/admin/models/glm-5.2 {inputPriceCents: 99, outputPriceCents: 309} | 200 |
| 9.4 | GET /v1/models → glm-5.2 价格更新 | 99/309 生效 |
| 9.5 | 普通用户 JWT 调 /v1/admin/stats | 403 拒绝 |
| 9.6 | POST /v1/admin/models/sync | 501 占位 |
TC-10 网关安全（限流/错误格式）
| 步骤 | 操作 | 预期 |
|---|---|---|
| 10.1 | 连续 61 次请求（超 60 req/min） | 第 61 次 429 |
| 10.2 | 错误响应体为 OpenAI 格式 {error:{message,type,code}} | 格式正确 |
交付物
- 每条用例 PASS/FAIL + 证据（响应摘要）
- 失败项：根因分析 + 建议修复
- 最终走查报告（面向用户）