第一次提交

backend/tests/README.md

@@ -0,0 +1,141 @@
+# 单元测试说明
+
+## 测试框架
+
+本项目使用 `pytest` 作为测试框架，支持异步测试和数据库测试。
+
+## 运行测试
+
+### 运行所有测试
+
+```bash
+cd backend
+pytest
+```
+
+### 运行特定测试文件
+
+```bash
+pytest tests/test_auth.py
+```
+
+### 运行特定测试类或函数
+
+```bash
+pytest tests/test_auth.py::TestAuth::test_register_user
+```
+
+### 运行带标记的测试
+
+```bash
+# 只运行单元测试
+pytest -m unit
+
+# 只运行工作流相关测试
+pytest -m workflow
+
+# 只运行认证相关测试
+pytest -m auth
+```
+
+### 运行并显示覆盖率
+
+```bash
+pytest --cov=app --cov-report=html
+```
+
+## 测试标记
+
+- `@pytest.mark.unit` - 单元测试
+- `@pytest.mark.integration` - 集成测试
+- `@pytest.mark.slow` - 慢速测试（需要网络或数据库）
+- `@pytest.mark.api` - API测试
+- `@pytest.mark.workflow` - 工作流测试
+- `@pytest.mark.auth` - 认证测试
+
+## 测试结构
+
+```
+tests/
+├── __init__.py
+├── conftest.py          # 共享fixtures和配置
+├── test_auth.py         # 认证API测试
+├── test_workflows.py    # 工作流API测试
+├── test_workflow_engine.py  # 工作流引擎测试
+└── test_workflow_validator.py  # 工作流验证器测试
+```
+
+## Fixtures
+
+### `db_session`
+创建测试数据库会话，每个测试函数都会获得一个独立的会话。
+
+### `client`
+创建FastAPI测试客户端，用于API测试。
+
+### `authenticated_client`
+创建已认证的测试客户端，自动注册用户并登录。
+
+### `test_user_data`
+提供测试用户数据。
+
+### `sample_workflow_data`
+提供示例工作流数据。
+
+## 测试数据库
+
+测试使用SQLite内存数据库，每个测试函数都会：
+1. 创建所有表
+2. 执行测试
+3. 删除所有表
+
+这样可以确保测试之间的隔离性。
+
+## 编写新测试
+
+### 示例：API测试
+
+```python
+@pytest.mark.unit
+@pytest.mark.api
+class TestMyAPI:
+    def test_my_endpoint(self, authenticated_client):
+        response = authenticated_client.get("/api/v1/my-endpoint")
+        assert response.status_code == 200
+```
+
+### 示例：服务测试
+
+```python
+@pytest.mark.unit
+class TestMyService:
+    @pytest.mark.asyncio
+    async def test_my_service_method(self):
+        service = MyService()
+        result = await service.my_method()
+        assert result is not None
+```
+
+## 注意事项
+
+1. **测试隔离**：每个测试函数都应该独立，不依赖其他测试的执行顺序。
+
+2. **数据库清理**：使用 `db_session` fixture 确保每个测试都有干净的数据库。
+
+3. **异步测试**：使用 `@pytest.mark.asyncio` 标记异步测试函数。
+
+4. **标记测试**：使用适当的标记（`@pytest.mark.unit` 等）来组织测试。
+
+5. **测试数据**：使用 fixtures 提供测试数据，避免硬编码。
+
+## CI/CD集成
+
+在CI/CD流程中运行测试：
+
+```yaml
+# .github/workflows/test.yml
+- name: Run tests
+  run: |
+    cd backend
+    pytest --cov=app --cov-report=xml
+```