37be3034ec
- 将误用 Markdown 语法的截图路径重命名为 截图1-占位说明图.png - 新增 scripts/本地启动.bat；测试 README 补充 Windows 启动方式 - 新增 开发文档/Windows-资源命名与拉取.md Made-with: Cursor
Soul 创业派对 - 测试用例目录
测试工程师在此编写与维护测试用例。使用 pytest + requests 架构。
目录结构
| 子目录 | 用途 | 对应端 | API 路径 |
|---|---|---|---|
| miniapp/ | 小程序接口测试 | miniprogram | /api/miniprogram/* |
| web/ | 管理端测试 | soul-admin | /api/admin/、/api/db/ |
| process/ | 流程测试 | 跨端 | 多接口串联 |
快速开始
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」，避免误测正式库。
运行方式
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 |