学生宿舍管理系统开发手记：从零搭建一个“智能宿管“（附详细代码）

一、为什么你的学校需要这个系统？

最近帮朋友学校开发宿舍管理系统（他们还在用Excel登记你敢信？！），发现这真是个刚需啊！传统管理方式存在三大致命伤：

1. 查寝记录像天书（字迹潦草+纸质易损）
2. 报修流程堪比马拉松（要跑三个办公室盖章）
3. 宿舍分配全看宿管心情（说好的公平呢？）

二、系统核心功能大揭秘

2.1 学生信息管理（宿管阿姨的福音）

• 批量导入新生数据（支持Excel直接上传）
• 自动生成学号-宿舍号对应关系
• 人脸识别闸机对接方案（这个要看学校预算）

// 示例：学生实体类
@Data
public class Student {
    private Long id;
    private String studentId;  // 学号
    private String name;
    private String gender;
    private String className;
    private String dormNumber; // 格式：楼号-房间号 如"3-205"
    private LocalDateTime checkInDate; 
}

2.2 智能宿舍分配算法（再也不用背黑锅！）

核心逻辑：

1. 优先同专业同班级分配
2. 考虑学生身高（上下铺安排）
3. 特殊需求标注（如：需要下铺）

-- 宿舍表结构示例
CREATE TABLE dorm (
    id INT PRIMARY KEY AUTO_INCREMENT,
    building VARCHAR(10) NOT NULL,  -- 楼号
    room_number VARCHAR(4) NOT NULL, -- 房间号
    total_beds TINYINT DEFAULT 4,    -- 床位总数
    available_beds TINYINT,          -- 剩余床位
    is_full TINYINT(1) DEFAULT 0     -- 是否住满
);

2.3 报修管理系统（告别纸质工单）

功能亮点：

• 扫码报修（宿舍门口贴二维码）
• 维修进度实时推送
• 维修评价体系（治好了维修工的拖延症）

三、那些年我们踩过的坑

3.1 并发冲突问题（抢宿舍大战）

去年迎新时发生的真实案例：两个学生在不同终端同时选择3-205宿舍，结果都显示申请成功？！
解决方案：

@Transactional
public boolean assignDorm(String studentId, String dormNumber) {
    // 使用乐观锁机制
    Dorm dorm = dormMapper.selectForUpdate(dormNumber); 
    if(dorm.getAvailableBeds() > 0){
        dorm.setAvailableBeds(dorm.getAvailableBeds() - 1);
        dormMapper.updateById(dorm);
        // 更新学生表
        return true;
    }
    return false;
}

3.2 数据可视化大屏（领导最爱）

使用ECharts实现的三大看板：

1. 宿舍入住率热力图
2. 报修类型词云图
3. 违规记录趋势图

<!-- Vue组件示例 -->
<template>
  <el-row :gutter="20">
    <el-col :span="12">
      <heat-map :data="occupancyData"/>
    </el-col>
    <el-col :span="12">
      <word-cloud :words="repairKeywords"/>
    </el-col>
  </el-row>
</template>

四、手把手部署教程

4.1 环境准备（小白友好版）

1. JDK 11+ （别再用Java8啦）
2. MySQL 8.0 （注意编码要设utf8mb4）
3. Node.js 16+

# 后端启动命令
mvn spring-boot:run

# 前端启动
npm install && npm run dev

4.2 重要配置项清单

• application.yml 中的数据库连接
• 微信推送配置（用于通知功能）
• 文件存储路径设置（千万别用绝对路径！）

五、未来升级方向

正在开发的2.0版本功能：

1. 智能电表对接（超额用电自动预警）
2. 人脸识别晚归检测（别想翻墙！）
3. 宿舍生活指数评分（卫生+纪律+学习）

（注：部分功能需学校授权，严禁私自开发宿舍监控功能）

六、总结

开发这样的系统就像搭乐高——把各个功能模块组合起来的过程充满乐趣。本文实现的1.0版本已经包含：

• ✅ 基础信息管理
• ✅ 智能分配算法
• ✅ 全流程报修系统
• ✅ 数据可视化看板

完整代码已开源在Github（这里不贴地址，自己搜索项目名），遇到问题欢迎在issues区交流。记住：任何系统都要以人为本，技术只是手段，千万别让管理系统成了"监控利器"！