温馨提示：本人主页置顶文章(点我)开头有 CSDN 平台官方提供的学长联系方式的名片！
1. 项目背景与意义
随着高校办学规模的不断扩大，学生人数持续增长，学校浴室作为师生日常生活的重要基础设施，其管理难度也随之上升。传统的浴室管理方式多依赖人工登记、纸质记录和现场排队，存在效率低下、信息不透明、高峰期拥挤、资源浪费等问题。开发一套基于 Spring Boot 的学校浴室管理系统，能够实现浴室使用情况的数字化管理，提升管理效率，改善师生使用体验，具有重要的现实意义和应用价值。
2. 系统需求分析
本系统面向学校浴室管理场景，主要用户角色包括管理员、浴室工作人员和学生用户。系统需要满足以下核心需求：
- 用户管理：支持学生信息的注册、登录、个人信息维护，以及管理员对用户账号的管理与审核。
- 浴室信息管理：管理员可维护浴室的基本信息，包括浴室名称、位置、开放时间、可用淋浴位数量等。
- 预约管理：学生可在线预约洗浴时段，查看空闲淋浴位，避免现场排队等待。
- 使用记录管理：系统自动记录每次洗浴的开始时间、结束时间、消费金额等信息，形成完整的使用台账。
- 计费管理：根据洗浴时长或固定收费标准自动计算费用，支持余额扣费与充值记录管理。
- 数据统计：管理员可查看浴室使用率、高峰期分布、营收情况等统计数据，辅助管理决策。
3. 系统架构设计
本系统采用前后端分离的架构模式。后端基于 Spring Boot 框架构建 RESTful API，前端采用 Vue.js 框架开发单页面应用，数据库选用 MySQL 存储业务数据。系统整体架构如下：
flowchart TD A[浏览器前端 Vue.js] -->|HTTP/JSON| B[Spring Boot 后端] B --> C[业务逻辑层 Service] C --> D[数据访问层 Mapper] D --> E[(MySQL 数据库)] B --> F[Redis 缓存] B --> G[文件存储服务]后端采用分层架构设计，分为控制器层（Controller）、业务逻辑层（Service）、数据访问层（Mapper/DAO）和实体模型层（Entity），各层职责清晰、耦合度低，便于后续维护与扩展。
4. 数据库设计
根据系统需求分析，数据库主要包含以下核心数据表：
| 表名 | 说明 | 主要字段 |
|---|---|---|
| user | 用户表 | id、username、password、name、student_no、role、phone、balance、create_time |
| bathroom | 浴室信息表 | id、name、location、open_time、close_time、total_slots、description |
| reservation | 预约记录表 | id、user_id、bathroom_id、reserve_date、time_slot、status、create_time |
| usage_record | 使用记录表 | id、user_id、bathroom_id、start_time、end_time、duration、amount、create_time |
| recharge_record | 充值记录表 | id、user_id、amount、pay_type、status、create_time |
各表之间通过外键关联，例如预约记录表通过 user_id 关联用户表、通过 bathroom_id 关联浴室信息表，确保数据的一致性和完整性。
5. 核心功能模块实现
系统核心功能模块主要包括用户认证与权限管理、浴室预约、使用记录与计费、数据统计等。下面重点介绍几个关键模块的实现思路。
5.1 用户认证与权限管理
系统采用 Spring Security 结合 JWT 实现用户认证与授权。用户登录成功后，后端签发 JWT 令牌，前端在后续请求中携带该令牌访问受保护的接口。通过角色标识区分管理员和普通学生用户，在接口层面进行权限控制。
@Configuration @EnableWebSecurity public class SecurityConfig { @Bean public SecurityFilterChain filterChain(HttpSecurity http) throws Exception { http.csrf().disable() .authorizeHttpRequests(auth -> auth .requestMatchers("/api/auth/**").permitAll() .requestMatchers("/api/admin/**").hasRole("ADMIN") .anyRequest().authenticated() ) .addFilterBefore(jwtAuthenticationFilter(), UsernamePasswordAuthenticationFilter.class); return http.build(); } }5.2 浴室预约模块
预约模块是系统的核心业务。学生选择浴室、日期和时段后提交预约请求，后端在事务中校验该时段剩余名额，若有余位则创建预约记录并扣减名额，否则返回预约已满的提示。预约支持取消操作，取消后释放对应时段的名额。
@Service public class ReservationService { @Transactional public Result createReservation(ReservationDTO dto) { // 校验用户和浴室信息 // 检查该时段是否已满 int used = reservationMapper.countByTimeSlot(dto.getBathroomId(), dto.getReserveDate(), dto.getTimeSlot()); Bathroom bathroom = bathroomMapper.selectById(dto.getBathroomId()); if (used >= bathroom.getTotalSlots()) { return Result.error("该时段预约已满"); } // 创建预约记录 Reservation reservation = new Reservation(); reservation.setUserId(dto.getUserId()); reservation.setBathroomId(dto.getBathroomId()); reservation.setReserveDate(dto.getReserveDate()); reservation.setTimeSlot(dto.getTimeSlot()); reservation.setStatus(1); reservationMapper.insert(reservation); return Result.success("预约成功"); } }5.3 计费与使用记录
学生到浴室后，工作人员在系统中确认开始使用，系统记录开始时间；使用结束后确认结束，系统根据时长和计费规则自动计算费用，并从学生账户余额中扣费，同时生成使用记录。计费规则支持按次计费和按时长计费两种模式，可在系统参数中灵活配置。
6. 系统测试
系统开发完成后，对核心功能模块进行了功能测试和性能测试。功能测试覆盖用户注册登录、浴室信息管理、预约与取消预约、使用记录生成、费用计算与扣费等主要业务流程，测试结果表明各功能模块运行正常，数据交互准确。性能测试方面，使用 JMeter 对预约接口进行并发压测，系统在 200 并发下响应时间稳定在可接受范围内，满足日常使用需求。
7. 总结与展望
本文设计并实现了一套基于 Spring Boot 的学校浴室管理系统，系统采用前后端分离架构，实现了用户管理、浴室信息管理、在线预约、使用记录与计费、数据统计等核心功能，有效提升了学校浴室的管理效率和服务质量。系统界面友好、操作简便，具有良好的可扩展性和可维护性。
后续可在以下方向继续优化：一是引入消息队列处理高峰期预约请求，提升系统吞吐能力；二是结合物联网设备实现淋浴位的自动感知与状态同步；三是开发移动端小程序，进一步方便学生使用。
