# 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 |