1. 项目背景与核心需求
高校宿舍管理一直是校园后勤工作的重点难点。传统的人工登记、Excel表格管理方式存在数据易丢失、统计效率低、信息更新滞后等问题。我曾参与过某高校的宿舍管理信息化改造项目，亲眼目睹了管理员们每天需要手工核对数百个床位信息、处理调宿申请时的混乱场景。
这个基于Spring Boot的宿舍全流程管理系统，正是为了解决以下痛点：
- 学生住宿信息分散在多个Excel中，查询一个学生的住宿历史需要翻找多个文件
- 调宿申请需要学生跑多个部门盖章，流程平均耗时3-5个工作日
- 水电费收缴依赖人工抄表，经常出现漏抄、误抄情况
- 宿舍维修响应慢，报修信息经常在传递过程中丢失
2. 技术选型与架构设计
2.1 为什么选择Spring Boot
在技术选型阶段，我们对比了传统的SSM框架和Spring Boot：
- 开发效率：Spring Boot的自动配置让项目搭建时间从原来的2天缩短到2小时
- 维护成本：内嵌Tomcat避免了复杂的服务器环境配置
- 扩展性：Starter机制方便后续集成消息队列、监控等功能
- 社区支持：遇到问题时Stack Overflow上的解决方案更丰富
实测中，一个简单的CRUD接口开发时间从SSM的4小时减少到Spring Boot的30分钟。
2.2 数据库设计要点
MySQL的表结构设计有几个关键决策点：
-
宿舍楼表(dorm_building)
- 添加geo_location字段存储经纬度，为后续地图导航功能预留
- 使用tinyint存储楼层数而非varchar，避免无效数据
-
学生住宿表(student_dorm)
- 采用逻辑删除而非物理删除，保留住宿历史记录
- 建立(building_id, room_no, bed_no)联合唯一索引，防止床位重复分配
-
维修工单表(maintenance_order)
- 使用状态机模式设计status字段(0待接单 1处理中 2已完成 3已评价)
- 添加urgent_level紧急程度字段实现智能派单
sql复制CREATE TABLE `student_dorm` (
`id` bigint NOT NULL AUTO_INCREMENT,
`student_id` varchar(20) NOT NULL COMMENT '学号',
`building_id` int NOT NULL COMMENT '楼栋ID',
`room_no` varchar(10) NOT NULL COMMENT '房间号',
`bed_no` varchar(5) NOT NULL COMMENT '床位号',
`check_in_date` date NOT NULL COMMENT '入住日期',
`check_out_date` date DEFAULT NULL COMMENT '退宿日期',
`is_deleted` tinyint DEFAULT '0' COMMENT '0未删除 1已删除',
PRIMARY KEY (`id`),
UNIQUE KEY `idx_building_room_bed` (`building_id`,`room_no`,`bed_no`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
3. 核心功能模块实现
3.1 智能分房算法
传统随机分房方式常引发学生矛盾。我们设计的算法考虑以下因素：
- 专业相近原则：同专业优先分配同楼层
- 作息时间匹配：通过问卷收集作息习惯数据
- 特殊需求标记：如残疾学生自动分配低楼层
算法核心代码片段：
java复制public List<RoomAssignment> autoAssign(List<Student> students) {
// 按专业分组
Map<String, List<Student>> majorGroups = students.stream()
.collect(Collectors.groupingBy(Student::getMajor));
// 可用房间查询（考虑楼层、空床位数等条件）
List<DormRoom> availableRooms = dormRoomMapper.selectAvailableRooms();
// 分配逻辑
return majorGroups.entrySet().stream()
.flatMap(entry -> {
String major = entry.getKey();
List<Student> majorStudents = entry.getValue();
return assignByMajor(majorStudents, availableRooms);
})
.collect(Collectors.toList());
}
3.2 微信小程序集成
为方便学生操作，我们开发了配套微信小程序，关键技术点：
-
微信登录对接
- 使用WxJava SDK处理登录凭证校验
- 学生信息与微信账号绑定采用加密存储
-
模板消息推送
- 维修进度变更时自动推送通知
- 水电费欠费提醒定时任务
properties复制# application-wechat.properties
wx.app-id=your_app_id
wx.app-secret=your_app_secret
wx.token-storage=redis
4. 系统安全与性能优化
4.1 安全防护措施
在安全审计中发现并修复的典型问题：
-
SQL注入风险
- 使用MyBatis的#{}语法替代${}
- 对管理端接口添加SQL关键词过滤
-
越权访问漏洞
- 实现自定义注解@PreAuthorize("hasRole('ADMIN')")
- 学生只能查询自己的住宿信息
-
日志脱敏处理
- 身份证号、手机号等敏感信息显示为***
- 使用AOP统一处理controller日志
4.2 性能调优实战
当数据量达到10万级时出现的性能问题及解决方案：
-
分页查询优化
- 错误做法：
LIMIT 100000, 20 - 正确方案：
WHERE id > last_id LIMIT 20
- 错误做法：
-
缓存策略
- 宿舍楼基本信息缓存24小时
- 使用Redis的zset实现维修工单优先级队列
java复制@Cacheable(value = "buildingInfo", key = "#buildingId")
public DormBuilding getBuildingInfo(Integer buildingId) {
return dormBuildingMapper.selectById(buildingId);
}
5. 部署与运维方案
5.1 多环境配置
通过Spring Profiles实现：
- dev环境：使用H2内存数据库快速测试
- test环境：与生产相同配置的独立MySQL
- prod环境：MySQL主从集群+读写分离
yaml复制# application-prod.yml
spring:
datasource:
url: jdbc:mysql://master.db:3306/dorm?useSSL=false
username: prod_user
password: ${DB_PASSWORD}
hikari:
maximum-pool-size: 20
5.2 监控告警体系
-
Prometheus监控指标
- 接口响应时间
- 数据库连接池使用率
- 缓存命中率
-
关键业务告警
- 宿舍分配失败率>5%
- 维修单超时未处理
- 数据库慢查询报警
6. 项目演进与扩展
在实际运行半年后，我们根据用户反馈新增了以下功能：
-
疫情管控模块
- 宿舍出入记录扫码登记
- 体温异常自动预警
-
物品报修图像识别
- 学生上传损坏物品照片
- 使用OpenCV自动分类报修类型
-
能耗分析看板
- 各楼栋水电用量对比
- 异常消耗自动检测
这个项目给我的深刻体会是：好的管理系统不仅要技术先进，更要深入理解业务场景。比如最初设计的调宿流程需要5步审批，后来简化为"学生申请-辅导员审核"两步模式，用户体验大幅提升。建议开发这类系统时，至少要跟班观察管理员日常工作2-3天，才能真正抓住痛点。