64 lines
1.7 KiB
Markdown
64 lines
1.7 KiB
Markdown
|
# Soul 创业派对 - 测试用例目录
|
|||
|
|
|
|||
|
|
> 测试工程师在此编写与维护测试用例。使用 pytest + requests 架构。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 目录结构
|
|||
|
|
|
|||
|
|
| 子目录 | 用途 | 对应端 | API 路径 |
|
|||
|
|
|--------|------|--------|----------|
|
|||
|
|
| **miniapp/** | 小程序接口测试 | miniprogram | /api/miniprogram/* |
|
|||
|
|
| **web/** | 管理端测试 | soul-admin | /api/admin/*、/api/db/* |
|
|||
|
|
| **process/** | 流程测试 | 跨端 | 多接口串联 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd scripts/test
|
|||
|
|
pip install -r requirements-test.txt
|
|||
|
|
pytest -v
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
联调前请先执行 `scripts/本地启动.sh` 启动 soul-api 与 soul-admin。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 环境变量（必须明确指定测试环境）
|
|||
|
|
|
|||
|
|
| 变量 | 说明 | 示例 |
|
|||
|
|
|------|------|------|
|
|||
|
|
| **SOUL_TEST_ENV** | 测试环境 | local / souldev / soulapi |
|
|||
|
|
| **SOUL_API_BASE** | 或直接指定 API 地址 | http://localhost:8080 |
|
|||
|
|
| SOUL_ADMIN_USERNAME | 管理端账号 | admin |
|
|||
|
|
| SOUL_ADMIN_PASSWORD | 管理端密码 | admin123 |
|
|||
|
|
| SOUL_MINIPROGRAM_DEV_USER_ID | 小程序开发登录 userId | 空（需 APP_ENV=development） |
|
|||
|
|
|
|||
|
|
可复制 `.env.test.example` 为 `.env.test` 配置（`.env.test` 含账号等，勿提交）。
|
|||
|
|
|
|||
|
|
**运行前会在报告头部显示「测试环境: xxx」**，避免误测正式库。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 运行方式
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
pytest miniapp/ -v # 只跑小程序
|
|||
|
|
pytest web/ -v # 只跑管理端
|
|||
|
|
pytest process/ -v # 只跑流程
|
|||
|
|
pytest -v # 全量
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 文件说明
|
|||
|
|
|
|||
|
|
| 文件 | 说明 |
|
|||
|
|
|------|------|
|
|||
|
|
| config.py | 配置（API_BASE、登录账号等） |
|
|||
|
|
| conftest.py | 共享 fixtures（base_url、admin_token、miniapp_token） |
|
|||
|
|
| util.py | 工具函数（admin_headers、miniapp_headers） |
|
|||
|
|
| requirements-test.txt | pytest、requests |
|