QG Studio 后端组考核

Appearance

宿舍报修管理系统（SpringBoot） ​

（4月1号23点59分截止）

一、前言 ​

一轮考核第二、三周任务合并发布

第一周我们已经完成了数据库设计，并借助框架实现了基础 CRUD 操作。

从本周开始，第二周与第三周任务合并发布：你需要将第一周的业务迁移到 Spring Boot 项目中，设计 RESTful API，补齐登录鉴权、学生报修、管理员管理等核心能力，并完成一个可实际使用的前端页面。

如果你第一周已经直接使用 Spring Boot 开发，可以在原项目基础上继续完善，无需回退到控制台版本。

本轮学习重点 ​

  1. 掌握 Spring Boot 项目创建与配置，将第一周业务迁移到 Spring Boot 中
  2. 掌握 RESTful 接口设计、常见 HTTP 方法与状态码，以及基于 Token（如 JWT）的登录鉴权
  3. 掌握使用前端框架搭建项目，使用 axios 发起请求、接收响应并处理后端数据
  4. 理解前端如何存储并携带 Token，以及常见跨域问题的处理方式

二、基本要求 ​

  • 提交方式：将项目代码继续提交到第一周使用的 GitHub 仓库中
  • 截止时间：2026/04/01 23:59

2.1 后端 ​

  1. 掌握 Spring Boot 项目创建与基础配置
  2. 代码采用三层架构分层
  3. 将第一周的 dao（或 mapper）包下代码整合进 Spring Boot 项目
  4. 设计并实现 RESTful API，覆盖第一周控制台中的全部功能
  5. 创建报修单时新增图片上传功能（非必传）
  6. 管理员查看报修单时可以查看图片，辅助定位设备问题
  7. 登录成功后生成 Token（如 JWT），后续需鉴权的接口应校验 Token
  8. 在文档中说明 Token 的实现方式与存储方式

2.2 前端 ​

  1. 使用前端框架搭建项目，技术栈不限，推荐 Vue2、Vue3 或 React
  2. 理解前后端交互过程
  3. 熟悉前端如何发送请求、接收响应、处理数据
  4. 了解哪些用户操作会触发请求（如点击登录按钮、提交表单、页面加载时）
  5. 了解前端如何渲染数据，并学会处理跨域问题
  6. 将登录鉴权应用到项目中：登录时生成 Token，前端存储并在后续请求中携带
  7. 提交一份「AI 使用与个人贡献说明」

2.3 页面与联调要求 ​

至少完成以下页面，并与后端 API 对接：

  • 登录 / 注册页
  • 学生端：首页（绑定宿舍、创建报修单）
  • 学生端：报修列表（查看记录、取消报修）
  • 管理员端：报修单列表（查看全部、按状态筛选）
  • 管理员端：报修单详情
  • 管理员端：修改状态、删除报修单

所有上述功能需要在你自己的电脑上完整跑通，不能存在阻塞性错误。

页面不做美观性强制要求，简洁易懂、符合常见使用习惯即可，例如删除操作使用危险色、提交操作使用主色。

三、进阶挑战 ​

  1. 将数据库连接参数、账号密码等改为从环境变量文件中读取，避免直接开源敏感信息
  2. 使用 Postman、Apifox、Swagger（推荐 OpenAPI）等工具测试接口，并生成或维护可读的接口文档（URL、方法、请求 / 响应示例）
  3. 设计统一的 HTTP 响应体结构
  4. 实现异常统一拦截
  5. 使用 SLF4J + Logback（或等价日志框架）记录关键流程与异常，不要在正式业务代码中依赖 System.out.println
  6. 实现 Token 持久化（如 localStorage），退出时清除；有能力的同学可继续实现 Token 过期与刷新逻辑
  7. 实现 axios 请求拦截器统一附加 Token，并在响应拦截器中统一处理 401 等情况
  8. 思考前后端代码中有哪些内容可以在其他项目中复用，并尝试抽取出来

四、补充说明 ​

  • 2026/04/04 晚上会发布末期考核题目
  • 2026/04/02 到 2026/04/04 期间，如果你已经完成项目并且愿意分享成果，可以来工一和师兄师姐交流一轮学习体会
  • 是否到场交流不作强制要求，不影响后续参加二轮考核