student-management-system-alpha-release

student-management-system 学生管理系统 Alpha版本发布文档

1. Alpha版本发布说明

1.1 版本功能

student-management-system学生管理系统Alpha版本实现了以下核心功能：

学生功能

• 用户认证与权限管理：基于JWT的登录认证，支持学生角色权限
• 个人信息管理：查看和编辑个人基本信息、联系方式、紧急联系人等
• 课程选择与退课：支持单选、批量选课，提供时间冲突检查和学分限制校验
• 成绩查询与分析：查询学期成绩，查看GPA统计，查看成绩趋势图
• 图书查询、借阅与预约：搜索图书，在线借阅和预约，查看借阅记录
• 课表预览与下载：实时查看已选课程表，支持PDF格式下载

教师功能

• 授课信息管理：查看所授课程信息，管理课程资源
• 成绩录入与统计：批量录入学生成绩，自动计算平均分和GPA
• 学生名单查看：查看课程学生名单，导出学生信息
• 课程资源上传与管理：上传教学资料，管理课程公告

管理员功能

• 用户权限管理：创建和管理用户账号，分配角色权限
• 系统配置与监控：配置系统参数，监控系统运行状态
• 数据备份与恢复：定期备份数据库，支持数据恢复
• 日志管理：查看系统操作日志，审计用户行为

1.2 修复的缺陷

Alpha版本修复了以下主要缺陷：

• 用户登录时密码加密算法不一致问题
• 课程选择时时间冲突检查不准确问题
• 成绩录入时小数位数处理错误问题
• 学生信息导入Excel文件格式兼容性问题
• 前端界面在低分辨率下布局错乱问题
• 课程退课功能未校验退课截止时间问题
• 学生成绩查询时未过滤已删除课程记录问题
• 图书续借功能未检查续借次数限制问题
• 教师成绩录入权限验证缺失问题
• 成绩统计模块数据库查询效率低下问题

1.3 运行环境要求

后端运行环境

• JDK版本：JDK 17或以上版本
• 数据库：MySQL 8.0.33或以上版本
• 缓存：Redis 7.0或以上版本
• 消息队列：RocketMQ 5.0或以上版本
• 构建工具：Maven 3.8或以上版本

前端运行环境

• Node.js版本：Node.js 18或以上版本
• 包管理工具：npm 9或以上版本
• 浏览器要求：Chrome 120+、Firefox 119+、Safari 17+、Edge 120+

1.4 安装方法

后端安装

1. 克隆代码库：git clone https://gitee.com/C35121/Students-Management-System.git

2. 进入项目目录：cd Students-Management-System

3. 修改数据库配置：编辑 src/main/resources/application.yml

4. 构建项目：mvn clean install

5. 运行项目：java -jar target/Students-Management-System-1.0.0.jar

前端安装

1. 克隆代码库：git clone https://gitee.com/C35121/Students-Management-System.git

2. 进入前端目录：cd Students-Management-System/frontend

3. 安装依赖：npm install

4. 修改API地址：编辑 .env.development 或 .env.production

5. 构建项目：npm run build

6. 部署生成的 dist 目录到Web服务器

1.5 已知问题和限制

• 系统在高并发情况下响应时间会增加
• 移动端访问时部分功能体验不佳
• 图书借阅记录查询只支持最近3个月的数据
• 成绩统计分析功能仅支持基本的图表展示
• 系统备份功能需要手动触发

1.6 发布方式与地址

发布方式

• 代码发布：通过Gitee仓库发布源代码
• 文档发布：提供详细的安装和使用文档

发布地址

• 代码仓库**：https://gitee.com/C35121/Students-Management-System
• 文档地址：https://gitee.com/C35121/Students-Management-System

2. Alpha版本测试报告

2.1 测试概述

为确保student-management-system学生管理系统Alpha版本的质量和稳定性，我们进行了全面的测试工作。测试涵盖了系统的所有核心功能模块，包括用户认证、课程选择、成绩管理、学生信息管理等。测试方法包括单元测试、集成测试、系统测试和用户验收测试，以确保系统在各种场景下都能稳定运行。

2.2 Bug统计与分类

在测试过程中，我们总共发现了21个Bug，按照不同类别分类如下：

Bug类别	数量	描述
功能缺陷	8	如课程退课未校验截止时间、成绩查询未过滤已删除课程等
UI/UX问题	5	如课程表预览不全、成绩趋势图加载失败、低分辨率下布局错乱等
性能问题	3	如批量选课超时、成绩统计查询效率低、高并发响应缓慢等
兼容性问题	2	如Excel文件格式兼容性问题、不同浏览器下主题切换异常等
数据一致性问题	2	如课程选择成功后数据未同步、密码加密算法不一致等
安全问题	1	如教师成绩录入未验证权限、潜在的权限越权风险等

2.3 Bug处理情况

已修复的Bug（16个）

• 用户登录时密码加密算法不一致问题
• 课程选择时时间冲突检查不准确问题
• 成绩录入时小数位数处理错误问题
• 学生信息导入Excel文件格式兼容性问题
• 前端界面在低分辨率下布局错乱问题
• 课程表预览功能显示不全问题
• 成绩趋势图数据加载失败问题
• 用户权限验证逻辑错误问题
• 批量选课功能超时问题
• 图书借阅记录查询时日期格式错误问题
• 教师授课表分页查询异常问题
• 课程退课功能未校验退课截止时间问题
• 学生成绩查询时未过滤已删除课程记录问题
• 图书续借功能未检查续借次数限制问题
• 教师成绩录入时未验证权限问题
• 成绩统计模块计算班级排名时数据库查询效率低下问题

不能重现的Bug（2个）

• 偶发性的系统登录超时问题
• 极少数情况下的课程选择成功后数据未同步问题

产品设计如此，非Bug（1个）

• 图书借阅期限限制为30天（根据学校规定设计）

无能力修复，未来也不打算修复（0个）

2.4 场景测试

学生用户场景

预期使用方式：学生登录系统后，查看个人信息，进行课程选择，查询成绩，借阅图书。

需求和目标：快速完成课程选择，及时了解学习成绩，便捷借阅图书。

功能组合：

• 用户认证 → 学生首页 → 个人信息管理
• 课程选择 → 时间冲突检查 → 课表预览
• 成绩查询 → 成绩分析 → 趋势图查看
• 图书查询 → 图书借阅 → 借阅记录查询

教师用户场景

预期使用方式：教师登录系统后，查看授课信息，录入学生成绩，管理课程。

需求和目标：高效管理课程，准确录入成绩，及时了解学生学习情况。

功能组合：

• 用户认证 → 教师首页 → 授课管理
• 成绩录入 → 成绩统计 → 成绩分析
• 课程管理 → 学生名单查看 → 教学资源上传

管理员用户场景

预期使用方式：管理员登录系统后，管理用户权限，维护系统数据，统计分析系统使用情况。

需求和目标：确保系统安全稳定运行，高效管理系统资源，及时处理系统问题。

功能组合：

• 用户认证 → 管理员首页 → 用户权限管理
• 系统配置 → 数据备份 → 日志管理
• 统计分析 → 系统监控 → 问题处理

2.5 测试矩阵

测试环境	配置	测试结果
操作系统	Windows 10/11	通过
操作系统	macOS Ventura	通过
操作系统	Ubuntu 22.04	通过
浏览器	Chrome 120+	通过
浏览器	Firefox 119+	通过
浏览器	Safari 17+	通过
浏览器	Edge 120+	通过
数据库	MySQL 8.0.33	通过
缓存	Redis 7.0+	通过
消息队列	RocketMQ 5.0+	通过
JDK版本	JDK 17	通过
Node.js版本	Node.js 18+	通过
屏幕分辨率	1024x768	通过
屏幕分辨率	1366x768	通过
屏幕分辨率	1920x1080	通过
网络环境	有线网络	通过
网络环境	WiFi	通过

2.6 出口条件

我们认为，当满足以下条件时，系统可以发布Alpha版本：

1. 核心功能实现：所有核心功能模块（用户认证、课程选择、成绩管理、学生信息管理）均已实现并通过测试
2. Bug修复率：已修复90%以上的功能缺陷和严重Bug，剩余Bug均为非致命性问题
3. 稳定性要求：系统在主要目标环境下稳定运行，连续运行72小时无致命错误
4. 性能要求：系统响应时间满足基本要求（页面加载时间<3秒，API响应时间<2秒）
5. 用户体验：前端界面美观、易用，基本满足用户体验要求
6. 测试通过率：所有测试用例通过率达到90%以上

---

发布日期：2025-12-15
发布团队：student-management-system开发团队
联系邮箱：[email protected]