简介
本系统基于 Spring Boot 搭建的方便易用、高颜值的教学管理平台,提供多租户、权限管理、考试、练习、在线学习等功能。主要功能为在线考试、练习、刷题,在线学习。课程内容支持图文、视频,考试类型支持考试、练习、问卷。
源码下载
网盘链接 密码8418
题型支持单选题、多选题、判断题、简答题、视频、语音,题目内容支持图文、视频等。支持题库、刷题功能。
本版本为 Spring Boot 版本,没有太多中间件依赖,使用、部署都非常方便,并且持续更新维护。
架构设计
功能概述
项目分 web 前台、后台管理、小程序三部分,前台、小程序主要提供考试功能,后台提供基础管理、考试管理功能。
web 前台主要功能:提供在线考试、课程学习、练习等功能。
后台主要功能:系统管理(单位管理、用户管理、部门管理、角色管理、菜单管理、操作日志、代码生成),考务管理(课程管理、考试管理、题库管理、成绩管理)。
部署指南
1. 新建数据库
我们可以使用 navicat 新建数据库,数据库名可以自定义,字符集和排序规则是确定的。
2. 运行 SQL 文件
我们导入源码中 init.sql
新建相关表,初始化数据。
3. 修改配置文件
我们把两个 yml 配置文件复制到 sg-user-service
目录中的 resource
目录中,按需进行修改,比如 MySQL
数据库用户名密码,redis 密码等。
4. 编译 jar 包
我们要检查电脑上是否安装 gradle,运行以下指令测试。
>gradle -v
------------------------------------------------------------
Gradle 8.5
------------------------------------------------------------
Build time: 2023-11-29 14:08:57 UTC
Revision: 28aca86a7180baa17117e0e5ba01d8ea9feca598
Kotlin: 1.9.20
Groovy: 3.0.17
Ant: Apache Ant(TM) version 1.10.13 compiled on January 4 2023
JVM: 17.0.9 (Oracle Corporation 17.0.9+11-LTS-jvmci-23.0-b21)
OS: Windows 11 10.0 amd64
我们直接在根目录下运行打包指令,并跳过测试。
gradle build -x test
生成的 jar 包在 build/libs
目录下,运行 java -jar xxx.jar
,后端的部署就完成了。
5. 运行前端
我们再进入 frontend/sg-exam-app
目录,运行 npm install
下载依赖,下载完成后运行npm run dev
启动运行。
后台管理项目存放在 frontend/sg-exam-app-admin
目录,运行 pnpm install
下载依赖,下载完成后运行npm run dev
启动运行。
前端部署完成。
代码讲解
下面这段代码是用来展示后台首页数据,其中 userVo 用来查询用户数量,dto 返回给客户端做数据展示功能。
首页数据
/**
* 获取管控台首页数据
*/
@GetMapping
@Operation(summary = "后台首页数据展示", description = "后台首页数据展示")
public R<DashboardDto> dashboard() {
String tenantCode = SysUtil.getTenantCode();
DashboardDto dto = new DashboardDto();
// 查询用户数量
UserVo userVo = new UserVo();
userVo.setTenantCode(tenantCode);
dto.setOnlineUserNumber(userService.userCount(userVo).toString());
// 租户数量
dto.setTenantCount(tenantService.tenantCount().toString());
// 查询考试数量
ExaminationDashboardDto dashboardDto = examRecordService.findExamDashboardData(tenantCode);
if (dashboardDto != null) {
if (dashboardDto.getExaminationCount() != null) {
dto.setExaminationNumber(dashboardDto.getExaminationCount().toString());
}
if (dashboardDto.getExamUserCount() != null) {
dto.setExamUserNumber(dashboardDto.getExamUserCount().toString());
}
if (dashboardDto.getExaminationRecordCount() != null) {
dto.setExaminationRecordNumber(dashboardDto.getExaminationRecordCount().toString());
}
}
return R.success(dto);
}
考试管理
这段代码是一个使用Java语言和Spring框架编写的RESTful API控制器。它定义了一系列的HTTP GET和POST请求方法,用于处理与考试信息管理相关的业务逻辑。下面是对这段代码的详细解释:
@Slf4j
:这是一个日志注解,用于在控制类中注入一个日志对象,方便记录日志。@AllArgsConstructor
:这是一个Lombok注解,用于自动生成所有字段的构造函数。@Tag(name = "考试信息管理")
:这是一个自定义注解,用于标记这个控制器属于哪个功能模块。@RestController
:表示这是一个RESTful风格的控制器,它将返回JSON格式的数据。
接下来是部分方法的解释:
canStart
:这个方法通过GET请求方式,提供查询是否能开始考试的功能。它接受一个Long
类型的参数id
,表示考试的ID。方法内部会查询该ID对应的考试信息,并检查考试是否已经开始,以及是否有结束时间限制。examination
:这个方法通过GET请求方式,提供根据考试ID获取考试信息的功能。detail
:这个方法通过GET请求方式,提供根据考试ID获取考试详细信息的功能。getMembers
:这个方法通过GET请求方式,提供根据考试ID获取考试成员ID的功能。anonymousUserGet
:这个方法通过GET请求方式,提供根据考试ID获取考试信息的功能,但是这个方法专门为匿名用户设计。
@Slf4j
@AllArgsConstructor
@Tag(name = "考试信息管理")
@RestController
@RequestMapping("/v1/examination")
public class ExaminationController extends BaseController {
private final IExaminationService examinationService;
private final IExamPermissionService examPermissionService;
@GetMapping("canStart")
@Operation(summary = "查询是否能开始考试", description = "查询是否能开始考试")
public R<Boolean> canStart(@RequestParam Long id) {
boolean canStart = false;
Examination examination = examinationService.get(id);
if (examination != null) {
if (examination.getStartTime() != null && examination.getEndTime() != null) {
long currentMillis = System.currentTimeMillis();
canStart = ((currentMillis > examination.getStartTime().getTime()) && (
examination.getEndTime().getTime() > currentMillis));
} else {
// 没有限制考试时间
canStart = true;
}
}
return R.success(canStart);
}
@GetMapping("/{id}")
@Operation(summary = "获取考试信息", description = "根据考试 ID 获取考试信息")
public R<Examination> examination(@PathVariable Long id) {
return R.success(examinationService.get(id));
}
@GetMapping("/{id}/detail")
@Operation(summary = "获取考试详细信息", description = "根据考试 id 获取考试详细信息")
public R<ExaminationDto> detail(@PathVariable Long id) {
return R.success(examinationService.getDetail(id));
}
@GetMapping("/{id}/getMembers")
@Operation(summary = "获取考试成员 ID", description = "根据考试 ID 获取考试成员 ID")
public R<MemberDto> getMembers(@PathVariable Long id) {
return R.success(examPermissionService.getMembers(ExamConstant.PERMISSION_TYPE_EXAM, id));
}
@GetMapping("/anonymousUser/{id}")
@Operation(summary = "获取考试信息", description = "根据考试 id 获取考试详细信息")
public R<Examination> anonymousUserGet(@PathVariable Long id) {
return R.success(examinationService.get(id));
}
@GetMapping("examinationList")
@Operation(summary = "获取考试列表")
public R<PageInfo<ExaminationDto>> examinationList(@RequestParam Map<String, Object> condition,
@RequestParam(value = PAGE, required = false, defaultValue = PAGE_DEFAULT) int pageNum,
@RequestParam(value = PAGE_SIZE, required = false, defaultValue = PAGE_SIZE_DEFAULT) int pageSize) {
return R.success(examinationService.examinationList(condition, pageNum, pageSize));
}
@GetMapping("userExaminationList")
@Operation(summary = "获取用户有权限的考试列表")
public R<PageInfo<ExaminationDto>> userExaminationList(@RequestParam Map<String, Object> condition,
@RequestParam(value = PAGE, required = false, defaultValue = PAGE_DEFAULT) int pageNum,
@RequestParam(value = PAGE_SIZE, required = false, defaultValue = PAGE_SIZE_DEFAULT) int pageSize) {
return R.success(examinationService.userExaminationList(condition, pageNum, pageSize));
}
@RequestMapping("subjectList")
@Operation(summary = "获取题目列表")
public R<PageInfo<SubjectDto>> subjectList(@RequestParam Map<String, Object> condition,
@RequestParam(value = PAGE, required = false, defaultValue = PAGE_DEFAULT) int pageNum,
@RequestParam(value = PAGE_SIZE, required = false, defaultValue = PAGE_SIZE_DEFAULT) int pageSize,
SubjectDto subjectDto) {
return R.success(examinationService.findSubjectPageById(subjectDto, condition, pageNum, pageSize));
}
@PostMapping
@Operation(summary = "创建考试", description = "创建考试")
@SgLog(value = "创建考试", operationType = OperationType.INSERT)
public R<Boolean> add(@RequestBody @Valid ExaminationDto examinationDto) {
examinationDto.setCommonValue();
return R.success(examinationService.insertExamination(examinationDto) > 0);
}
@PutMapping("{id}")
@Operation(summary = "更新考试信息", description = "根据考试 ID 更新考试的基本信息")
@SgLog(value = "更新考试", operationType = OperationType.UPDATE)
public R<Boolean> update(@PathVariable Long id, @RequestBody @Valid ExaminationDto examinationDto) {
examinationDto.setId(id);
examinationDto.setCommonValue();
return R.success(examinationService.updateExamination(examinationDto) > 0);
}
@DeleteMapping("{id}")
@Operation(summary = "删除考试", description = "根据 ID 删除考试")
@SgLog(value = "删除考试", operationType = OperationType.DELETE)
public R<Boolean> delete(@PathVariable Long id) {
Examination examination = examinationService.get(id);
if (examination != null) {
examination.setCommonValue();
return R.success(examinationService.delete(examination) > 0);
}
return R.success(Boolean.FALSE);
}
@PostMapping("deleteAll")
@Operation(summary = "批量删除考试", description = "根据考试 id 批量删除考试")
@SgLog(value = "删除考试", operationType = OperationType.DELETE)
public R<Boolean> deleteAll(@RequestBody Long[] ids) {
return R.success(examinationService.deleteAll(ids) > 0);
}
@GetMapping("nexSubjectNo/{id}")
@Operation(summary = "获取下一题的序号")
public R<Integer> nexSubjectNo(@PathVariable Long id) {
return R.success(examinationService.nextSubjectNo(id));
}
@PostMapping("batchAddSubjects/{id}")
@Operation(summary = "批量添加题目")
@SgLog(value = "批量添加题目", operationType = OperationType.INSERT)
public R<Boolean> batchAddSubjects(@PathVariable Long id, @RequestBody List<SubjectDto> subjects) {
return R.success(examinationService.batchAddSubjects(id, subjects));
}
@PostMapping("randomAddSubjects/{id}")
@Operation(summary = "随机添加题目")
@SgLog(value = "随机添加题目", operationType = OperationType.INSERT)
public R<Boolean> randomAddSubjects(@PathVariable Long id, @RequestBody RandomSubjectDto params) {
return R.success(examinationService.randomAddSubjects(id, params));
}
}