37be3034ec
- 将误用 Markdown 语法的截图路径重命名为 截图1-占位说明图.png - 新增 scripts/本地启动.bat；测试 README 补充 Windows 启动方式 - 新增 开发文档/Windows-资源命名与拉取.md Made-with: Cursor
67 lines
1.9 KiB
Markdown
67 lines
1.9 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
|
||
```
|
||
|
||
联调前请先启动 soul-api 与 soul-admin：
|
||
|
||
- **macOS / Linux**：`bash scripts/本地启动.sh` 或 `./scripts/本地启动.sh`
|
||
- **Windows**：双击或在仓库根目录执行 `scripts\本地启动.bat`（需已安装 Go、pnpm，且 Windows 10+ 自带 `curl` 用于健康检查）
|
||
|
||
---
|
||
|
||
## 环境变量（必须明确指定测试环境）
|
||
|
||
| 变量 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| **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 |
|