03-寝室管理系统开发实践

返回

寝室管理系统开发实践 ​

项目链接:https://github.com/Dorian7Alden/DormitoryManageSystem

说明:水电费功能来自校园内部的接口,属于内网接口,使用的 Python 本地爬虫项目定时向数据库更新数据,项目中代码没有体现。

回忆录 ​

开发时间是在大二上,从 2025-08-03 到 2025-12-18,共 33 次 commits,后面有 3 次是微调 README 之类的。

image-20261014012729312

这个项目的灵感,来自于我这个 “寝室长” ,在安排卫生清洁打扫的时候,十分麻烦,谁清理了什么,做了多少次,该谁做卫生了,难以统计追踪,于是希望通过开发一个工具来解决这个问题。

结合我刚学完 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 ​

寝室管理系统 ​


项目介绍 ​

寝室管理系统是一款专为高校寝室打造的智能化管理工具,旨在解决传统寝室管理中分工模糊、统计繁琐、信息分散等问题,通过数字化手段实现寝室事务的高效协同与规范化管理,为寝室成员营造整洁、有序、便捷的居住环境。 该系统通过功能模块化设计,覆盖清洁、值日、权限、信息、数据等寝室管理全场景,不仅降低了人工管理成本,还通过数据化、智能化手段保障了管理公平性与高效性,同时整合实用信息与互动功能,提升寝室成员的居住体验与凝聚力,是高校寝室数字化管理的理想解决方案。


核心功能 ​
  1. 清洁管理与数据统计:自定义分类标签权重,量化成员的贡献
  2. 值日生智能管理:自动论换周期,自动化管理事务,优化平均贡献
  3. 权限与公约管理:强化寝室规则意识,养成良好的生活习惯
  4. 数据爬取与智能提醒:实时更新寝室动态开销,自动化提醒
  5. 日志与互动功能:生成标准化操作日志,便于复盘管理,积极互动改进

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

“参与者—业务目标“表:

具体用户代表角色(参与者)业务目标
dsy游客查看清洁记录
dsy游客查看寝室公约
dsy室员查看清洁记录
dsy室员查看寝室公约
dsy室长管理寝室公约
dsy室长查看清洁记录
dsy值日生管理清洁记录
dsy值日生值日
dsy值日生查看寝室公约
dsy值日生管理日志
dsy开发者管理系统

识别用例标准:

1.完整动作序列:一系列的动作,而不是某一个具体的行为
2.具体业务目标:通过“老板测试”,我开发的目的就是为了xxx
3.成功与失败场景:这个用例可能执行成功也可能失败,处理方式不同
已折叠代码,点击展开

用例识别:


开发用例图:

image-20251003164306459
系统设计 ​
概念类图 ​
类名核心属性类间关系
Visitor
Member学号、姓名、性别、床位、头像链接、权限等级
Monitor学号、姓名、性别、床位、头像链接、权限等级
Dutier学号、姓名、性别、床位、头像链接、权限等级
Developer
日志日志 ID、操作时间、操作人、操作内容、日志类型
CleanTask任务 ID、任务名称、标签、权重、上次执行时间、执行次数、执行人员
Rule公约 ID、公约内容、制定人、生效时间
Event事件 ID、内容、类型、时间、记录者
Expense开销 ID、类型、金额、时间、记录者
与“入住记录”多对一(1 学生对应 1 条当前入住记录)
寝室(Dorm)寝室号(主键)、楼号、床位数量与“入住记录”一对多(1 寝室对应多条入住记录)
入住记录(CheckIn)记录 ID(主键)、入住日期、退宿日期与学生/寝室多对一

对象序列图 ​
  • 用例:学生提交报修
    1. 学生(前端)→RepairController:提交报修(submitRepair(String studentId, String dormId, String content));
    2. RepairController→RepairOrderService:创建报修单(createOrder(RepairOrder order));
    3. RepairOrderService→RepairOrder:初始化报修单(RepairOrder(String studentId, String dormId));
    4. RepairOrderService→Database:保存报修单(insert(RepairOrder order));
    5. RepairController→学生(前端):返回提交结果({code:200, msg:"提交成功"})。

架构设计 ​
架构分层技术选择(个人开发推荐)核心职责(教材设计原则体现)
表现层Vue3 + Element Plus负责用户交互,不包含业务逻辑(高内聚)
业务逻辑层SpringBoot 2.x实现核心业务(如入住登记、查寝逻辑),通过接口与前后端解耦(低耦合)
数据访问层MySQL 8.0存储业务数据,通过 ORM 框架(MyBatis)与业务层解耦

数据库设计 ​
  • E-R 图
  • 表结构设计
表名字段名类型约束
studentstudent_idVARCHAR(20)主键
nameVARCHAR(20)非空
passwordVARCHAR(255)非空(加密存储)
gender
avatar_urlVARCHAR(255)
bed_position
role
表名字段名类型约束
dormdorm_idVARCHAR(10)主键
building_noVARCHAR(10)非空(楼号)
bed_countINT非空(总床位)
used_bedINT非空(已用床位)
表名字段名类型约束
repair_orderorder_idVARCHAR(32)主键
student_idVARCHAR(20)外键(关联 student)
dorm_idVARCHAR(10)外键(关联 dorm)
statusVARCHAR(20)非空(待处理/已完成)
  • SQL 脚本:
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;
  • 操作流程:
    1. 初始化仓库:git init,关联远程仓库(Gitee/GitHub,便于备份);
    2. 开发新功能:git checkout -b dev,编码后提交(git commit -m "完成报修提交功能");
    3. 功能测试通过后:git checkout main → git merge dev,合并到主分支。

编码 ​
  • 前端框架
  • 后端接口

测试 ​
  • 单元测试
  • 接口测试

部署发布 ​
配置环境 ​

部署 ​
  • 数据库
  • 后端
  • 前端

用户手册 ​

说明 ​
  • logo 由豆包生成。 提示词如下:

    任务:帮我生成一份**AI图片提示词**
    提示词的要求:
    
    - 图片为软件项目的文字logo
    - 项目为寝室管理系统
    - 文字logo的文字为“DMS”
    - logo中尝试插入具有标识的元素
    - 绿色风格
    已折叠代码,点击展开
  • 更新选项

    • 【数据库】
    • 【更新】
    • 【前端】
    • 【后端】
    • 【说明文件】
    • 【忽略文件】

原始遇到的问题 ​

我遇到的问题:

  • 发送 axios 请求没问题,但是没有接收到数据(后端设置跨域资源共享)

  • vue 的全局配置 axios 配置

  • 数据分析作图-相较上次浅色对比

  • java 后端处理关联表没有对应实体的情况

  • pdman 实体不知道怎么设置外键

  • 数据库表设计的时候,遇到两个表的字段不一致,但是确实是有关联,含义相同,字段不同

  • 分配任务:根据积分的不同,反比例的积分作为概率,进行选择成员劳动

  • 图形连线,大小,自动布局算法

  • 登录账户测试(JWT-token 生成)

  • 创建宿舍,邀请宿舍,加入宿舍,退出宿舍,宿舍记录

  • 寝室标题配置

  • 纯生样式实现。全局挂载太多内容了。用不了

  • 响应式布局适配

  • 手动结束值日生,满 1 周自动结束

  • 发送邮箱

  • 上传图片随机命名

  • 随机颜色