团队作业5——测试与发布（Alpha版本）

这个作业属于哪个课程	计科23级12班
这个作业要求在哪里	团队作业5——测试与发布（Alpha版本）
这个作业的目标	完成 Alpha 版本的测试与发布说明，形成一个结构完整、可运行、可验证的软件工程交付物。

一、Alpha版本测试报告

1、测试过程概述

测试活动严格遵循“测试左移”原则，从第12周起与开发并行开展，覆盖单元测试、接口测试、UI/UX测试、安全测试及性能压测。

测试类型包括：

• 功能测试：验证用户注册/登录、文件上传/下载、文件夹管理、分享链接权限控制、回收站恢复与删除等。
• 接口测试：使用 Postman 对所有 RESTful API 进行请求/响应格式、状态码、权限校验验证。
• 性能测试：模拟50人并发上传场景，监控单文件上传响应时间、服务器资源占用。
• UI/UX测试：重点验证上传进度条（百分比）、回收站页面交互流畅性。
• 安全测试：验证分享链接下载次数限制机制。

测试环境如下：

类别	配置
操作系统	Windows 11
浏览器	Chrome 128, Edge 128, Firefox 129
后端环境	Spring Boot 3.5 + MySQL 9.2
前端框架	Vue 3 + Element Plus
网络环境	校园局域网

2. Bug统计与分类

在Alpha测试周期（第12–14周）中，共发现 23个缺陷（Bug），分类如下：

Bug类别	数量	说明
修复的Bug	18	包括：上传进度条未实时更新、分享链接未正确校验下载次数、回收站恢复路径错误、JWT令牌过期未跳转登录页等。
不能重现的Bug	2	用户反馈“偶尔上传失败”，但在测试环境中无法复现，可能与本地网络波动有关。
不是Bug（按设计）	2	如“分享链接不支持指定人员范围”——需求明确仅通过下载次数控制，属预期行为。
暂不修复（延迟至Beta）	1	“分片上传中断后无法续传”——技术复杂度高，当前版本采用重新上传策略，计划Beta阶段引入断点续传。
无能力修复（不计划修复）	0	无

3. 场景测试

3.1 典型用户场景

用户角色	需求与目标	功能组合使用
项目经理小王	安全高效地向核心成员分发分析报告	1. 上传PDF → 2. 生成分享链接（设下载3次）→ 3. 成员通过链接下载 → 4. 链接自动失效保障安全
普通团队成员	快速上传日志、恢复误删文件	1. 多文件拖拽上传（带进度可视化）→ 2. 误删后进入回收站 → 3. 一键恢复至原文件夹
新用户	快速注册并开始使用	1. 邮箱注册（含验证码）→ 2. 登录 → 3. 创建项目文件夹 → 4. 上传首个文件

3.2 测试矩阵

平台	浏览器	测试模块	结果
Windows 11	Chrome 128	全流程（注册→上传→分享→回收站）	✅ 通过
macOS Sonoma	Safari 17	文件上传+进度条	⚠️ Safari下剩余时间计算略有偏差（<1s误差，可接受）
Ubuntu 22.04	Firefox 129	分享链接权限控制	✅ 通过

3.3 出口条件

我们认为软件在满足以下条件时，可认定为 达到Alpha版本发布标准：

✅ 核心功能完整：用户认证、文件上传/下载、文件夹管理、分享链接（带权限）、回收站（恢复+自动清理）全部实现并通过测试。

✅ 关键非功能性需求达标：50人并发上传时，单文件平均响应时间 1.6秒（<2秒要求）。

✅ 无P0/P1级未修复缺陷：所有阻塞性、严重性Bug均已修复。

✅ 用户体验基本流畅：上传进度可视化、错误提示清晰、操作反馈及时。

✅ 文档齐备：接口文档、测试报告、用户操作指南初稿完成。

二、Alpha版本发布说明

1. 版本概述

这是《云盘协作系统》的 Alpha 1.0 版本，聚焦核心文件协作能力，支持安全分享与高效管理，适用于小团队内部文件共享场景。

2. 新增功能（相比初版原型）

• ✅ 带权限控制的分享链接：可设置下载次数（默认不限）。
• ✅ 回收站机制：支持“恢复原位置”和“彻底删除”，文件保留30天后自动清除。
• ✅ 上传进度可视化：实时显示上传速度、已传百分比。
• ✅ 大文件分片上传：提升大文件上传稳定性。

3.修复的缺陷

• 修复分享链接未在达到下载次数上限后失效的问题。
• 修复回收站恢复文件时路径错误导致文件丢失。
• 修复多文件同时上传时进度条互相覆盖。
• 修复JWT令牌过期后未自动跳转登录页。
• 优化上传组件在弱网下的重试逻辑。

4. 运行环境要求

要成功运行本 Alpha 版本，请确保本地开发环境满足以下条件：

后端（Spring Boot）

• JDK 17 或以上
• Maven 3.8+
• MySQL 8.0（需创建数据库）

前端（Vue 3）

• Node.js 18+
• npm 或 pnpm
• 推荐使用 Chrome/Edge进行测试

5. 安装与使用方法

克隆项目代码：git clone https://github.com/DPXCYun/YunPan
初始化数据库：

• 创建 MySQL 数据库
• 执行 sql/init.sql 初始化表结构

修改配置文件： 在application-dev.yml修改storage-lib、qrcodebgPath、qrcodewithbgPath为自己的路径

启动后端服务：
启动服务YunpiyuanpanApplication.java，默认运行在 http://localhost:8080

启动前端界面：

• npm install
• npm run serve
• 默认运行在 http://localhost:8888

访问系统：
在浏览器打开 http://localhost:8888，使用邮箱注册新用户

6. 已知问题与限制

❗ 不支持断点续传：上传中断后需重新上传整个文件（计划 Beta 版本实现）。
❗ 移动端 UI 未适配：仅针对桌面浏览器设计，手机访问体验较差。
❗ 分享链接无法外网访问：因服务运行在 localhost，生成的链接仅本机有效。
❗ 无 HTTPS 支持：本地开发使用 HTTP，生产环境需配置 SSL。
❗ 性能未压测真实高并发：仅在单机低并发下验证功能正确性。

7. 发布方式说明

本版本未对外发布，仅作为团队内部 Alpha 测试使用。
源代码、数据库脚本、接口文档、测试报告均存放于团队Git仓库。
如需体验，请在本地按上述步骤搭建开发环境运行。