
1. 项目背景与意义在高校校园生活中公共浴室是学生日常必需的基础设施。传统的“先到先得”排队模式在高峰时段如下课后、晚间常导致学生长时间排队等候不仅浪费宝贵的学习和休息时间也容易引发拥挤、插队等管理问题。同时浴室管理者难以实时掌握各时段使用情况无法进行有效的资源调配和能耗管理。因此开发一套基于SpringBoot的高校浴室预约系统具有重要的现实意义提升学生体验学生可提前规划洗浴时间避免无效排队实现错峰使用。优化资源配置系统可统计各时段预约数据为浴室开放时间、淋浴位数量调整提供数据支持。提高管理效率实现预约、签到、结算全流程线上化减少人工管理成本。节能环保通过预约控制人流量避免浴室空转达到节水节电的目的。2. 系统技术栈选型本系统采用前后端分离的架构设计后端基于SpringBoot快速构建具体技术栈如下层次技术选型说明后端框架Spring Boot 2.7.x快速构建、自动配置、内嵌Tomcat安全框架Spring Security JWT实现用户认证与授权保障接口安全数据持久层MyBatis-Plus简化CRUD操作提供强大的条件构造器数据库MySQL 8.0关系型数据库存储用户、预约、浴室等核心数据缓存Redis缓存热点数据如浴室实时状态、分布式锁防超卖消息队列RabbitMQ异步处理预约超时未签到取消、消息通知等任务API文档Knife4j Swagger2生成在线API文档便于前后端联调前端框架Vue 3 Element Plus构建用户友好的管理后台与学生端页面部署与监控Docker, Prometheus, Grafana容器化部署监控系统运行状态3. 核心功能模块设计系统主要分为学生端、管理后台和浴室终端三部分核心功能模块如下用户管理模块学生注册/登录支持学号绑定、个人信息管理。浴室与淋浴位管理模块管理员可增删改查浴室信息、淋浴位状态空闲/占用/维修。预约规则管理模块设置可预约时段如每日8:00-22:00、单次预约时长如30分钟、取消规则等。预约核心模块学生查看可预约时段、选择淋浴位、提交预约、支付可选集成校园卡/微信支付。签到与使用模块学生通过扫码或输入验证码在浴室终端签到开始使用并计时。订单与结算模块记录预约订单、实际使用时长、费用结算按时间计费或免费。数据统计模块为管理员提供预约热力图、使用率报表、收入统计等。4. 核心代码实现4.1 预约服务核心逻辑防超卖预约是系统的核心并发场景需防止同一时段同一淋浴位被重复预约。这里采用Redis分布式锁 数据库乐观锁确保一致性。Service Slf4j public class ReservationServiceImpl implements ReservationService { Autowired private RedisTemplateString, String redisTemplate; Autowired private BathroomMapper bathroomMapper; Autowired private ReservationMapper reservationMapper; Autowired private RabbitTemplate rabbitTemplate; private static final String LOCK_KEY_PREFIX reservation:lock:; Override Transactional(rollbackFor Exception.class) public ApiResult createReservation(ReservationDTO dto) { Long showerId dto.getShowerId(); LocalDateTime startTime dto.getStartTime(); LocalDateTime endTime dto.getEndTime(); // 1. 校验时段是否可预约业务规则略 // 2. 尝试获取分布式锁 String lockKey LOCK_KEY_PREFIX showerId : startTime; String lockValue UUID.randomUUID().toString(); Boolean lockAcquired redisTemplate.opsForValue() .setIfAbsent(lockKey, lockValue, 30, TimeUnit.SECONDS); if (Boolean.FALSE.equals(lockAcquired)) { return ApiResult.fail(当前淋浴位正在被预约请稍后重试); } try { // 3. 双重校验查询数据库该时段是否已被占用 Integer count reservationMapper.countByShowerAndTime(showerId, startTime, endTime); if (count 0) { return ApiResult.fail(该时段已被预约); } // 4. 扣减淋浴位库存乐观锁 Bathroom bathroom bathroomMapper.selectById(showerId); if (bathroom null || !bathroom.getStatus().equals(ShowerStatus.AVAILABLE)) { return ApiResult.fail(淋浴位不可用); } // 假设有一个字段表示当前时段是否被占用这里用版本号控制 int updateRows bathroomMapper.lockShower(showerId, bathroom.getVersion()); if (updateRows 0) { return ApiResult.fail(库存更新失败请重试); } // 5. 创建预约记录 Reservation reservation new Reservation(); BeanUtils.copyProperties(dto, reservation); reservation.setOrderNo(IdUtil.simpleUUID()); reservation.setStatus(ReservationStatus.BOOKED); reservationMapper.insert(reservation); // 6. 发送延迟消息处理超时未签到自动取消 ReservationCancelMessage message new ReservationCancelMessage(); message.setReservationId(reservation.getId()); rabbitTemplate.convertAndSend( reservation.delay.exchange, reservation.cancel, message, msg - { // 设置15分钟后过期 msg.getMessageProperties().setDelay(15 * 60 * 1000); return msg; } ); return ApiResult.success(预约成功, reservation.getOrderNo()); } finally { // 释放锁确保原子性使用Lua脚本 String script if redis.call(get, KEYS[1]) ARGV[1] then return redis.call(del, KEYS[1]) else return 0 end; redisTemplate.execute(new DefaultRedisScript(script, Long.class), Collections.singletonList(lockKey), lockValue); } } }4.2 浴室终端签到服务学生到达浴室后通过终端如平板扫码或输入验证码签到系统开始计时。RestController RequestMapping(/terminal) public class TerminalController { PostMapping(/checkin) public ApiResult checkIn(RequestBody CheckInDTO dto) { // 1. 验证预约码或二维码 Reservation reservation reservationService.getByCheckInCode(dto.getCode()); if (reservation null) { return ApiResult.fail(预约码无效); } if (!reservation.getStatus().equals(ReservationStatus.BOOKED)) { return ApiResult.fail(预约状态异常无法签到); } if (LocalDateTime.now().isAfter(reservation.getStartTime().plusMinutes(15))) { return ApiResult.fail(已过签到有效期预约自动取消); } // 2. 更新预约状态为“使用中”记录开始时间 reservation.setStatus(ReservationStatus.IN_USE); reservation.setActualStartTime(LocalDateTime.now()); reservationMapper.updateById(reservation); // 3. 更新淋浴位实时状态为“占用”并写入Redis缓存供前端实时展示 String key shower:status: reservation.getShowerId(); redisTemplate.opsForValue().set(key, OCCUPIED, 2, TimeUnit.HOURS); // 4. 发送WebSocket消息通知管理后台状态更新 webSocketService.sendShowerStatusUpdate(reservation.getShowerId(), OCCUPIED); return ApiResult.success(签到成功请开始使用); } PostMapping(/checkout) public ApiResult checkOut(RequestBody CheckOutDTO dto) { // 结算逻辑根据实际使用时长计算费用更新订单状态等 // ... } }4.3 数据统计使用热力图为管理员提供可视化数据辅助决策。Service public class StatisticsServiceImpl implements StatisticsService { Override public ListUsageHeatmapVO getUsageHeatmap(LocalDate startDate, LocalDate endDate) { // 查询指定日期范围内每小时的预约数量 ListMapString, Object rawData reservationMapper.selectHourlyCount(startDate, endDate); // 构建热力图数据日期 - 小时 - 数量 MapLocalDate, MapInteger, Long heatmap new LinkedHashMap(); for (MapString, Object row : rawData) { LocalDate date ((java.sql.Date) row.get(date)).toLocalDate(); Integer hour (Integer) row.get(hour); Long count (Long) row.get(count); heatmap.computeIfAbsent(date, k - new HashMap()).put(hour, count); } // 转换为前端需要的VO列表 ListUsageHeatmapVO result new ArrayList(); for (Map.EntryLocalDate, MapInteger, Long entry : heatmap.entrySet()) { UsageHeatmapVO vo new UsageHeatmapVO(); vo.setDate(entry.getKey()); vo.setHourlyCounts(entry.getValue()); result.add(vo); } return result; } }5. 总结与展望本文介绍了基于SpringBoot的高校浴室预约系统的设计背景、技术栈选型、核心功能模块以及关键代码实现。该系统通过引入线上预约机制能有效解决高校浴室排队难题提升资源利用效率与管理水平。未来可扩展方向智能推荐基于历史数据为学生推荐空闲时段。硬件集成与智能水表、门锁联动实现自动计费与开关控制。小程序/APP开发移动端应用提供更便捷的预约体验。大数据分析深入分析使用模式为校园基础设施建设提供决策支持。