README.md · qiuquanRealMan/exam

# 为考-考试平台

毕业设计：为考-考试系统，后端采用`Spring Cloud`，前端采用`Vue` 3，存储采用`Mysql`，缓存采用`Redis`。完成基本的考试功能。完成了遗传算法自动组卷、文本批量导入题库，邀请码加入课程、数据可视化等一系列前后端功能。悄悄的说一下，如果你觉得本项目还凑合，可以给个`Star` q(≧▽≦q)

## 说明

本项目为本人毕业设计，未经许可，不可用于任何商业用途。禁止通过该项目进行毕设项目买卖

第一次接触`SpringBoot`和`SpringCloud`，为了尽快的完成该项目，很多功能没有进行太多的规划和测试，代码逻辑较乱。只实现了主要功能,本来是想写个学习平台的.但是范围太大,不太好完成.所以就完成了其中的考试功能.

如果你想以本项目做毕设，我建议你可以以完成其他模块入手或者完成本项目没有完成的功能、待优化的功能，如后台管理、错题本，笔记。可以去体验下\*\*通，找找思路，不建议直接使用本项目，毕设应该自己去动动手，这将会是你那简历中挺好的一个经验吧\~。哎\~不过找工作还是好难找不到啊！找前端，哎，后端吧，东西太多记不住，其实我感觉就是人太多，投简历人家都看不见吧~，还有就是自己的基础不牢靠，会模仿着实现一些功能，但很多知识记不住啊！面向百度编程啊！

## 介绍

###  项目地址

#### 为考-考试平台-前端：

Gitee：[https://gitee.com/for-the-exam/exam-web](https://gitee.com/for-the-exam/exam-web)

Github：[https://github.com/baymaxsjj/exam-web](https://github.com/baymaxsjj/exam-web)

#### 为考-考试平台-后端：

Gitee：[https://gitee.com/for-the-exam/exam](https://gitee.com/for-the-exam/exam)

Github：[https://github.com/baymaxsjj/exam](https://github.com/baymaxsjj/exam)

#### 数据库数据填充工具：

专为此项目写的工具，为了给数据库填充点数据，好测试。其实也是为了毕设演示环节有更多的数据进行展示。测试和展示都很好用的工具，可以在你的项目上试试啊！

Gitee：[https://gitee.com/baymaxsjj/sqlmock](https://gitee.com/baymaxsjj/sqlmock)

Github：[https://gitee.com/baymaxsjj/sqlmock](https://gitee.com/baymaxsjj/sqlmock)

### 系统截图

### 系统

- 框架：SpringBoot、SpringCloud、Mybatis Plus、WebSocket
- 数据库：Mysql
- 缓存：Redis
- 前端：Vue 3、Vite、Pinia、Arco UI

### 功能图

![为考考试系统-功能图](./images/为考-在线考试平台.png)

### E-R图

不知道画的对不对，记得上数据库实训的时候，给我那个博客画的E-R图，结果被老师训了一顿。到现在想起还有点害怕＞︿＜
![为考考试系统-E-R图](./images/系统E-R图.jpg)

### 完成功能

- [x] 创建课程、添加课程、班级码加入课程
- [x] 创建班级、查看班级用户、分享班级码
- [x] 课堂互相实时聊天
- [x] 创建题库、题库树形分类
- [x] 创建题目（单、多、判、填、主观）、修改题目选项
- [x] 创建试卷、修改试卷、手动组卷、遗传算法自动组卷
- [x] 创建考试、修改考试
- [x] 考试控制台、考试概览、老师批阅、数据统计、考试监控
- [x] 参加考试
- [x] 行为监控
- [x] 实时消息通知
- [x] 考试数据导出
- [x] 考生数据统计分析

# 为考-前端

## 配置说明

根据实际环境，更改.env下的请求地址，如后台网关地址，图片资源地址

## 主题

如需更改主题，到下面的网站去制作主题，发布npm，然后把项目中的npm-`@arco-themes/vue-mgo-blog`包改了就行。
Arco UI:使用风格配置平台，轻松定制主题风格，从容应对各种业务需求。https://arco.design/themes

##  安装pnpm

```
npm install pnpm -g
```

##  安装依赖

```
pnpm install
```

## 运行项目

```
pnpm run dev
```

## 打包

```
//编译
pnpm run build 
```

# 为考后端

## 功能说明

### 课程中心

主页面只有我的课程是完成的，我的作业 我的考试 我的笔记 消息那些功能都没写

### 个人中心

个人中心只完成信息的显示，没有实现信息的更改，

没有实现校园认证等功能

### 导入题库

导入格式：是学习通的题库导入格式，在本项目的doc下有一个测试题库，可以复制粘贴到导入题库测试。

格式说明：一定要保证格式正确，要不然不能识别。

```tex
序号、题目内容
字母、选项内容（可选）：
答案： 答案内容（多个答案用中文分号（；）分割）

例如：
选择题:
    27、程序状态字寄存器 PSW 中的 AC=1,表示( )。
    A、 计算结果有进位
    B、 计算结果有溢出
    C、 累加器 A 中的数据有奇数个 1
    D、 计算结果低 4 位向高位进位
    答案： D
填空题：
    20、总线路是用于传送信息的公共通信途径。总线可分为____、____和____。
    答案： 数据总线； 地址总线； 控制总线；

```

## 使用说明

### 下载和启动nacos

[nacos官网下载](https://nacos.io/zh-cn/)

```shell
startup.cmd -m standalone
```

### 更改配置

启动数据库：创建并导入本项目中sql目录下的sql文件。
启动`Redis,Nginx`

并修改项目中各个微服务`application.yml`中涉及的用户名和密码

### 本地测试

由于注册功能使用的是邮箱注册登录，在本地测试下如果没有配置邮箱功能，就不能注册，如需测试使用，请使用：

```text
用户名：baymax 密码：s123456
```

### 更改图片上传地址（如果一样的话就可以不用更改）

本地通过开启nginx服务进行静态访问。前端在.env文件中更改图片服务器的地址。

后端在`fte-service/fte-file-service/src/main/resources/application.yml`更该文件保存的路径，并启动`Nginx`服务器把该路径作为服务器逻辑。

> 如果更改了配置，记得在前端`.env`中更改图片地址，要不然图片加载不出来

``` text
#前端.env
VITE_FILE_PATH=http://localhost:10030
```

### 更换 公钥和私钥（可选）

```shell
keytool -genkeypair -alias jwt -validity 3650 -keyalg RSA -dname "CN=jwt,OU=jtw,O=jwt,L=zurich,S=zurich, C=CH" -keypass 12345 -keystore jwt.jks -storepass 12345
```

把这个文件放到认证服务器的resouces目录下

```shell
keytool -list -rfc --keystore jwt.jks | openssl x509 -inform pem -pubkey
```

复制公钥到资源服务器的resouces目录下，public.cert

### 更换邮箱和密码 （可选）

> fte-service/fte-mails-service/src/main/resources/application.yml

```text
  mail:
    #smtp服务主机  qq邮箱则为smtp.qq.com
    host: smtp.qq.com
    port: 587
    #服务协议
    #    protocol: smtps
    # 编码集
    default-encoding: UTF-8
    nickname: baymax
    #发送邮件的账户
    username: youremail 
    #授权码
    password: password
```

### 更换 第三方登录信息（可选）

> fte-service/fte-user-service/src/main/resources/application.yml

```text
justauth:
  enabled: true
  type:
    gitee:
      client-id: idorkey
      client-secret: idorkey
      redirect-uri: http://127.0.0.1:3030/uapi/public/user/login/GITEE/callback
    qq:
      client-id: idorkey
      client-secret: idorkey
      redirect-uri: http://127.0.0.1:3030/uapi/public/user/login/gitee/callback
    github:
      client-id: idorkey
      client-secret: idorkey
      redirect-uri: http://127.0.0.1:3030/uapi/public/user/login/github/callback
```

## 知识点总结

### 自动批卷

待补充

### 班级码生成

待补充

### 遗传组卷

主要思路参考：[GADemo](https://github.com/jslixiaolin/GADemo)，根据需求更改了大部分的逻辑，如初始化种群的时候根据配置，分配题型等

遗传算法是一种模拟自然界中生物进化过程的优化算法，它可以用来解决一些复杂的组合优化问题，比如自动组卷。自动组卷就是根据一定的规则和要求，从题库中选取合适的试题，生成试卷的过程。

遗传算法自动组卷的基本思想是：将每张试卷看作一个个体，每个个体由一串编码表示，编码中包含了试题的信息。然后对初始种群进行选择、交叉和变异等操作，产生新的种群，并根据适应度函数评价每个个体的质量。重复这个过程直到满足终止条件或达到最大迭代次数，输出最优或较优的个体作为最终试卷。

## 待完善功能

- [ ] 通过定时器，在考试开始前将考试信息放入缓存，考试结束后将未提交的自动提交
- [ ] 自定义第三方登录
- [ ] 校园认证
- [ ] 后台管理功能

qiuquanRealMan/exam

简介

发行版

贡献者

近期动态

qiuquanRealMan/exam .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

qiuquanRealMan/exam