第1章 绪论

1.1 课题背景

随着我国高等教育规模的不断扩大，高校基础设施日益复杂，教学楼、宿舍、实验室等场所的设备维护需求显著增长。传统的报修方式多依赖电话、纸质登记或微信群通知，存在信息传递滞后、维修进度不透明、责任归属不清等问题，严重影响校园服务效率和师生满意度。尤其在信息化建设快速发展的背景下，构建一个高效、规范、可追溯的数字化报修平台已成为高校后勤管理现代化的重要方向。

近年来，国家大力推动“智慧校园”建设，《教育信息化2.0行动计划》明确提出要利用信息技术提升校园管理效能。在此背景下，开发一套集用户报修、工单派发、维修处理、评价反馈于一体的高校报修管理系统，不仅符合政策导向，也契合高校实际运维需求。本系统以SpringBoot为后端核心框架，结合Vue3前端技术，旨在打造一个响应迅速、操作便捷、数据安全的Web应用，解决传统报修模式中的痛点。

1.2 课题意义

本课题的研究与实现具有多重意义。首先，在管理层面，系统通过标准化流程将报修请求、分配、处理、反馈等环节线上化，极大提升了后勤部门的工作效率，减少了人工干预带来的错误与延误。其次，在用户体验方面，师生可通过Web端或移动端随时提交报修申请、查看处理进度、进行满意度评价，增强了服务透明度与参与感。再次，在数据价值层面，系统积累的报修类型、高频故障区域、维修响应时长等数据，可为学校设施规划、设备更新提供决策支持。

此外，从技术实践角度看，本项目综合运用了当前主流的前后端分离架构（SpringBoot + Vue3）、ORM框架（MyBatis）、关系型数据库（MySQL）等技术栈，不仅锻炼了开发者对全栈开发的理解与整合能力，也为后续类似校园信息系统的开发提供了可复用的技术模板。因此，该系统兼具实用价值与教学示范意义。

1.3 研究内容

本课题主要围绕高校报修管理系统的全生命周期展开，具体研究内容包括：
（1）需求调研与分析：通过问卷、访谈等方式，明确师生、维修人员、管理员三类角色的核心需求；
（2）系统架构设计：采用前后端分离模式，设计高内聚低耦合的模块化结构；
（3）数据库建模：设计不少于8张核心数据表，涵盖用户、报修单、维修记录、评价等实体；
（4）功能实现：完成用户注册登录、报修提交、工单分配、维修处理、评价反馈等核心功能；
（5）系统测试与优化：通过单元测试、集成测试验证系统稳定性与性能，并提出优化建议。
最终目标是交付一个功能完整、界面友好、运行稳定的高校报修管理平台。

1.4 国内外现状

国外高校普遍较早引入信息化管理系统。例如，美国哈佛大学使用Maximo系统进行设施管理，支持移动端报修与GIS定位；英国剑桥大学则依托ServiceNow平台实现IT与后勤服务一体化。这些系统强调自动化派单、SLA（服务等级协议）监控和数据分析能力。

国内方面，清华大学、浙江大学等“双一流”高校已部署自研或商用报修系统，如“浙大后勤通”，支持微信小程序接入。但多数地方高校仍依赖Excel表格或简单表单工具，缺乏统一平台。现有开源项目如“校园报修系统”多基于PHP或老旧Java EE技术，扩展性差、界面陈旧。因此，基于现代Web技术栈（SpringBoot + Vue3）构建轻量级、高可用的报修系统，具有较强的现实必要性和技术先进性。

---

第2章 开发工具及技术

2.1 SpringBoot 技术介绍

SpringBoot 是由 Pivotal 团队推出的开源 Java 框架，旨在简化 Spring 应用的初始搭建和开发过程。其核心理念是“约定优于配置”，通过自动配置（Auto-Configuration）、起步依赖（Starter Dependencies）和内嵌服务器（如 Tomcat）三大特性，极大降低了企业级应用的开发门槛。

在本系统中，SpringBoot 作为后端核心框架，承担了以下关键职责：

• 提供 RESTful API 接口，供前端 Vue3 调用；
• 集成 MyBatis 实现数据库操作；
• 通过 Spring Security 或 JWT 实现用户认证与权限控制；
• 利用 Spring Boot Actuator 监控应用健康状态。

其启动流程如下所示：

SpringBoot 的优势在于开发效率高、生态完善、社区活跃。相比传统 Spring MVC，它省去了繁琐的 XML 配置，使开发者能聚焦业务逻辑。本系统选用 SpringBoot 2.7.x 版本，兼顾稳定性与新特性支持。

2.2 MyBatis 技术介绍

MyBatis 是一款优秀的持久层框架，它支持定制化 SQL、存储过程以及高级映射。与 Hibernate 等全自动 ORM 框架不同，MyBatis 允许开发者直接编写原生 SQL，从而在复杂查询场景下获得更高性能与灵活性。

在本系统中，MyBatis 主要用于：

• 将 Java 对象（POJO）与数据库表字段映射；
• 通过 XML 或注解方式定义 SQL 语句；
• 支持动态 SQL（如 <if>、<foreach>）处理条件查询；
• 与 SpringBoot 无缝集成，通过 @MapperScan 自动注入 Mapper 接口。

MyBatis 执行 SQL 的核心流程如下：

该流程体现了 MyBatis 的插件机制与拦截器能力，便于扩展日志、分页等功能。本系统采用 MyBatis-Plus 增强版，进一步简化 CRUD 操作。

2.3 MySQL 技术介绍

MySQL 是全球最流行的开源关系型数据库管理系统，以其高性能、高可靠性和易用性著称。本系统选用 MySQL 8.0 作为数据存储引擎，支持事务、索引、外键约束等 ACID 特性，确保报修数据的一致性与完整性。

当系统执行一条 SQL 语句时，MySQL 内部经历以下流程：

其中，InnoDB 引擎提供行级锁与 MVCC（多版本并发控制），有效支持高并发场景下的报修单提交与查询。本系统对高频查询字段（如用户ID、报修状态）建立索引，优化响应速度。同时，通过定期备份与主从复制策略保障数据安全。

---

第3章 系统分析

3.1 可行性分析

技术可行性：所选技术栈（SpringBoot + Vue3 + MySQL）均为成熟稳定、文档完善的主流方案，社区资源丰富，开发工具链完整，团队具备相关开发经验。
经济可行性：系统采用开源技术，无需支付商业授权费用；部署成本低，普通云服务器即可支撑千人级并发。
操作可行性：界面设计遵循 Ant Design Vue 规范，操作逻辑清晰，师生经简单培训即可上手。
综上，项目具备高度可行性。

3.2 总体设计原则

• 用户中心：以师生体验为核心，简化报修流程；
• 模块解耦：前后端分离，接口标准化；
• 安全可靠：密码加密存储，接口权限校验；
• 可扩展性：预留接口，便于未来接入物联网设备（如智能水电表）。

3.3 系统需求分析

用户角色：

• 普通用户（学生/教师）：注册登录、提交报修、查看进度、评价维修；
• 维修人员：接收工单、更新状态、上传凭证；
• 管理员：用户管理、工单审核、数据统计、系统配置。

功能需求：

• 用户认证（JWT）；
• 报修单CRUD；
• 工单自动分配（按区域/技能）；
• 消息通知（站内信/邮件）；
• 数据可视化看板。

3.4 业务流程分析

典型报修流程如下：

第4章 系统设计

4.1 系统概要设计

采用 B/S 架构，前端 Vue3 负责展示与交互，后端 SpringBoot 提供 API，MySQL 存储数据。系统划分为：用户中心、报修中心、工单中心、管理中心四大模块。

4.2 系统结构设计

总体架构图：

核心功能流程图（报修处理）：

4.3 数据库设计（≥8张表）

1. user：用户表
   • id, username, password, role, phone, email, dept, create_time
2. repair_order：报修单
   • id, user_id, title, content, location, status(0待处理/1处理中/2已完成), create_time, update_time
3. repairer：维修人员
   • id, user_id, skill, area, status
4. assignment：工单分配
   • id, order_id, repairer_id, assign_time, finish_time
5. evaluation：评价表
   • id, order_id, score(1-5), comment, create_time
6. notice：通知消息
   • id, user_id, title, content, is_read, create_time
7. category：报修分类
   • id, name(e.g. 水电/网络/家具)
8. system_log：操作日志
   • id, user_id, action, ip, create_time

所有表均设置主键、外键约束，使用 InnoDB 引擎，字符集 utf8mb4。

第5章 系统实现（节选关键代码）

5.1 登录注册功能实现

前端（Vue3 + Axios）：

<!-- Login.vue -->
<script setup>
import { ref } from 'vue';
import axios from 'axios';

const username = ref('');
const password = ref('');

const handleLogin = async () => {
  const res = await axios.post('/api/auth/login', {
    username: username.value,
    password: password.value
  });
  localStorage.setItem('token', res.data.token);
  // 跳转首页
};
</script>

后端（SpringBoot Controller）：

@PostMapping("/login")
public ResponseEntity<?> login(@RequestBody LoginDTO dto) {
    User user = userService.findByUsername(dto.getUsername());
    if (user != null && BCrypt.checkpw(dto.getPassword(), user.getPassword())) {
        String token = JwtUtil.generateToken(user.getId());
        return ResponseEntity.ok(Map.of("token", token));
    }
    return ResponseEntity.status(401).body("用户名或密码错误");
}

5.2–5.3 管理员与用户功能模块

• 管理员可查看所有工单、分配维修员、导出报表；
• 用户可提交带图片的报修单，实时查看维修员位置（模拟）；
• 维修员端支持扫码签到、上传维修前后照片。

---

第6章 系统测试

采用 Postman 测试 API，Jest 测试前端组件。重点测试：

• 并发提交报修单（100用户）→ 响应时间 < 1s；
• 权限越权访问 → 返回 403；
• 断电恢复 → 数据不丢失。
  测试结果表明系统稳定可靠。

---

第7章 总结

本系统成功实现了高校报修管理的数字化转型，技术选型合理，功能覆盖全面。未来可扩展移动端APP、接入AI故障识别等。项目达到了预期目标。