# UniLife 单元测试设计文档

## 📋 概述

本文档详细描述了 UniLife 项目四个核心模块的单元测试设计方案：论坛模块、资源模块、课程表模块和用户模块。

## 🏗️ 测试架构

### 后端测试框架
- **JUnit 5**: 主要测试框架
- **Mockito**: Mock框架，用于模拟依赖
- **Spring Boot Test**: Spring Boot测试支持
- **H2 Database**: 内存数据库，用于测试
- **TestContainers**: 集成测试容器支持

### 前端测试框架
- **Vitest**: 现代化的Vue测试框架
- **Vue Test Utils**: Vue组件测试工具
- **jsdom**: DOM环境模拟

## 🎯 1. 论坛模块测试

### 1.1 后端测试

#### PostServiceTest
测试覆盖范围：
- ✅ **创建帖子成功** - 验证正常创建流程
- ❌ **用户不存在** - 验证用户验证逻辑
- ❌ **分类不存在** - 验证分类验证逻辑
- ❌ **标题为空** - 验证输入校验
- ✅ **获取帖子详情** - 验证详情获取和浏览量更新
- ❌ **帖子不存在** - 验证错误处理
- ✅ **获取帖子列表** - 验证分页和搜索
- ✅ **更新帖子** - 验证更新逻辑
- ❌ **无权限修改** - 验证权限控制
- ✅ **删除帖子** - 验证删除逻辑
- ✅ **点赞/取消点赞** - 验证点赞逻辑

#### PostControllerTest
测试覆盖范围：
- HTTP接口测试
- 权限验证
- 参数校验
- 响应格式验证

### 1.2 前端测试

#### forum.test.ts
测试覆盖范围：
- API调用正确性
- 参数传递验证
- 错误处理
- 响应数据解析

## 🗂️ 2. 资源模块测试

### 2.1 后端测试

#### ResourceServiceTest
测试覆盖范围：
- ✅ **文件上传成功** - 验证文件上传流程
- ❌ **用户不存在** - 验证用户验证
- ❌ **分类不存在** - 验证分类验证
- ❌ **空文件上传** - 验证文件校验
- ❌ **不支持的文件类型** - 验证文件类型限制
- ✅ **获取资源详情** - 验证详情获取
- ❌ **资源不存在** - 验证错误处理
- ✅ **获取资源列表** - 验证搜索和分页
- ✅ **更新资源信息** - 验证更新逻辑
- ❌ **无权限修改** - 验证权限控制
- ✅ **删除资源** - 验证删除逻辑
- ✅ **下载资源** - 验证下载逻辑和计数更新
- ✅ **点赞/取消点赞** - 验证点赞逻辑

### 2.2 前端测试

#### resources.test.ts
测试覆盖范围：
- 文件上传API测试
- 文件类型验证
- 下载权限测试
- 资源管理功能测试

## 📅 3. 课程表模块测试

### 3.1 后端测试

#### ScheduleServiceTest
测试覆盖范围：
- ✅ **创建日程成功** - 验证日程创建
- ❌ **用户不存在** - 验证用户验证
- ❌ **时间冲突** - 验证时间冲突检测
- ❌ **无效时间范围** - 验证时间校验
- ✅ **获取日程详情** - 验证详情获取
- ❌ **日程不存在** - 验证错误处理
- ❌ **无权限查看** - 验证权限控制
- ✅ **获取日程列表** - 验证列表获取
- ✅ **按时间范围获取** - 验证时间范围查询
- ✅ **更新日程** - 验证更新逻辑
- ❌ **无权限修改** - 验证权限控制
- ✅ **删除日程** - 验证删除逻辑
- ✅ **检查时间冲突** - 验证冲突检测算法
- ✅ **处理日程提醒** - 验证提醒逻辑
- ✅ **重复日程创建** - 验证重复日程逻辑

### 3.2 前端测试

#### schedule.test.ts
测试覆盖范围：
- 日程CRUD操作测试
- 时间冲突检测测试
- 重复日程测试
- 课程管理测试

## 👤 4. 用户模块测试

### 4.1 后端测试

#### UserServiceTest
测试覆盖范围：
- ✅ **用户注册成功** - 验证注册流程
- ❌ **用户名已存在** - 验证唯一性校验
- ❌ **邮箱已存在** - 验证邮箱唯一性
- ✅ **用户登录成功** - 验证登录流程和JWT生成
- ❌ **用户不存在** - 验证登录错误处理
- ❌ **密码错误** - 验证密码校验
- ❌ **账户被禁用** - 验证账户状态检查
- ✅ **获取用户信息** - 验证信息获取
- ❌ **用户不存在** - 验证错误处理
- ✅ **更新用户信息** - 验证信息更新
- ✅ **发送邮箱验证码** - 验证邮件发送
- ✅ **验证邮箱验证码** - 验证码校验
- ❌ **验证码过期** - 验证过期处理
- ❌ **验证码错误** - 验证错误处理
- ✅ **重置密码** - 验证密码重置
- ✅ **获取用户列表** - 验证管理功能
- ✅ **修改密码** - 验证密码修改
- ❌ **原密码错误** - 验证原密码校验

## 🔧 测试配置

### 测试环境配置
- **数据库**: H2内存数据库
- **Redis**: 测试专用实例
- **邮件**: Mock邮件服务
- **文件上传**: 临时目录

### 测试数据管理
- 使用 `TestDataBuilder` 统一创建测试数据
- 测试间数据隔离
- 自动清理测试数据

## 📊 测试覆盖率目标

| 模块 | 行覆盖率目标 | 分支覆盖率目标 |
|------|-------------|---------------|
| 论坛模块 | ≥ 85% | ≥ 80% |
| 资源模块 | ≥ 85% | ≥ 80% |
| 课程表模块 | ≥ 85% | ≥ 80% |
| 用户模块 | ≥ 90% | ≥ 85% |

## 🚀 运行测试

### 后端测试
```bash
# 运行所有测试
./run-tests.sh

# 运行特定模块测试
mvn test -Dtest="*PostServiceTest"

# 生成覆盖率报告
mvn test jacoco:report
```

### 前端测试
```bash
# 运行所有测试
npm run test

# 运行特定测试
npm run test -- forum.test.ts

# 生成覆盖率报告
npm run test:coverage
```

## 📝 测试最佳实践

### 测试命名规范
- 测试类：`{ClassName}Test`
- 测试方法：`test{MethodName}_{Scenario}`
- 示例：`testCreatePost_Success`、`testCreatePost_UserNotFound`

### 测试结构
使用 **AAA 模式**：
1. **Arrange** - 准备测试数据和环境
2. **Act** - 执行被测试的方法
3. **Assert** - 验证结果

### Mock 使用原则
- 只Mock外部依赖
- 避免Mock被测试类的内部方法
- 使用合适的Mock策略（严格vs宽松）

### 测试数据管理
- 使用Builder模式创建测试数据
- 避免测试间的数据依赖
- 保持测试数据的简洁性

## 🔍 持续集成

### CI/CD流程
1. 代码提交触发测试
2. 并行运行单元测试和集成测试
3. 生成测试报告和覆盖率报告
4. 测试失败时阻止部署

### 测试报告
- 自动生成HTML格式测试报告
- 覆盖率报告可视化
- 失败测试详细信息
- 历史趋势分析

## 📋 总结

本测试设计方案为UniLife项目提供了全面的质量保障：

1. **全面覆盖**: 涵盖所有核心业务逻辑
2. **边界测试**: 包含各种异常情况和边界条件
3. **权限验证**: 确保安全性要求
4. **性能考虑**: 验证关键操作的性能表现
5. **易于维护**: 结构清晰，便于后续维护和扩展

通过执行这套测试方案，可以确保UniLife项目的稳定性、可靠性和安全性。