# 12-在线考试系统 - 功能说明
# 项目概述
面向教师和学生的在线考试平台，围绕科目、题库、试卷、考试、答题记录、成绩与错题本展开业务。系统支持客观题自动判分与主观题人工评分，学生可查看成绩详情和错题。
# 项目概览
# 创新点
- 混合评分：提交时对客观题判分，含主观题的记录进入待评分，教师评分后更新成绩。
- 错题沉淀：判错题目写入错题记录，学生可查看题目和掌握状态。
- 试卷与考试分离：试卷维护题目及分值，考试维护起止时间与关联试卷。
# 项目亮点
- 角色分工：提供管理员、教师、学生等业务入口。
- 业务数据组织：主初始化脚本包含 13 张表，围绕该系统的核心对象与业务记录建模。
- 前后端分离：前端负责页面交互，后端通过控制器、服务与数据映射层提供接口。
- 操作体验：提供列表查询、表单编辑、状态展示及个人资料维护入口。
# 管理员
# 账号资料
维护管理员、教师、学生及科目。
# 考试资源
管理题目、试卷和考试安排。
# 答题管理
查看考试记录、答题详情和错题记录。
# 平台内容
维护公告和轮播图。
# 教师
# 题库试卷
维护题目，为试卷选择题目及分值。
# 考试安排
维护考试时间与试卷关系。
# 阅卷评分
通过阅卷相关路由处理主观题评分并提交成绩。
# 学生
# 参加考试
浏览考试列表，在规定条件下进入答题页面并作答。
# 成绩查询
查看我的成绩、考试详情及答题情况。
# 错题复习
查看错题本和题目详情，维护掌握状态。
# 个人中心
查看公告，维护个人资料和密码。
# 功能权限对照表
下表说明当前菜单与业务入口分工。“—”表示未列为该角色的常规入口；不代表已对每个接口完成权限安全审计。
| 功能模块 | 管理员 | 教师 | 学生 |
|---|---|---|---|
| 账号、科目与平台内容 | 管理 | — | 浏览公告 |
| 题库、试卷、考试 | 管理 | 维护 | 查看可参加考试 |
| 答题与成绩 | 记录管理 | 阅卷相关路由 | 答题查询 |
| 错题记录 | 后台管理 | — | 个人复习 |
# 业务状态说明
- 考试展示：未开始、进行中、已结束。
- 考试记录：答题中 → 待评分 → 已批改；没有主观题时提交后可直接已批改。
- 错题掌握状态包含未掌握。
# 默认账号
以下为主初始化 SQL 中能够核实的示例账号；需先导入对应脚本。这里不把脚本初始值视为当前运行数据库的实际账号或余额。
| 登录角色 | 角色标识 | 用户名 | 初始密码 |
|---|---|---|---|
| 管理员 | ADMIN | admin | 123456 |
| 教师 | TEACHER | teacher | 123456 |
| 学生 | USER | user | 123456 |
# 核心业务流程
# 组卷与安排
- 维护科目和题目。
- 新建试卷。
- 手动选择题目并配置分值。
- 创建考试与时间安排。
# 考试作答
- 学生进入考试。
- 创建答题中记录。
- 倒计时内作答并提交。
- 客观题自动判分。
# 阅卷复习
- 含主观题的记录进入待评分。
- 教师阅卷并提交。
- 记录变为已批改。
- 学生查看成绩和错题。
# 技术说明
# 系统架构
| 项目 | 当前源码配置 |
|---|---|
| Vue | ^3.4.29 |
| Element Plus | ^2.8.4 |
| Pinia | ^2.2.2 |
| Axios | ^1.7.5 |
| Vite | ^5.3.1 |
| Spring Boot | 3.2.10 |
| Java | 17 |
| MyBatis 集成组件 | 3.0.4 |
| 数据库 | MySQL；具体运行版本以实际部署为准 |
| 身份认证 | JWT；通过登录接口生成令牌 |
前端版本按 package.json 中的声明范围记录，不将依赖范围等同于已安装的精确版本。
# 访问地址
- 后端接口：http://localhost:1000 (opens new window)，对应服务端端口配置。
- 前端开发页面：http://localhost:5173 (opens new window)，项目未显式覆盖 Vite 默认端口，实际以启动日志为准。
- 登录入口：前端
/login；管理端基础路由/admin。
# 数据库
- 配置数据库名：
a_2026_12_exam_system。 - 主初始化脚本：
sql/sql.sql。 - 主脚本建表数量：13 张，仅统计当前主脚本的 CREATE TABLE，不包含临时 SQL、迁移脚本或运行时改动。
- 字符集：主脚本采用 utf8mb4。
- 数据表清单：
admin、banner、exam、exam_answer、exam_record、notice、paper、paper_question、question、subject、teacher、user、wrong_question。
# 文件上传
- 上传接口：
POST /file/upload。 - 文件访问：
GET /file/{fileName}。 - 配置限制：单文件 100MB，单次请求 1000MB。
- 使用范围：根据业务页面上传图片或附件；具体允许类型以对应上传组件配置为准。
# 系统特色
# 混合评分
提交时对客观题判分，含主观题的记录进入待评分，教师评分后更新成绩。
# 错题沉淀
判错题目写入错题记录，学生可查看题目和掌握状态。
# 试卷与考试分离
试卷维护题目及分值，考试维护起止时间与关联试卷。
# 当前实现说明
- 现有试卷页面为选题组卷，不将随机组卷、按难度智能组卷作为已核实功能。
- 前台具备倒计时；没有核实到摄像头监考、切屏监测或完整防作弊机制，删除原文相关描述。
- 后端存在保存进度方法，但当前答题页面没有发现定时保存调用，因此不承诺自动保存或断点续考。
- 阅卷路由已存在，教师侧边菜单主要展示题目、试卷和考试；阅卷入口可达性仍需运行验证。
本次按本地源码进行静态核对，未启动前后端或连接数据库执行端到端验证；上述说明反映当前代码与页面定义。