数据库系统和信息管理 课程项目 (2023/6)

原始需求

• 教师：

1. 教师登录
2. 教师个人信息修改
3. 查询自己教授的课程以及已选课的学生信息
4. 录入教师授课的某课程的所有学生成绩
5. 其它(如统计课程的平均分，最高分，最低分，作试卷分析等…)

• 学生：

1. 学生登录
2. 学生个人信息修改
3. 学生可选课程浏览
4. 学生选课（增删改自己的选课记录）
5. 学生的课表浏览
6. 学生所选课程的成绩查询
7. 其它（如GPA计算，自动提醒成绩、选课时间等…）

前端

• 主要语言: Vue, TypeScript

主要涉及到的技术/框架

1. Vue 3, 前端框架
2. Element Plus, 界面组件库
3. Vue Router, 路由组件
4. Pinia, 状态组件

后端

请求接口在后端启动后进入 Swagger UI 查看

• 主要语言: Java

主要涉及到的技术/框架

1. Spring Boot, 后端框架
2. MySQL, 数据库
3. MyBatis + MyBatis-Plus, 持久层框架
4. Alibaba Druid, 数据库连接池

注意事项

在本项目中，你可能会遇到：

1. 周末也不得不学习的学生
2. 影流教派出身的老师
3. 上课→吃饭→继续上同一门课

另外：

1. 没有排课功能，提供的数据里课都是手动排的
2. 选课是随便选，除了课容量没有其他限制
3. 请求接口可能不完全符合 RESTful API
4. 因为项目比较简单，所以大部分业务都写在 Controller 里了
5. 项目中的用户密码以明文存储，甚至还能直接在开发者工具里看到
6. 因为数据量小，所以没有做分页
7. 前后端对接写得很烂，swagger 上看到的返回格式基本上和实际接收的时候都不一样
8. 没有做缓存，每次重复访问一个接口都会重新从数据库取数据

运行

在这之前，先启动 MySQL 服务.

数据库准备

以下步骤在命令行中执行，也可以使用 DBeaver、Navicat 等工具替代

1. 登录数据库 mysql -u root -p, 输入密码

2. 创建数据库

   CREATE DATABASE dbsim;

   可以使用其他的数据库名，但是要在后面的步骤中同步修改。

3. 退出数据库

   exit;

4. 导入数据，这一步需要输入密码

   mysql -u root -p dbsim < one-step-setup.sql
   

   导入用的脚本文件 one-step-setup.sql 文件已在 ./dbutil 中提供。如果提示文件不存在，请使用绝对路径。

   还需要注意的是，在 PowerShell 中这条命令无法执行，请使用 cmd.

5. 再次进入数据库，即重复第 1 步

6. 创建用户

   CREATE USER 'dbsim'@'localhost' IDENTIFIED BY 'ilovescu';

   可以使用其他的用户名和密码，但是要在后面的步骤中同步修改。

7. 给用户授权

   GRANT ALL PRIVILEGES ON dbsim TO 'dbsim'@'localhost';

后端

1. 进入 backend 文件夹

2. 如果在前面配置数据库的步骤中修改了数据库或者用户的名称和密码，那么到 /src/main/resource 下的 application.properties 文件中进行相应更改。

3. 进入命令行，在 backend 文件夹下运行 mvnw spring-boot:run.

   使用 IDEA 打开项目然后运行也是可以的

   如果提示 JAVA_HOME 相关的问题，请先配置好 Java 环境；

   本项目是基于 Java 17 开发的，能否使用低版本启动暂不明确，如果出现问题请尝试使用正确的版本；

   第一次运行会下载依赖，请耐心等待；

   这一步可能因网络原因进度缓慢或无法完成，请自行解决。

前端

1. 安装 node.js

   到 node.js 的官网 下载并安装 18.16.0 版本

2. 进入 frontend 文件夹

   进入命令行，执行 npm i && npm run dev

   这一步可能因网络原因进度缓慢或无法完成，请自行解决。

3. 浏览器打开 http://localhost:8000 即可进入系统

功能测试

由于时间和个人能力原因，本项目没有使用测试框架，以下测试均为手动完成。

测试需要同时在学生端和教师端进行操作，分别使用浏览器正常模式和无痕模式或者使用两个不同的浏览器都是可以实现的。测试涉及到的账号信息会在表中列出，便于复现。

1. 登录测试

   输入正确和错误的ID、密码，观察行为是否正确。

2. 用户信息 (密码) 修改测试

   修改密码后使用新密码登录，观察能否登录成功。

3. 数据过滤条件测试

   在有查询条件的页面 (学生选课，教师课程管理) 输入一些条件后点击查询按钮，观察结果是否正确。

4. 选课测试

   a) 学生任选一门课程。然后查看课程表是否有该课程；

   b) 在对应的授课教师账号中查看学生名单是否改变；

   c) 使用其他没有选这门课的学生的账号查看该科的选课人数是否改变。

5. 退课测试

   与选课测试相对应，这里不再赘述。

6. 成绩修改测试

   a) 教师选择一门课程，选一个 0 分的学生，将其成绩修改为59；

   b) 在该学生的账号下观察绩点、加权平均分和不及格课程数是否变化，观察退课列表中这门课是否消失；

   c) 教师再将该成绩改为 60 分及以上；

   d) 在该学生的账号下观察绩点、加权平均分、已修学分数和不及格课程数是否变化。

使用的账号信息：

角色	ID	密码
学生	1000000	8D!Q&nRa_0K6
教师	100083	Q1ePmDzWf$8B

其他账号信息可到 student 和 instructor 表中找到.

已知问题

1. 在以学生/教师身份登录时，可以手动输入链接进入教师/学生的界面
2. 一个用户可以在多处登录

主要参考资料

1天搞定SpringBoot+Vue全栈开发 (bilibili.com)