156 lines
4.9 KiB
Markdown
156 lines
4.9 KiB
Markdown
# Soul 创业派对 - 功能测试流程
|
||
|
||
> 测试工程师产出。按流程执行，成功项打 ☑️，失败项列出问题，最后输出报告。
|
||
|
||
---
|
||
|
||
## 一、测试流程总览
|
||
|
||
```
|
||
环境准备 → 自动化用例执行 → 手工功能验证 → 问题汇总 → 输出报告
|
||
```
|
||
|
||
---
|
||
|
||
## 二、环境准备
|
||
|
||
| 步骤 | 内容 | 结果 |
|
||
|------|------|------|
|
||
| 1 | soul-api 已启动（local 时）或测试服已部署 | ☐ / 问题：_____ |
|
||
| 2 | 配置 `.env.test`（SOUL_TEST_ENV 或 SOUL_API_BASE） | ☐ / 问题：_____ |
|
||
| 3 | 管理端可访问，默认账号 admin/admin123 可登录 | ☐ / 问题：_____ |
|
||
| 4 | 小程序可访问（真机或开发者工具） | ☐ / 问题：_____ |
|
||
|
||
**环境信息记录**：
|
||
- 执行日期：__________
|
||
- 测试环境：local / souldev / soulapi
|
||
- API 地址：__________
|
||
|
||
---
|
||
|
||
## 三、自动化用例执行
|
||
|
||
在 `scripts/test` 下执行：
|
||
|
||
```bash
|
||
cd scripts/test
|
||
$env:SOUL_TEST_ENV="local" # 或 souldev
|
||
pytest -v
|
||
```
|
||
|
||
### 3.1 小程序接口（miniapp）
|
||
|
||
| 用例 | 验证点 | 结果 | 问题（若失败） |
|
||
|------|--------|------|----------------|
|
||
| test_config_public | GET /api/miniprogram/config 返回 prices、features、mpConfig | ☐ | |
|
||
| test_dev_login_as | POST /api/miniprogram/dev/login-as 按 userId 登录 | ☐ | |
|
||
|
||
### 3.2 管理端接口（web）
|
||
|
||
| 用例 | 验证点 | 结果 | 问题（若失败） |
|
||
|------|--------|------|----------------|
|
||
| test_admin_login | POST /api/admin 登录成功 | ☐ | |
|
||
| test_admin_check_with_token | GET /api/admin 带 token 鉴权通过 | ☐ | |
|
||
| test_admin_check_without_token | GET /api/admin 无 token 返回 401 | ☐ | |
|
||
|
||
### 3.3 流程测试（process）
|
||
|
||
| 用例 | 验证点 | 结果 | 问题（若失败） |
|
||
|------|--------|------|----------------|
|
||
| test_health | GET /health 返回 200 | ☐ | |
|
||
| test_person_ensure_* | @某人 创建 Person + 存客宝计划 | ☐ | |
|
||
| test_article_mention_* | 文章保存自动创建 Person | ☐ | |
|
||
| test_backfill_persons_ckb_api_key | 从存客宝补齐 ckb_api_key | ☐ | |
|
||
|
||
---
|
||
|
||
## 四、手工功能验证
|
||
|
||
### 4.1 小程序端
|
||
|
||
| 场景 | 验证点 | 结果 | 问题（若失败） |
|
||
|------|--------|------|----------------|
|
||
| 登录 | 微信登录、手机号授权、token 持久化 | ☐ | |
|
||
| 首页 | 书籍列表、搜索栏（searchEnabled 控制） | ☐ | |
|
||
| 目录 | 章节列表、购买状态展示 | ☐ | |
|
||
| 阅读 | 阅读页、购买章节/全书、支付流程 | ☐ | |
|
||
| 我的 | 找伙伴、推广、搜索入口（featureConfig 控制） | ☐ | |
|
||
| VIP | 开通、资料填写、头像上传、保存 | ☐ | |
|
||
| 推荐 | 扫码/分享带 ref、绑定、分润展示 | ☐ | |
|
||
|
||
### 4.2 管理端
|
||
|
||
| 场景 | 验证点 | 结果 | 问题（若失败） |
|
||
|------|--------|------|----------------|
|
||
| 登录 | 账号密码登录、token 持久化 | ☐ | |
|
||
| 仪表盘 | 数据统计展示 | ☐ | |
|
||
| 用户管理 | 列表、搜索、分页、详情、行为轨迹 Tab | ☐ | |
|
||
| 订单管理 | 列表、状态、筛选 | ☐ | |
|
||
| 内容管理 | 书籍/章节 CRUD | ☐ | |
|
||
| 提现 | 申请列表、审核、状态流转 | ☐ | |
|
||
| 提现测试接口 | GIN_MODE=release 时返回 404 | ☐ | |
|
||
|
||
### 4.3 接口与数据流
|
||
|
||
| 场景 | 验证点 | 结果 | 问题（若失败） |
|
||
|------|--------|------|----------------|
|
||
| 路径隔离 | 小程序只调 /api/miniprogram/* | ☐ | |
|
||
| 鉴权 | 需登录接口带 token，401 正确跳转 | ☐ | |
|
||
| 支付回调 | 下单→支付→回调→分润 | ☐ | |
|
||
|
||
---
|
||
|
||
## 五、问题汇总（失败项）
|
||
|
||
将上述所有**未打 ☑️** 的项在此列出：
|
||
|
||
| 序号 | 模块 | 场景/用例 | 问题描述 | 严重程度 |
|
||
|------|------|-----------|----------|----------|
|
||
| 1 | | | | 高/中/低 |
|
||
| 2 | | | | |
|
||
| … | | | | |
|
||
|
||
---
|
||
|
||
## 六、测试报告（最终输出）
|
||
|
||
### 6.1 执行摘要
|
||
|
||
| 项目 | 内容 |
|
||
|------|------|
|
||
| 执行日期 | |
|
||
| 测试环境 | |
|
||
| 执行人 | |
|
||
|
||
### 6.2 结果统计
|
||
|
||
| 类型 | 总数 | 通过 ☑️ | 失败 | 通过率 |
|
||
|------|------|---------|------|--------|
|
||
| 自动化用例 | 12 | | | |
|
||
| 手工-小程序 | 7 | | | |
|
||
| 手工-管理端 | 7 | | | |
|
||
| 手工-接口 | 3 | | | |
|
||
| **合计** | **29** | | | |
|
||
|
||
### 6.3 结论
|
||
|
||
- [ ] **通过**：所有关键项 ☑️，无高/中严重问题
|
||
- [ ] **有条件通过**：存在低严重问题，可上线但需跟进
|
||
- [ ] **不通过**：存在高/中严重问题，需修复后复测
|
||
|
||
### 6.4 问题清单（若有）
|
||
|
||
| 序号 | 问题 | 严重程度 | 建议 |
|
||
|------|------|----------|------|
|
||
| 1 | | | |
|
||
| 2 | | | |
|
||
|
||
---
|
||
|
||
## 七、使用说明
|
||
|
||
1. **执行前**：复制本文档或新建一份，填写环境信息。
|
||
2. **执行中**：逐项验证，成功打 ☑️，失败在「问题」列填写。
|
||
3. **执行后**：汇总失败项到「五、问题汇总」，填写「六、测试报告」。
|
||
4. **归档**：报告保存为 `scripts/test/测试报告-YYYY-MM-DD.md`，便于追溯。
|