WaveSign测试文档.md · wydhhh/Software-Engineering

# WaveSign 项目自动化测试文档

>  **编写日期**：2025-07-21
>  **编写人**：杨嘉莉
>  **适用范围**：Django 后端项目全模块，含 API、模型、视图、用户逻辑等

------

## 📄 文档说明

本测试文档系统性描述了 WaveSign 项目的测试策略、用例设计、运行过程、覆盖率统计及维护建议，适用于团队协作、质量评估与交付归档。

> 📸 以下为测试执行与覆盖率报告截图：

![image-20250722191111792](./img/testOK.png)

*图1：Django 全部 31 个测试用例成功运行*

![image-20250722191224973](./img/test覆盖率93%.png)

*图2：coverage HTML 报告展示总覆盖率为 93%*

------

## 一、测试设计

### 1.1 测试目标

- 验证各业务模块的主要功能、异常分支、权限控制、数据完整性等是否符合预期。
- 保证系统在正常和异常情况下均能稳定运行，防止回归和低级错误。
- 达到并保持85%以上的代码覆盖率，优先覆盖所有核心业务分支。

### 1.2 测试策略

- **单元测试**：对每个模型、表单、序列化器、视图函数/类进行最小粒度的功能验证。
- **集成测试**：对视图、API接口的正常流程、异常分支、权限控制等进行端到端验证。
- **异常与边界测试**：覆盖所有常见的无效输入、权限不足、重复操作、数据不存在等情况。
- **回归测试**：每次主要功能变更后，自动运行全部测试，确保无回归。

### 1.3 测试工具

- **pytest**、**pytest-django**、**pytest-cov**：主力测试与覆盖率工具
- **Django TestCase**、**APIClient**：Django自带测试框架与REST接口测试
- **coverage**：生成详细的覆盖率报告

------

## 二、测试用例设计与说明

### 2.1 测试用例说明（汇总表）

| 用例编号 | 模块        | 测试内容/场景                | 预期结果/断言                 |
| -------- | ----------- | ---------------------------- | ----------------------------- |
| 2.1.1    | Community   | 创建帖子（内容正常）         | 状态码302，帖子被创建         |
| 2.1.2    | Community   | 创建帖子（内容为空）         | 状态码302，未创建             |
| 2.1.3    | Community   | 点赞帖子（正常）             | 状态码200，点赞数+1           |
| 2.1.4    | Community   | 点赞帖子（重复点赞）         | JSON返回已点赞                |
| 2.1.5    | Community   | 点赞不存在的帖子             | 状态码404，JSON返回帖子不存在 |
| 2.1.6    | Community   | 评论帖子（正常）             | 状态码200，评论数+1           |
| 2.1.7    | Community   | 评论帖子（内容为空）         | JSON返回评论不能为空          |
| 2.1.8    | Community   | 评论不存在的帖子             | 状态码404，JSON返回帖子不存在 |
| 2.1.9    | Community   | 收藏帖子（正常）             | 状态码200，收藏数+1           |
| 2.1.10   | Community   | 收藏帖子（重复收藏）         | JSON返回已收藏                |
| 2.1.11   | Community   | 收藏不存在的帖子             | 状态码404，JSON返回帖子不存在 |
| 2.1.12   | Community   | 关注他人（正常/取消关注）    | JSON返回关注/取消关注         |
| 2.1.13   | Community   | 关注自己                     | JSON返回不能关注自己          |
| 2.1.14   | Community   | 关注不存在的用户             | JSON返回用户不存在            |
| 2.1.15   | Community   | 未登录访问受保护视图         | 状态码302重定向               |
| 2.2.1    | MyPage      | 个人中心访问（登录）         | 状态码200                     |
| 2.2.2    | MyPage      | 个人中心访问（未登录）       | 状态码302重定向               |
| 2.2.3    | MyPage      | 资料修改（POST）             | 状态码200/302，资料被修改     |
| 2.2.4    | MyPage      | 头像上传（成功）             | JSON返回success，含avatar_url |
| 2.2.5    | MyPage      | 头像上传（无文件）           | JSON返回失败，message提示     |
| 2.2.6    | MyPage      | 头像上传（未登录）           | JSON返回失败                  |
| 2.2.7    | MyPage      | 资料背景上传（成功）         | JSON返回success，含bg_url     |
| 2.2.8    | MyPage      | 资料背景上传（无文件）       | JSON返回失败，message提示     |
| 2.2.9    | MyPage      | 资料背景上传（未登录）       | JSON返回失败                  |
| 2.2.10   | MyPage      | 页面背景上传（成功）         | JSON返回success，含bg_url     |
| 2.2.11   | MyPage      | 页面背景上传（无文件）       | JSON返回失败，message提示     |
| 2.2.12   | MyPage      | 页面背景上传（未登录）       | JSON返回失败                  |
| 2.2.13   | MyPage      | 删除帖子（未登录）           | 状态码302重定向               |
| 2.2.14   | MyPage      | 删除帖子（无效ID）           | 状态码404                     |
| 2.3.1    | Schedule    | 事件列表API（已登录）        | 状态码200，返回事件列表       |
| 2.3.2    | Schedule    | 事件列表API（未登录）        | 状态码401                     |
| 2.3.3    | Schedule    | 事件详情API（不存在ID）      | 状态码404                     |
| 2.3.4    | Schedule    | 任务切换完成状态（不存在ID） | 状态码404                     |
| 2.3.5    | Schedule    | 任务删除（不存在ID）         | 状态码404                     |
| 2.3.6    | Schedule    | 今日事件API（未登录）        | 状态码401                     |
| 2.4.1    | users       | 注册（成功）                 | 状态码200/302，用户被创建     |
| 2.4.2    | users       | 注册（用户名已存在）         | 状态码200/302，注册失败       |
| 2.4.3    | users       | 注册（邮箱已存在）           | 状态码200/302，注册失败       |
| 2.4.4    | users       | 注册（密码不一致）           | 状态码200/302，注册失败       |
| 2.4.5    | users       | 登录（成功）                 | 状态码200/302，登录成功       |
| 2.4.6    | users       | 登录（用户名不存在）         | 状态码200/302，登录失败       |
| 2.4.7    | users       | 登录（密码错误）             | 状态码200/302，登录失败       |
| 2.4.8    | users       | 登出                         | 状态码302                     |
| 2.5.1    | Home        | 匿名用户访问首页             | 状态码200                     |
| 2.5.2    | Home        | 登录用户访问首页             | 状态码200                     |
| 2.5.3    | LifeServing | 匿名用户访问生活服务首页     | 状态码200                     |
| 2.5.4    | LifeServing | 登录用户访问生活服务首页     | 状态码200                     |
| 2.5.5    | SLClassroom | 匿名用户访问手语教室首页     | 状态码200                     |
| 2.5.6    | SLClassroom | 登录用户访问手语教室首页     | 状态码200                     |

---

**说明：**

- 用例编号与模块编号对应文档结构，便于追溯。
- 断言内容可根据实际业务和前端需求进一步细化。
- 具体实现见各模块 `tests.py` 文件。

### 2.2 模块结构说明

#### 📁 Community

- 帖子创建、点赞、评论、收藏、关注逻辑测试
- 含异常路径与未登录验证

#### 📁 MyPage

- 用户资料修改、头像/背景图上传
- 权限控制 + 上传边界用例

#### 📁 Schedule

- 任务/事件 API 的增删改查、状态切换、未登录场景

#### 📁 users

- 注册、登录、登出功能验证，字段约束、重复用户校验

#### 📁 Home / LifeServing / SLClassroom

- 首页匿名访问/登录访问检查，静态页面加载

------

## 三、测试执行与结果

### 3.1 运行命令

```bash
pip install pytest pytest-django coverage
coverage run manage.py test
coverage report
coverage html  # 查看 htmlcov/index.html
```

### 3.2 测试结果概览

| 指标项     | 数据值     |
| ---------- | ---------- |
| 总用例数   | 31         |
| 执行耗时   | 15.9s      |
| 执行结果   | 全部通过 ✅ |
| 覆盖率报告 | `htmlcov/` |
| 覆盖率总览 | 93% ✅      |

### 3.3 覆盖率示意（核心模块）

#### 主要覆盖率分布

| 文件/模块      | 语句数 | 未覆盖 | 覆盖率 |
| -------------- | ------ | ------ | ------ |
| Community/     | 248    | 13     | 87%    |
| MyPage/        | 209    | 19     | 91%    |
| Schedule/      | 172    | 22     | 87%    |
| users/         | 109    | 5      | 95%    |
| 其他（Home等） | 26     | 0      | 100%   |
| **总计**       | 916    | 64     | 93%    |

------

## 四、典型测试用例示例

### Community/tests.py

```python
def test_create_post_with_content(self):
    self.client.login(username='testuser', password='testpass')
    response = self.client.post(reverse('create_post'), {'content': 'new post'})
    self.assertEqual(response.status_code, 302)

def test_like_post_not_exist(self):
    self.client.login(username='testuser', password='testpass')
    response = self.client.post(reverse('like_post', args=[9999]))
    self.assertEqual(response.status_code, 404)
    data = json.loads(response.content)
    self.assertEqual(data['error'], '帖子不存在')
```

### MyPage/tests.py

```python
def test_upload_avatar_no_file(self):
    self.client.login(username='testuser', password='testpass')
    response = self.client.post(reverse('upload_avatar'))
    data = json.loads(response.content)
    self.assertFalse(data['success'])
    self.assertEqual(data['message'], '没有接收到avatar文件')
```

### Schedule/tests.py

```python
def test_event_list_unauthenticated(self):
    self.client.force_authenticate(user=None)
    response = self.client.get(reverse('event-list'))
    self.assertEqual(response.status_code, 401)
```

### users/tests.py

```python
def test_register_password_mismatch(self):
    response = self.client.post(reverse('register'), {
        'username': 'newuser',
        'email': 'new@example.com',
        'password': 'pass1',
        'password_confirm': 'pass2',
        'agreed_terms': True
    })
    self.assertIn(response.status_code, [200, 302])
```

## 五、结论与建议

- ✅ 系统功能测试通过，覆盖关键模块逻辑，质量稳定
- ✅ 总覆盖率 93%，高于目标线 85%
- ✅ 所有视图与模型功能均已涵盖典型异常路径

------

## 六、维护与扩展建议

- 每次新增功能后请 **同步添加测试**
- 保持高覆盖率，关注 HTML 报告中标红行
- 使用命名规范：`test_模块_功能_场景`
- CI/CD 流程建议强制执行测试（见下文）

------

## 八、文档版本控制

| 版本 | 说明                             | 日期       | 作者        |
| ---- | -------------------------------- | ---------- | ----------- |
| v1.0 | 初版，整理所有模块测试+覆盖率93% | 2025-07-21 | jialiyang ✅ |

## ✅ 附件说明

- `htmlcov/`：HTML 覆盖率报告目录

- `img/testOK.png`：控制台测试通过截图
- `img/test覆盖率93%.png`：测试覆盖率报告截图

------

wydhhh/Software-Engineering

简介

发行版

贡献者

近期动态

wydhhh/Software-Engineering .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

wydhhh/Software-Engineering