Spring Boot 3 + Vue 3 高校宿舍水电费管理系统源码前后端分离实战

📅 2026/7/7 2:36:38 👁️ 阅读次数 📝 编程学习
Spring Boot 3 + Vue 3 高校宿舍水电费管理系统源码前后端分离实战

一、项目简介

本系统是一个基于 Spring Boot 3 + Vue 3 前后端分离架构的高校宿舍水电费管理系统。系统围绕宿舍水电费管理全流程设计,涵盖水电表管理、抄表录入、月度账单自动生成与分摊、学生在线缴费与申诉、公告通知发布、站内消息推送等核心业务模块,实现从数据采集到费用结算的闭环管理。系统包含学生、宿管、系统管理员三种角色,分别对应不同的操作权限和功能视图。

二、技术栈

技术说明
后端框架Spring Boot 3.x
ORMMyBatis-Plus
权限认证JWT(JSON Web Token)
前端框架Vue 3
状态管理Pinia
前端路由Vue Router
构建工具Vite
数据库MySQL

三、功能模块

学生端

  • 查看个人分摊记录列表,支持按月份、确认状态筛选,确认分摊费用无误
  • 在线模拟支付水电费,选择分摊记录后生成支付订单,支付后自动确认分摊
  • 查看个人支付订单列表,支持按支付状态、月份筛选,获取缴费凭证
  • 提交水电费申诉,填写申诉类型、关联账单、申诉内容,提交后通知宿管
  • 查看申诉处理结果,在“我的申诉”列表中查看状态和回复
  • 查看所在楼栋的公告通知,支持按类型筛选,仅显示已发布公告
  • 查看站内消息列表,支持按类型筛选,标记单条或全部消息为已读
  • 查看当前宿舍信息和宿舍历史账单(最近12个月)
  • 修改个人资料(姓名、手机号等)和登录密码(需验证旧密码)
  • 学生注册功能,注册后默认角色为学生

宿管端

  • 管理管辖楼栋下的水电表,支持新增、修改、删除水表或电表
  • 录入单条抄表数据(填写当前读数、月份),系统自动计算用量
  • 批量录入抄表数据,一次性录入多条抄表记录,提高工作效率
  • 分页查询抄表记录,支持按楼栋、宿舍、月份、表类型筛选
  • 查看管辖楼栋的账单列表,支持按宿舍、月份、状态筛选
  • 确认账单(PENDING→CONFIRMED)或标记账单异常(PENDING→ABNORMAL)
  • 修改账单信息(用量、单价等),系统自动重新计算费用
  • 查看管辖楼栋的支付订单,支持按学生、宿舍、状态、月份筛选
  • 确认学生线下缴费,支持单条确认和批量确认
  • 通过分摊记录ID确认线下缴费,为未支付学生创建线下支付记录
  • 发布、修改、上架/下架、删除公告,支持指定楼栋或全校发布
  • 查看自己发布的公告列表,管理公告的可见性
  • 查看管辖楼栋的申诉列表,处理申诉(通过/驳回)
  • 查看仪表盘统计(管辖楼栋数、待处理申诉数)

系统管理员端

  • 管理所有楼栋,支持新增、修改、删除楼栋信息
  • 管理宿舍,支持新增、修改、删除宿舍,绑定/解绑学生
  • 管理所有用户,支持分页查询、修改用户信息、删除用户
  • 修改用户状态(启用/禁用),重置用户密码为123456
  • 新增宿管账号,创建宿管角色用户
  • 配置水电单价(水、电单价),查看当前有效单价和历史配置
  • 生成月度账单,选择楼栋和月份,系统自动读取抄表数据计算费用并分摊
  • 查看所有账单,处理异常账单(修正用量、重新计算费用和分摊)
  • 查看所有支付订单,支持多条件筛选,处理异常订单
  • 查看所有申诉,处理申诉(通过/驳回)
  • 查看系统操作日志,支持按用户名、操作类型筛选
  • 查看仪表盘统计(用户总数、学生总数、楼栋数、宿舍数、待处理申诉数、待确认账单数、未支付订单数)

四、项目总结

本系统技术亮点在于采用前后端分离架构,后端基于 Spring Boot 3 和 MyBatis-Plus 实现高效的数据持久化与业务逻辑,前端使用 Vue 3 + Pinia + Vite 构建响应式交互界面,JWT 提供无状态权限认证。系统覆盖了从抄表录入、费用分摊、在线缴费到申诉处理的全流程闭环管理,适合作为高校宿舍管理场景的信息化解决方案,也适合 Java 全栈开发者作为学习或二次开发的项目参考。

界面展示

交付内容

本项目为完整交付,包含:

  • 完整后端源码
  • 完整前端源码
  • 数据库初始化脚本(SQL)
  • 万字项目文档(设计文档 / 论文,可作课程设计、毕业设计参考)