烂人不配爱1. 项目背景与核心价值
高校宿舍管理一直是校园后勤工作的重点难点，传统纸质报修流程存在响应慢、追踪难、统计繁琐等痛点。我在参与某211高校信息化改造时，亲眼目睹宿管阿姨桌上堆积如山的报修单和Excel表格——学生填写纸质单→交到值班室→手工录入电脑→分派维修工→反馈结果，整个流程平均需要3-5天。更糟的是，30%的报修单因字迹潦草或信息不全导致返工。
SpringBoot驱动的在线报修系统正是为解决这些问题而生。通过移动端提交报修请求，系统自动分派并实时追踪进度，将平均处理时间缩短至8小时内。某高校实测数据显示，系统上线后维修满意度从62%提升至89%，工单处理效率提高240%。这个毕业设计选题之所以经典，在于它同时满足了：
- 技术层面：涵盖SpringBoot核心特性（自动配置、Starter依赖、Actuator监控）
- 业务层面：解决实体场景中的流程痛点
- 教学层面：完整覆盖MVC架构、权限控制、文件上传等必备技能点
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 系统架构设计解析
2.1 技术栈选型依据
选择SpringBoot 2.7.x而非最新3.x版本是经过实际考量的：
- 教学环境普遍使用JDK8，而SpringBoot 3.x强制要求JDK17
- MyBatis-Plus 3.5.1与SpringBoot 2.7.x兼容性经过充分验证
- 社区资源丰富，遇到问题更容易找到解决方案
前端采用Thymeleaf+AdminLTE组合而非Vue.js，主要考虑：
- 保持单体架构的简洁性，避免初学前后端分离的复杂度
- AdminLTE提供现成的响应式布局和UI组件
- 模板引擎更利于实现服务端渲染的权限控制
2.2 核心业务流程建模
报修流程的状态机设计是关键难点。我们采用策略模式实现状态流转：
java复制public interface RepairState {
void handle(RepairOrder order);
}
@Component
@RequiredArgsConstructor
public class PendingState implements RepairState {
private final RepairMapper repairMapper;
@Override
@Transactional
public void handle(RepairOrder order) {
order.setStatus("待分配");
repairMapper.updateById(order);
// 发送微信模板消息通知宿管
}
}
状态变迁触发条件通过注解实现：
java复制@PostMapping("/assign")
@StateTransition(from = "pending", to = "assigned")
public Result assignWorker(@RequestBody AssignDTO dto) {
// 分派逻辑
}
3. 核心功能实现细节
3.1 多维度报修分类系统
采用HanLP分词技术实现报修内容智能分类：
java复制public class RepairClassifier {
private static final List<String> ELECTRIC_KEYWORDS =
Arrays.asList("灯泡", "插座", "跳闸");
public String classify(String content) {
List<Term> terms = HanLP.segment(content);
return terms.stream()
.anyMatch(t -> ELECTRIC_KEYWORDS.contains(t.word))
? "电力维修" : "常规维修";
}
}
同时建立三级分类体系：
- 一级分类：水电/家具/网络
- 二级分类：具体设备（如空调、马桶）
- 三级分类：故障现象（漏水、无法启动）
3.2 工单自动分配算法
基于维修工负载均衡的分配策略：
sql复制SELECT worker_id, COUNT(*) as workload
FROM repair_order
WHERE status IN ('assigned','processing')
GROUP BY worker_id
ORDER BY workload ASC
LIMIT 1
结合地理围栏技术，优先分配距离故障点500米内的维修人员。
3.3 文件上传与云存储
采用MinIO实现维修图片的云存储：
yaml复制# application.yml
minio:
endpoint: http://minio.example.com
access-key: ${MINIO_ACCESS_KEY}
secret-key: ${MINIO_SECRET_KEY}
bucket-name: repair-images
封装防重复上传机制：
java复制public String generateFileKey(MultipartFile file) {
return DigestUtils.md5Hex(file.getOriginalFilename()
+ System.currentTimeMillis());
}
4. 关键问题解决方案
4.1 并发报修冲突处理
使用乐观锁防止工单重复分配：
java复制@Update("UPDATE repair_order SET worker_id=#{workerId}, version=version+1
WHERE id=#{orderId} AND version=#{version}")
int updateWorkerWithVersion(@Param("orderId") Long orderId,
@Param("workerId") Long workerId,
@Param("version") Integer version);
4.2 维修进度实时推送
基于SSE（Server-Sent Events）的实现：
java复制@GetMapping("/progress/{orderId}")
public SseEmitter streamProgress(@PathVariable Long orderId) {
SseEmitter emitter = new SseEmitter(3600_000L);
progressEmitters.put(orderId, emitter);
return emitter;
}
// 状态更新时调用
public void notifyProgress(Long orderId, String message) {
SseEmitter emitter = progressEmitters.get(orderId);
if (emitter != null) {
emitter.send(SseEmitter.event().data(message));
}
}
4.3 数据统计分析模块
使用EasyExcel导出维修数据报表：
java复制@ExcelProperty("维修类型")
private String repairType;
@ExcelProperty(value = "处理时长", converter = DurationConverter.class)
private Long duration;
配合Spring Cache实现热点数据缓存：
java复制@Cacheable(value = "repairStats", key = "#buildingNo")
public RepairStats getBuildingStats(String buildingNo) {
// 复杂统计查询
}
5. 部署与性能优化
5.1 Docker化部署方案
多阶段构建的Dockerfile：
dockerfile复制FROM maven:3.8.6-jdk-11 AS build
COPY . .
RUN mvn clean package -DskipTests
FROM openjdk:11-jre-slim
COPY --from=build /target/dorm-repair-*.jar /app.jar
ENTRYPOINT ["java","-jar","/app.jar"]
配合Nginx配置静态资源缓存：
nginx复制location ~* \.(js|css|png)$ {
expires 30d;
add_header Cache-Control "public";
}
5.2 性能调优实战
通过Actuator暴露的metrics端点发现：
- 数据库连接池经常达到max-size
- /api/repair/list平均响应时间超过800ms
优化措施：
- 调整HikariCP配置：
yaml复制spring:
datasource:
hikari:
maximum-pool-size: 20
connection-timeout: 30000
- 为工单列表添加Redis缓存：
java复制@Cacheable(value = "repairOrders", key = "#queryDto.hashCode()")
public Page<RepairOrderVO> queryRepairs(RepairQueryDTO queryDto) {
// 查询逻辑
}
6. 安全防护方案
6.1 权限控制体系
基于RBAC模型的权限设计：
sql复制CREATE TABLE `sys_role` (
`id` bigint NOT NULL AUTO_INCREMENT,
`name` varchar(50) NOT NULL COMMENT '宿管/维修工/学生',
`code` varchar(20) NOT NULL,
PRIMARY KEY (`id`)
);
CREATE TABLE `sys_role_menu` (
`role_id` bigint NOT NULL,
`menu_id` bigint NOT NULL
);
接口级权限通过注解控制：
java复制@PreAuthorize("hasRole('repair_admin') || #userId == authentication.principal.id")
public void cancelOrder(Long userId, Long orderId) {
// 撤单逻辑
}
6.2 敏感数据保护
维修地址脱敏处理：
java复制public String desensitizeAddress(String address) {
return address.replaceAll("(\\d+)栋", "***栋")
.replaceAll("(\\d+)寝室", "***室");
}
采用Jasypt加密配置文件：
bash复制# 启动时传入加密密码
java -jar -Djasypt.encryptor.password=secret app.jar
7. 项目扩展方向
7.1 物联网设备对接
通过MQTT协议接收智能水电表的异常报警：
java复制@Bean
public MqttPahoClientFactory mqttFactory() {
DefaultMqttPahoClientFactory factory = new DefaultMqttPahoClientFactory();
factory.setServerURIs("tcp://iot.example.com:1883");
return factory;
}
7.2 维修知识图谱构建
基于历史工单数据训练故障诊断模型：
python复制# 使用TF-IDF+随机森林构建分类器
from sklearn.feature_extraction.text import TfidfVectorizer
from sklearn.ensemble import RandomForestClassifier
vectorizer = TfidfVectorizer()
X_train = vectorizer.fit_transform(repair_descriptions)
clf = RandomForestClassifier().fit(X_train, repair_types)
7.3 移动端深度优化
Uniapp跨平台方案的核心配置：
javascript复制// manifest.json
{
"app-plus": {
"nvueCompiler": "uni-app",
"nvueStyleCompiler": "uni-app"
}
}
这个项目最让我有成就感的，是看到学生从"马桶坏了"这样模糊的报修描述，逐渐转变为"3栋205马桶水箱进水阀故障"的专业描述——系统通过结构化表单和智能提示，潜移默化培养了用户的精准表达能力。建议在迭代中加入维修知识库弹窗功能，当用户选择"马桶漏水"时，自动显示常见原因示意图，这将进一步提升报修信息质量。