靳老师想开了1. 项目概述：SpringBoot员工宿舍管理系统
这个系统是我去年为一家中型企业开发的内部管理平台，主要解决传统纸质化宿舍管理效率低、数据易丢失的问题。系统基于SpringBoot 2.7.4开发，整合了MyBatis-Plus和Vue.js，实现了从宿舍分配、费用管理到维修申报的全流程数字化。
关键数据：上线后使宿舍审批流程从平均3天缩短至2小时，每月节省行政人力成本约40%
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心需求解析
2.1 基础信息管理模块
采用RBAC权限模型设计，包含：
- 员工信息（工号、部门、职级）
- 宿舍档案（楼栋、房间、床位类型）
- 设施台账（空调、家具等资产编号）
java复制// 宿舍实体类示例
public class DormRoom {
private String buildingNo; // 楼栋号
private String roomNo; // 房间号
private Integer bedType; // 1-单人间 2-双人间
private BigDecimal area; // 面积(㎡)
private Integer maxPeople; // 最大容纳人数
}
2.2 智能分配算法
根据职级、工龄等权重自动推荐宿舍：
- 主管级默认分配单人间
- 普通员工按入职时间排序选择
- 特殊需求（如夫妻房）可人工调整
避坑经验：初始版本未考虑部门集中需求，导致同部门员工分散在不同楼栋，v2.0增加了部门聚类算法
2.3 费用管理子系统
包含三个计费维度：
| 费用类型 | 计算方式 | 扣款周期 |
|---|---|---|
| 房租 | 按床位均摊 | 月度 |
| 水电 | 独立电表读数 | 月度 |
| 网络 | 固定套餐费 | 季度 |
3. 技术实现细节
3.1 安全防护方案
针对系统特点做了三重防护：
- XSS过滤：自定义HttpServletRequestWrapper
- 数据权限：@DataScope注解实现部门隔离
- 操作日志：AOP记录关键操作IP和行为
java复制// 数据权限拦截器示例
@Around("@annotation(dataScope)")
public Object around(ProceedingJoinPoint point, DataScope dataScope) throws Throwable {
String deptAlias = dataScope.deptAlias();
String userAlias = dataScope.userAlias();
// 注入SQL过滤条件
dataScopeFilter(deptAlias, userAlias);
return point.proceed();
}
3.2 批量导入优化
处理Excel导入时遇到的典型问题：
- 问题：300人同时导入导致OOM
- 方案：采用Apache POI的SAX模式
- 结果：内存占用从2GB降至200MB
3.3 消息通知机制
集成多种提醒方式：
- 企业微信机器人（日常通知）
- 短信网关（紧急维修）
- 邮件提醒（费用逾期）
4. 性能调优实战
4.1 数据库索引策略
关键索引配置表：
| 表名 | 索引字段 | 类型 |
|---|---|---|
| dorm_apply | apply_status, apply_time | 联合索引 |
| fee_payment | room_id, payment_date | 聚簇索引 |
| repair_order | urgency_level | 普通索引 |
4.2 缓存应用场景
使用Redis缓存三类高频数据：
- 宿舍空余床位数（TTL 10分钟）
- 当月水电费单价（TTL 1天）
- 维修工状态（实时更新）
5. 部署方案对比
5.1 传统War包部署
bash复制# Tomcat启动命令
java -Dspring.profiles.active=prod \
-Xms512m -Xmx1024m \
-jar dorm-manager.war
5.2 Docker容器化方案
dockerfile复制FROM openjdk:11-jre
COPY target/dorm-manager.jar /app/
EXPOSE 8080
ENTRYPOINT ["java","-jar","/app/dorm-manager.jar"]
实测对比：容器化后启动时间从25秒降至8秒
6. 典型问题排查记录
6.1 并发分配冲突
现象：两个员工同时申请最后一个床位
解决方案：
- 数据库乐观锁（version字段）
- 分布式锁（Redisson实现）
- 前端防重复提交
6.2 费用计算误差
根本原因：BigDecimal使用不当
正确写法：
java复制// 错误示范
double a = 0.1;
double b = 0.2;
System.out.println(a + b); // 输出0.30000000000000004
// 正确示范
BigDecimal c = new BigDecimal("0.1");
BigDecimal d = new BigDecimal("0.2");
System.out.println(c.add(d)); // 精确输出0.3
7. 扩展功能设计
7.1 访客管理模块
实现流程：
- 员工发起访客申请
- 宿管审核通过
- 生成临时门禁二维码
- 超时自动失效
7.2 能耗分析看板
使用ECharts实现：
- 各楼栋用电对比
- 月度能耗趋势
- 人均费用排名
8. 项目演进建议
-
信创适配：如需迁移到东方通TongWeb，需注意：
- 移除Tomcat特有配置
- 测试JNDI数据源兼容性
- 验证JSP标签支持情况
-
移动端扩展：建议增加微信小程序版本
- 扫码报修
- 费用查询
- 投诉建议
-
智能硬件对接：
- 门禁系统（RFID识别）
- 智能电表（API对接）
- 消防传感器（IoT协议）
这个系统在实际运行中我们发现，宿舍管理员的电脑操作水平参差不齐，后来专门增加了"一键导出所有未缴费名单"这样的快捷功能按钮。建议开发类似系统时，一定要预留至少两周的现场培训时间，很多问题只有在真实使用场景才会暴露出来。