# 后端测试文档

## 测试结构

本测试目录包含项目管理系统后端的单元测试和集成测试，主要测试以下模块：

- **认证模块**：测试用户登录、token生成等功能
- **用户管理模块**：测试用户的创建、查询、更新、删除等功能
- **项目管理模块**：测试项目的创建、查询、更新、删除等功能

## 测试环境

- **测试框架**：Pytest
- **测试客户端**：FastAPI TestClient
- **测试数据库**：SQLite（内存数据库）
- **测试用户**：
  - 管理员：test_admin / test_password
  - 市场部：test_marketing / test_password
  - 其他部门：test_other / test_password

## 测试文件结构

```
tests/
├── conftest.py          # 测试配置和 fixtures
├── test_auth.py         # 认证模块测试
├── test_user.py         # 用户管理模块测试
├── test_project.py      # 项目管理模块测试
└── README.md            # 测试文档
```

## 运行测试

### 安装依赖

```bash
# 安装测试依赖
pip install pytest pytest-cov
```

### 运行所有测试

```bash
# 在backend目录下运行
pytest

# 运行测试并生成覆盖率报告
pytest --cov=app

# 运行测试并生成HTML格式的覆盖率报告
pytest --cov=app --cov-report=html
```

### 运行特定模块的测试

```bash
# 运行认证模块测试
pytest tests/test_auth.py

# 运行用户管理模块测试
pytest tests/test_user.py

# 运行项目管理模块测试
pytest tests/test_project.py
```

## 测试用例说明

### 认证模块测试
- 测试用户登录功能
- 测试token生成和验证
- 测试错误登录场景

### 用户管理模块测试
- 测试管理员获取用户列表
- 测试管理员创建用户
- 测试管理员更新用户
- 测试管理员删除用户
- 测试权限控制

### 项目管理模块测试
- 测试市场部创建项目
- 测试获取项目列表
- 测试更新项目
- 测试删除项目
- 测试项目历史记录
- 测试权限控制

## 测试覆盖范围

- API路由测试
- 业务逻辑测试
- 数据验证测试
- 权限控制测试
- 错误处理测试

## 注意事项

1. 测试使用SQLite内存数据库，不会影响生产数据库
2. 测试会自动创建和清理测试数据
3. 测试运行时会覆盖数据库依赖，使用测试数据库
4. 测试完成后会自动删除测试数据库

## 测试结果分析

测试运行完成后，会显示测试结果和覆盖率报告。通过分析测试结果，可以了解：

- 哪些功能通过了测试
- 哪些功能需要改进
- 代码覆盖率情况
- 潜在的问题和bug

## 持续集成

测试可以集成到CI/CD流程中，每次代码提交时自动运行测试，确保代码质量。