团队作业2-《需求规格说明书》

这个作业属于哪个课程	班级链接
这个作业要求在哪里	作业要求
这个作业的目标	<编写需求规格说明书>
项目仓库：https://github.com/wodu-dreamy/online-exam-system

一、 需求规格说明书

1. 系统概述本系统旨在开发一个基于Java的B/S架构在线考试平台。其主要目标是解决传统纸质考试的组织效率低、资源消耗大、阅卷周期长等问题，为教育机构、企业培训部门提供一个高效、稳定、安全的线上考试解决方案。系统将支持多种题型、自动组卷、在线答题、自动判分和成绩分析等功能。
2. 面向用户分析本系统主要服务于三类用户群体：
   学生：
   核心功能：​ 在线考试、查询试题、个人信息管理。
   扩展功能：​ 参与论坛互动（发布/评论帖子）、查询分数。
   教师：
   核心功能：​ 用户管理（应理解为对所授课程学生的管理）、考试管理、题目管理。
   扩展功能：​ 参与论坛互动（发布/评论帖子）、为学生评定分数、管理学科/课程。
   管理员：
   核心功能：​ 具备最高权限，负责全系统的用户管理、考试管理、题目管理、课程管理、帖子管理、评论管理。
3. 功能性需求（细化）：
   学生功能模块：
   身份认证：​ 登录、注册、个人信息维护。
   考试中心：​ 参加考试（倒计时、自动提交）、查看考试成绩详情。
   学习社区：​ 在论坛中发布帖子提问、评论回复他人的帖子。
   试题库：​ 查询试题（可能为模拟练习或错题回顾功能）。
   教师功能模块：
   题库管理 (题目管理)：​ 对题目进行增删改查，题目归属于特定学科（ER图）。
   试卷与考试管理 (考试管理)：​ 创建试卷（从题库组题）、发布考试、设置考试参数（时间、学科等）。
   学生与成绩管理 (用户管理&分数)：​ 管理班级学生，查看并修改（评定）学生的考试分数。
   课程管理 (课程管理)：​ 创建和管理学科/课程内容。
   社区互动：​ 在论坛中发布公告或解答学生疑问。
   管理员功能模块：
   系统监控：​ 拥有教师所有权限，并负责用户管理（审核学生/教师账号）、帖子管理、评论管理（维护社区秩序）、课程管理（统筹所有学科）。
4. 技术需求
   后端技术栈：​ Java SE 8/11, Servlet/JSP 或 Spring Boot 框架， MySQL 数据库。
   前端技术栈：​ HTML5, CSS3, JavaScript， 可选用 jQuery、Bootstrap 等库/框架优化界面。
   服务器：​ 使用 Tomcat 作为Servlet容器。
   开发工具：​
   系统：Windows10
   jdk版本：1.8
   IntelliJ IDEA 版本：2.5
   二、 预期的用户数量
   预计总注册用户数（学生、教师、管理员）可达 1000人。同时在线用户峰值可能出现在课程学习后的集中考试期间或论坛热点讨论期，预计峰值约为 150人。
   三、 系统的真实性、可用性及价值所在
5. 真实性与完整性
   在线考试的需求在当今的教育和企业环境中是真实且普遍的。无论是学校的期中期末考试、职业资格认证，还是企业的内部培训考核，都对线上化有强烈需求。本项目所设计的功能，如题库管理、自动组卷、限时答题等，都是真实商业考试系统（如超星学习通、考试星）的核心功能缩影，具有明确的现实对应场景。
6. 可用性
   角色分离，权责清晰：系统具有清晰的权限管理，不同用户进入系统后只能看到和操作自己权限范围内的功能，界面不会冗余复杂，提升了使用效率。
   界面友好：​ 系统将采用清晰直观的布局，导航明确，降低用户学习成本。考生可轻松参加考试，教师可高效管理后台。
   功能完整：​ 覆盖了从考试创建、执行到结果分析的全流程，形成了一个完整的业务闭环。
   稳定可靠：​ 通过合理的数据库设计和代码优化，保证在预期用户并发量下，系统能够稳定运行，避免在考试过程中出现卡顿或崩溃。
7. 价值所在（提升）
   构建学习闭环：​ 系统价值不再局限于“高效考试”，而是通过“考试检测学习效果 -> 课程弥补知识短板 -> 论坛解决个性问题”的模式，形成一个完整的正向学习循环，真正助力教学质量提升。
   促进知识沉淀：​ 论坛模块使得学生的问题和教师的解答得以沉淀，形成可搜索的社区知识库，惠及后续学习者。
   一体化解决方案：​ 为机构提供了一个集用户管理、内容管理、考核评估、社区互动于一体的平台，避免了使用多个独立系统带来的数据孤岛和管理不便。

团队计划时间表

校正公式说明：
实际耗时 = 估计耗时 × 1.5 + 任务协调时间（统一取1天）
1.5倍缓冲：考虑到学习成本、技术难点、调试等未知因素。
1天协调：用于每日站会、沟通、合并代码等团队协作开销。

周次	主要开发任务 (对应精简版Issue)	原估计耗时(天)	校正后耗时(天)	核心产出物与备注
第9周	1. 团队组建与项目启动 团队组建、角色分配、项目选题、博客创建、码云/GitHub仓库初始化	3	3×1.5 + 1 = 5.5	团队博客、项目仓库、初步任务分工
第10周	2. 【需求与设计】完成需求规格说明书与技术选型 明确三大角色核心用例，确定技术栈，设计数据库ER图	4	4×1.5 + 1 = 7	《需求规格说明书》V1.0、技术栈文档、数据库ER图
第11周	3. 【原型与API】完成界面原型与API接口设计 绘制关键页面原型，定义后端API接口文档，制定编码规范	5	5×1.5 + 1 = 8.5	交互原型图、API接口文档、编码规范
第12周	4. 【基础框架】搭建项目基础框架与用户认证 初始化前后端项目，集成数据库，实现登录注册和JWT鉴权	6	6×1.5 + 1 = 10	可运行的基础项目框架、完成用户认证模块
第13周	5. 【教师端】实现题库与考试管理功能 开发题目的CRUD、组卷、发布考试功能	6	6×1.5 + 1 = 10	完成教师端核心功能，可发布考试
第14周	6. 【学生端】实现在线考试与交卷功能 开发考试列表、答题界面、倒计时、交卷与自动判题	7	7×1.5 + 1 = 11.5	完成学生端核心功能，形成系统闭环
第15周	7. 【管理端与论坛】 & 【系统测试】 实现管理员后台与论坛模块，同时进行全流程测试与Bug修复	7	7×1.5 + 1 = 11.5	系统所有功能完成，测试报告，Bug列表清零
第16周	8. 【部署上线】 & 【项目总结】 部署项目到服务器，完成最终展示、总结报告与事后分析	4	4×1.5 + 1 = 7	可公开访问的系统、项目总结报告、最终博客

里程碑1：项目规划与设计

【需求与设计】完成需求规格说明书与技术选型

• 描述：明确系统三大角色（学生、教师、管理员）的核心功能，确定前后端技术栈，完成数据库表结构设计。
• 标签：documentation, design, priority: high

【原型与API】完成界面原型与API接口设计

• 描述：绘制关键页面（如登录、考试、题库管理）的原型图，并定义核心功能的后端API接口文档。
• 标签：design, front-end, back-end

里程碑2：核心功能开发

【基础框架】搭建项目基础框架与用户认证

• 描述：初始化前后端项目，集成数据库，实现用户登录、注册和基于角色的权限控制。
• 标签：front-end, back-end, priority: high

【教师端】实现题库与考试管理功能

• 描述：开发教师端的核心功能：题目的增删改查、组卷、发布考试。
• 标签：back-end, front-end, feature

【学生端】实现在线考试与交卷功能

• 描述：开发学生端的核心功能：考试列表、在线答题、倒计时、交卷。
• 标签：front-end, back-end, priority: high

里程碑3：系统完善与上线

【管理端】实现管理员后台与论坛模块

• 描述：实现管理员对用户和课程的管理，以及基础的论坛发帖、评论功能。
• 标签：back-end, front-end, feature

【系统测试】进行全流程测试与Bug修复

• 描述：模拟真实用户从登录到完成考试的完整流程，修复所有关键Bug。
• 标签：testing, bug, priority: high

【部署上线】部署项目到服务器并正式运行

• 描述：配置生产环境，部署应用，确保系统可通过网络正常访问。
• 标签：deployment, devops, priority: high

码云团队项目issues
已将团队任务计划录入GitHub Issues，包括需求分析、原型设计、开发任务、测试任务等，每个任务明确负责人、截止时间及优先级。

GitHub Issues截图：

团队分工：

名字	学号	岗位
张翔（队长）	3123004378	测试
庄成杰	3123004380	前端开发
邢子昂	3123004372	后端开发

每个人完成的情况
目前处于需求分析阶段，团队成员已完成：

张翔：设计测试框架及核心测试点
庄成杰：整理技术文档，设计数据库表结构，绘制设计草图
邢子昂：研究优化方案，编写技术预研报告，完成需求规格说明书初稿，搭建GitHub仓库，确定UI组件库

个人感想:
庄成杰：ER图画完，发现“学生”、“试卷”、“分数”自动关联上，数据库设计的魅力就在于此
张翔：合理安排进行有效规划就不需要手忙脚乱完成项目
邢子昂：以质量优先，从一开始就注重项目的实用性及有效性防止冗杂，降低后续修改成本。