💼 一个基于规则配置的综合素质评价系统，助力高校更方便、更高效的开展学生综合素质评价工作。

🙌 加入q群一起来玩：715602514

• 重构部分代码
• 优化sql语句，避免在mysql5.8及以上出现某些错误
• 增加新功能（将参赛、获奖等信息导出为pdf；在线制作简历；分享及应用加分配置文件等）

点击观看安装配置视频教程

• 注意一下现在前端和后端合并到一个仓库里面了

  前端项目	后端项目	sql文件	后端静态文件
  front-end	back-end	cqes4cs.sql	files

• JDK，你可以参考这篇文章安装与配置JDK
• MySQL，你可以参考这篇文章使用phpstudy安装MySQL，版本要求，低于v7.0，本项目使用的是v5.6，如果需要使用高版本，请参考后面教程部分将only_full_group_by字段关闭。
• Redis，你可以参考这篇文章安装与配置Redis
• Node.js，你可以参考这篇文章安装与配置Node.js，版本要求：低于v16，本项目使用的是12.17.0
• maven，你可以参考这篇文章安装与配置maven并了解在IDEA中的使用

安装完成后，redis和mysql需要进行配置，具体配置参数请看下面mysql配置和redis配置，保证配置与项目一致

• 前端：Vue，ElementUI，echarts，axios，nprogress，qs
• 后端：springboot，redis，shiro，poi，mybatis
• 数据库：mysql

1. 下载项目压缩包至本地解压，或者使用git clone https://github.com/quarkape/cqes4cs.git克隆项目
2. 进入项目目录，打开命令窗口，执行npm cache clear --force清除缓存
3. 进入项目目录，打开命令窗口，执行npm install，会开始下载前端项目所需要的所有依赖，这可能需要一定的时间
4. 进入项目目录，打开命令窗口，执行npm run serve，会开始运行前端项目
5. 如果需要部署该项目，你需要对前端项目进行构建：进入项目目录，打开命令窗口，执行npm run build，执行完后，项目目录下会生成一个dist文件夹，这个文件夹就是构建之后的文件，可以直接部署

1. 使用mysql -u root -p进入mysql

2. 依次执行下面的四条命令：

   # 创建名为cqes4cs的数据库
   create database cqes4cs;
   # 使用数据库cqes4cs
   use cqes4cs;
   # 设置数据库编码方式
   set names utf8;
   # 下面的source后面是sql文件的位置，例如是G:\Projects\IDEA\cqes4cs\cqes4cs.sql的话就是：
   source "G:\Projects\IDEA\cqes4cs\cqes4cs.sql"

3. 导入数据后，切换到数据库cqes4cs中，查询users表，看是否有一条数据，如果有的话说明导入成功

4. 如果你使用的是phpstudy mysql workbench，你可以观看上述视频教程，了解如何使用mysql workbench将数据快捷导入到数据库中。如果你想要安装使用MySQL WorkBench，你可以参考这篇文章

5. 项目要求的mysql配置可以在：cqes4cs\src\main\resources\application.yml配置文件中找到：

   datasource:
       # 用户名为root
       username: root
       # 密码为root
       password: root
       # 端口为3306，数据库为cqes4cs
       url: jdbc:mysql://127.0.0.1:3306/cqes4cs?serverTimezone=UTC&useUnicode=true&characterEncoding=utf-8
       driver-class-name: com.mysql.jdbc.Driver

   请确保电脑上面的相关配置与项目中的配置保持一致（可以改电脑上的配置，也可以改项目中的配置文件）

6. 安装MySQL之后，如果你的数据库版本是5.7以上的，则需要关闭MySQL的only_full_group_by功能，你可以参考这篇文章关闭MySQL的此项功能

7. 如果有些页面报错，可能是因为mysql关键字的问题。你需要找到请求函数对应的mapper文件，将里面的mysql语句中的关键字用反引号引起来。现已知的关键字包括desc,rank等。如果你不知道怎么定位这些位置，可以在idea中右上角搜索框打开全局搜索，搜索这两个关键字就可以了（只需要修改mapper文件中的mysql语句，其他地方不需要修改）。

1. 项目要求的redis配置可以在：cqes4cs\src\main\resources\application.yml配置文件中找到：

   redis:
       # 端口6379
       port: 6379
       # 密码kkty
       password: kkty
       host: 127.0.0.1

   请确保电脑上面的相关配置与项目中的配置保持一致（可以改电脑上的配置，也可以改项目的配置文件）

1. 下载项目压缩包至本地解压，或者使用git clone https://github.com/quarkape/cqes4csbe.git克隆项目
2. 用IDEA打开项目，IDEA会自动下载pom.xml文件里面的所有依赖，这可能需要一定的时间
3. 下载完成后，运行项目，没有错误说明运行成功
4. 如果需要部署该项目，你需要对后端项目进行打包，进入项目目录，打开命令窗口，执行mvn package对项目进行打包。默认打包为jar包，如果需要更换为war包，请自行搜索相关流程。

1. 找到src\main\java\club\hue\config\下的MvcConfig.java文件并打开，在这个文件下，找到这一行代码:

   registry.addResourceHandler("/files/**").addResourceLocations("file:G:/Projects/Materials/cqes4cs/files/");

   上述代码用于指定静态资源的位置，必须配置正确。你需要将你后端项目中的files文件夹的路径复制，并替换上面代码中的路径。例如，在你的电脑上，你的后端项目中的files文件夹的路径是：G:\Projects\IDEA\cqes4cs\files，那么你需要修改上述代码的后半部分：

   // 你需要注意两点：一是使用正斜杠/，二是路径后面一定要加一个/
   registry.addResourceHandler("/files/**").addResourceLocations("file:G:/Projects/IDEA/cqes4cs/files/");

2. files文件夹下面有两个文件夹是空的，上传到github和gitee上面的时候这两个文件夹没有上传上去，但是要正常使用系统的话必须要这两个文件夹才行，需要你自己根据下面的静态资源结构说明去把configs和material文件夹加上，这两个文件夹分别是存储导出的配置文件和存储学分申请的图片的两个文件夹。

1. 浏览器地址栏输入http://localhost:8080回车进入系统登录页面
2. 登录管理员账号，用户名和密码均为admin
3. 登陆后新建一个教师账号，建议新建一个管理年级为2021的账号，这有助于后续与项目提供的测试数据关联
4. 点击右上角头像，退出管理员账号，登录上一步创建的教师账号
5. 在教师端，点击学生管理，点击上传学生名单，选择后端项目中files\students\test_students_data.xlsx文件上传，用于生成学生数据
6. 在教师端，点击学分评价，点击上传学生成绩，选择后端项目中files\grades\test_grades_data.xlsx文件上传，用于生成学生成绩数据
7. 退出教师账号，登录学生账号，学生账号是可以选择纲刚上传的学生名单文件中的任一学号，初始密码也为学号。一个可用的学号和密码为“51214108037”
8. 在学生端，可以提交学分申请等。至此，基本工作已经差不多完成

├─files
    ├─configs  (导出的配置文件的存储位置)
    │      2bb65d3b-11c0-4073-8a68-99f18dcab1c3.xls
    │      
    ├─exports  （导出的综评结果文件的存储位置）
    │      06c4156c-9939-4d11-b93b-2af496c27d43.xls
    │      
    ├─grades  （上传的学生成绩名单的存储位置）
    │      1660235470069.xlsx
    │      
    ├─material  （学分申请的图片存储位置）
    │      166884104794251214108037.png
    │      
    ├─source
    │      efile.pdf  （综合素质评价文件位置）
    │      grade_example.xlsx  （学生成绩模板文件）
    │      student_list_example.xlsx  （学生名单模板文件）
    │      
    └─students
            1660232101630.xls  （上传的学生名单文件存储位置）

• 提前配置加分规则，减少繁琐的计分过程，提高科学性和效率
• 支持文件导入导出，覆盖常见功能
• 灵活构建评价指标体系，适合不同高校不同专业的培养目标