寝室管理系统开发实践
项目链接:https://github.com/Dorian7Alden/DormitoryManageSystem
说明:水电费功能来自校园内部的接口,属于内网接口,使用的 Python 本地爬虫项目定时向数据库更新数据,项目中代码没有体现。
回忆录
开发时间是在大二上,从 2025-08-03 到 2025-12-18,共 33 次 commits,后面有 3 次是微调 README 之类的。

这个项目的灵感,来自于我这个 “寝室长” ,在安排卫生清洁打扫的时候,十分麻烦,谁清理了什么,做了多少次,该谁做卫生了,难以统计追踪,于是希望通过开发一个工具来解决这个问题。
结合我刚学完 Vue 前端跟 Springboot 后端,于是打算开始手搓。
再加上,我参加了数学建模比赛,突发奇想,可以给清洁卫生的清理进行评价模型的建模,不同麻烦程度的清洁任务打分,然后统计每个室员的贡献值,原本打算搞个清洁贡献评价模型的,后来嫌麻烦没搞。
当时自己开了阿里云的服务器,结合 AI 的指导,完成了项目的部署。让我印象最深的坑,就是云服务器的端口开放策略,不仅仅要在阿里云服务器管理界面手动配置安全策略开放端口,还要在服务器内部系统自己执行指令开发本机的端口,必须得两个地方同时开发才能正常开放,相当于是阿里云厂商自己多加了一层拦截设置。也算是积累了经验,在懵懂中踩坑、探索。
当时还踩了一个坑,我对 git 的使用不熟练,把源代码整没了,只有部署在服务器上的编译打包后的代码,不得不重新再开发第二个版本。
让我难忘的还有一个点,就是 Echart 的使用,我当时整了好久都没整明白,让 AI 整也没整明白,到底怎么配置,还去网上找教程,到底怎么用。
当时正巧还有个宿舍评比活动,这个 web 移动端 app 还拿了个创意赛道的二等奖。
当时还顺带把这个项目作为了《用户分析与设计》的作业项目。
项目在开发的时候,是学了《系统分析与设计》这们课的。
令我印象比较深的一个点是,在使用前端组件,例如 Element Plus 时,有些组件需要自定义样式的,直接在原来的基础上加样式无法覆盖,好像得 “透穿” 之类的,样式的优先级需要控制,当时搞半天都没整明白到底是那个类生效的,调试的时候也很麻烦,一个一个 class 的覆盖尝试,没找到方法,原始组件的样式太多了,没有分析源代码。当时觉得用别人的,还不如自己写一个轻量的。
项目收获关键词:Springboot、跨域、pdman 工具、系统分析与设计、登录校验、前端导包、响应式布局、邮箱验证、Echarts、服务器部署、Git 管理、定时任务、多维动态分页查询、对象存储管理等。
原始技术栈
前端
- vue3、element-plus、vue router、pinia、axios、vant、echarts、vue-echarts
后端
- springboot、mybatis、shiro、spring scheduled、jwt
数据库
- mysql、redis
原始 README


寝室管理系统
项目介绍
寝室管理系统是一款专为高校寝室打造的智能化管理工具,旨在解决传统寝室管理中分工模糊、统计繁琐、信息分散等问题,通过数字化手段实现寝室事务的高效协同与规范化管理,为寝室成员营造整洁、有序、便捷的居住环境。 该系统通过功能模块化设计,覆盖清洁、值日、权限、信息、数据等寝室管理全场景,不仅降低了人工管理成本,还通过数据化、智能化手段保障了管理公平性与高效性,同时整合实用信息与互动功能,提升寝室成员的居住体验与凝聚力,是高校寝室数字化管理的理想解决方案。
核心功能
- 清洁管理与数据统计:自定义分类标签权重,量化成员的贡献
- 值日生智能管理:自动论换周期,自动化管理事务,优化平均贡献
- 权限与公约管理:强化寝室规则意识,养成良好的生活习惯
- 数据爬取与智能提醒:实时更新寝室动态开销,自动化提醒
- 日志与互动功能:生成标准化操作日志,便于复盘管理,积极互动改进
预览图







用例分析
系统配置模块
- 系统初始化配置:首次启动时完成基础参数设置(如寝室编号、成员初始人数、默认寝室长)。
- 环境适配性调整:适配不同设备(电脑端、移动端)的显示与操作逻辑,确保跨设备使用流畅。
- 系统功能说明:提供引导(如新手教程、模块功能入口说明),帮助成员快速熟悉系统用法。
清洁管理模块
- 清洁任务定义与标签管理:用 “标签” 区分不同清洁任务,支持自定义新增 / 删除标签。
- 清洁次数与贡献统计:按 “标签 + 权重” 计算清洁贡献分;自动统计各成员的总清洁次数、各标签任务的单独次数。
- 清洁数据分析:总清洁次数寝室成员排行、单个清洁任务(按标签)的成员排行;每周清洁总次数、每个清洁任务的上一次执行时间。
- 图片记录支持:允许上传清洁完成后的图片(如清洁前后对比图),作为清洁记录的佐证,图片与对应清洁任务 / 成员绑定。
值日管理模块
- 值日生自动轮换:支持自定义轮换规则(如按周轮换、按成员清洁贡献分排序轮换);提前提醒下一轮值日生
- 值日生核心权限与任务:
- 打卡检查:每日打卡确认寝室状态
- 任务管理:根据成员历史清洁贡献分委派清洁任务
- 记录上传:拥有清洁记录(含图片)的审核与上传权限,确保清洁任务真实完成
- 寝室记录管理:记录寝室重大事件(如设备故障、成员违规、集体活动),包含事件时间、描述、处理结果;记录公共开销,上传缴费照片。
公约管理模块
- 寝室长可根据成员提议(关联 “提议模块”)修改公约内容,修改后需同步通知(公告确认)全体成员;
- 仅寝室长拥有公约的创建、编辑、生效 / 废止权限;全体成员拥有公约查看权限,确保公约透明化。
公告管理模块
- 固定信息张贴:宿管阿姨电话 / 微信、辅导员电话、校医院急诊电话;校园一卡通充值链接、寝室设施保修链接、水电费查询入口;
- 自动爬取当日 / 次日天气,若预报降雨 / 大风,推送 “收衣服提醒” 至当日值日生;自动更新公告。
- 通过学校接口爬取寝室实时水电费消耗数据,同步展示 “当前余额”“本月消耗量”,余额不足时推送提醒。
日志管理模块
- 每日生成 “当日操作日志”(含清洁记录、值日打卡、开销记录);每周生成 “每周汇总日志”(含清洁贡献排行、值日完成率、提议处理结果);
- 查看完整日志(含操作人、操作时间),便于追溯问题。
提议管理模块
- 成员提交提议时需填写具体内容,提交后自动发起全体成员(匿名)投票。
成员管理模块
- 寝室长指定:初始寝室长可移交权限,或通过成员投票选举新寝室长;
- 权限变更:寝室长可临时授权其他成员 “代行值日任务分配”“查看完整日志” 等权限(需设置授权有效期)。值日生交换。
- 全体成员可查看其他成员的基础信息(避免隐私泄露,仅展示 “姓名、学号、联系方式”);
- 寝室长可添加新成员(如新生入住)、编辑成员信息(学号、联系方式、专业)、删除成员(如成员搬离)
- 添加成员通过账号
“参与者—业务目标“表:
| 具体用户 | 代表角色(参与者) | 业务目标 |
|---|---|---|
| dsy | 游客 | 查看清洁记录 |
| dsy | 游客 | 查看寝室公约 |
| dsy | 室员 | 查看清洁记录 |
| dsy | 室员 | 查看寝室公约 |
| dsy | 室长 | 管理寝室公约 |
| dsy | 室长 | 查看清洁记录 |
| dsy | 值日生 | 管理清洁记录 |
| dsy | 值日生 | 值日 |
| dsy | 值日生 | 查看寝室公约 |
| dsy | 值日生 | 管理日志 |
| dsy | 开发者 | 管理系统 |
识别用例标准:
1.完整动作序列:一系列的动作,而不是某一个具体的行为
2.具体业务目标:通过“老板测试”,我开发的目的就是为了xxx
3.成功与失败场景:这个用例可能执行成功也可能失败,处理方式不同用例识别:
开发用例图:

系统设计
概念类图
| 类名 | 核心属性 | 类间关系 |
|---|---|---|
| Visitor | ||
| Member | 学号、姓名、性别、床位、头像链接、权限等级 | |
| Monitor | 学号、姓名、性别、床位、头像链接、权限等级 | |
| Dutier | 学号、姓名、性别、床位、头像链接、权限等级 | |
| Developer | ||
| 日志 | 日志 ID、操作时间、操作人、操作内容、日志类型 | |
| CleanTask | 任务 ID、任务名称、标签、权重、上次执行时间、执行次数、执行人员 | |
| Rule | 公约 ID、公约内容、制定人、生效时间 | |
| Event | 事件 ID、内容、类型、时间、记录者 | |
| Expense | 开销 ID、类型、金额、时间、记录者 | |
| 与“入住记录”多对一(1 学生对应 1 条当前入住记录) | ||
| 寝室(Dorm) | 寝室号(主键)、楼号、床位数量 | 与“入住记录”一对多(1 寝室对应多条入住记录) |
| 入住记录(CheckIn) | 记录 ID(主键)、入住日期、退宿日期 | 与学生/寝室多对一 |
对象序列图
- 用例:学生提交报修
- 学生(前端)→RepairController:提交报修(
submitRepair(String studentId, String dormId, String content)); - RepairController→RepairOrderService:创建报修单(
createOrder(RepairOrder order)); - RepairOrderService→RepairOrder:初始化报修单(
RepairOrder(String studentId, String dormId)); - RepairOrderService→Database:保存报修单(
insert(RepairOrder order)); - RepairController→学生(前端):返回提交结果(
{code:200, msg:"提交成功"})。
- 学生(前端)→RepairController:提交报修(
架构设计
| 架构分层 | 技术选择(个人开发推荐) | 核心职责(教材设计原则体现) |
|---|---|---|
| 表现层 | Vue3 + Element Plus | 负责用户交互,不包含业务逻辑(高内聚) |
| 业务逻辑层 | SpringBoot 2.x | 实现核心业务(如入住登记、查寝逻辑),通过接口与前后端解耦(低耦合) |
| 数据访问层 | MySQL 8.0 | 存储业务数据,通过 ORM 框架(MyBatis)与业务层解耦 |
数据库设计
- E-R 图
- 表结构设计
| 表名 | 字段名 | 类型 | 约束 |
|---|---|---|---|
| student | student_id | VARCHAR(20) | 主键 |
| name | VARCHAR(20) | 非空 | |
| password | VARCHAR(255) | 非空(加密存储) | |
| gender | |||
| avatar_url | VARCHAR(255) | ||
| bed_position | |||
| role |
| 表名 | 字段名 | 类型 | 约束 |
|---|---|---|---|
| dorm | dorm_id | VARCHAR(10) | 主键 |
| building_no | VARCHAR(10) | 非空(楼号) | |
| bed_count | INT | 非空(总床位) | |
| used_bed | INT | 非空(已用床位) |
| 表名 | 字段名 | 类型 | 约束 |
|---|---|---|---|
| repair_order | order_id | VARCHAR(32) | 主键 |
| student_id | VARCHAR(20) | 外键(关联 student) | |
| dorm_id | VARCHAR(10) | 外键(关联 dorm) | |
| status | VARCHAR(20) | 非空(待处理/已完成) |
- SQL 脚本:
-- 初始化管理员账号(密码:123456加密后)
INSERT INTO admin (admin_id, name, password)
VALUES ('admin001', '后勤管理员', 'e10adc3949ba59abbe56e057f20f883e');
-- 初始化寝室数据
INSERT INTO dorm (dorm_id, building_no, bed_count, used_bed)
VALUES ('1-101', '1号楼', 4, 0), ('1-102', '1号楼', 4, 2);全栈开发
版本管理
用 Git 做版本控制,遵循Git-Flow 简化版(个人开发无需复杂分支):
- 主分支(main):存放可部署的稳定代码;
- 开发分支(dev):日常开发分支,功能完成后合并到 main;
- 操作流程:
- 初始化仓库:
git init,关联远程仓库(Gitee/GitHub,便于备份); - 开发新功能:
git checkout -b dev,编码后提交(git commit -m "完成报修提交功能"); - 功能测试通过后:
git checkout main→git merge dev,合并到主分支。
- 初始化仓库:
编码
- 前端框架
- 后端接口
测试
- 单元测试
- 接口测试
部署发布
配置环境
部署
- 数据库
- 后端
- 前端
用户手册
说明
logo 由豆包生成。 提示词如下:
任务:帮我生成一份**AI图片提示词** 提示词的要求: - 图片为软件项目的文字logo - 项目为寝室管理系统 - 文字logo的文字为“DMS” - logo中尝试插入具有标识的元素 - 绿色风格已折叠代码,点击展开更新选项
- 【数据库】
- 【更新】
- 【前端】
- 【后端】
- 【说明文件】
- 【忽略文件】
原始遇到的问题
我遇到的问题:
发送 axios 请求没问题,但是没有接收到数据(后端设置跨域资源共享)
vue 的全局配置 axios 配置
数据分析作图-相较上次浅色对比
java 后端处理关联表没有对应实体的情况
pdman 实体不知道怎么设置外键
数据库表设计的时候,遇到两个表的字段不一致,但是确实是有关联,含义相同,字段不同
分配任务:根据积分的不同,反比例的积分作为概率,进行选择成员劳动
图形连线,大小,自动布局算法
登录账户测试(JWT-token 生成)
创建宿舍,邀请宿舍,加入宿舍,退出宿舍,宿舍记录
寝室标题配置
纯生样式实现。全局挂载太多内容了。用不了
响应式布局适配
手动结束值日生,满 1 周自动结束
发送邮箱
上传图片随机命名
随机颜色