一、业务场景与技术难点
保姆、月嫂类家政服务的档期预约与普通到店预约有本质区别:服务周期长(月嫂通常26天或42天为一期,住家保姆按月续期)、档期锁定粒度粗(整段占用而非按小时)、冲突检测复杂(一个服务人员同一时间段只能服务一个家庭)。
在Java管理系统中实现档期预约功能,需要解决以下核心技术问题:
- 时间段冲突检测:给定一个服务人员和目标时间段,快速判断该时段是否已被占用。
- 档期预占与释放:用户下单后预占服务人员档期,支付确认后正式锁定,取消或超时后自动释放。
- 档期日历展示:前端需要展示服务人员的档期日历(哪些日期已排满、哪些日期可预约),供用户选择。
- 并发安全:多个用户同时预约同一服务人员时,必须保证不会出现"超卖"(同一档期被两个订单占用)。
二、整体设计方案
数据模型设计
档期预约涉及三张核心数据表:
- 服务人员档期表(worker_schedule):记录每个服务人员的已占用时间段,字段包括worker_id、start_date、end_date、order_id、status(预占/已确认/已取消)。
- 预约订单表(reservation_order):记录用户的预约请求,字段包括order_id、worker_id、user_id、service_type、start_date、end_date、status、created_at。
- 档期日历缓存表(schedule_calendar):按服务人员维度缓存未来N天的档期状态,用于前端日历展示,定时刷新。
冲突检测策略
冲突检测采用区间重叠判断算法:两个时间段[start1, end1]和[start2, end2]重叠的充要条件是start1 <= end2 && start2 <= end1。
查询时通过数据库索引加速:对worker_schedule表的(worker_id, start_date, end_date)建立联合索引,查询条件为worker_id = ? AND start_date <= ? AND end_date >= ?,可高效命中重叠记录。
并发控制方案
为防止同一档期被多人抢占,采用数据库乐观锁 + 唯一约束双重保障:
- 在
worker_schedule表中对(worker_id, start_date, end_date)建立唯一索引,数据库层面杜绝重复插入。 - 业务层使用
SELECT ... FOR UPDATE行级锁,在事务内完成"查询冲突 → 插入占位"的原子操作。
档期日历生成逻辑
为前端提供日历数据时,按服务人员维度查询未来90天的档期状态,将已占用的时间段标记为"不可预约",剩余时间段标记为"可预约"。考虑到性能,日历数据通过定时任务每5分钟刷新一次缓存,而非每次实时查询。
三、核心代码实现
档期冲突检测与预约锁定服务
以下代码实现了档期冲突检测、预占锁定、确认/释放的完整业务逻辑,使用Spring事务和行级锁保证并发安全。
import lombok.Data; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Service; import org.springframework.transaction.annotation.Transactional; import javax.persistence.*; import java.time.LocalDate; import java.time.LocalDateTime; import java.util.List; import java.util.Optional; public class ScheduleReservationService { private EntityManager em; (name = "worker_schedule", uniqueConstraints = ( columnNames = {"worker_id", "start_date", "end_date"})) public static class WorkerSchedule { (strategy = GenerationType.IDENTITY) private Long id; (name = "worker_id", nullable = false) private String workerId; (name = "start_date", nullable = false) private LocalDate startDate; (name = "end_date", nullable = false) private LocalDate endDate; (name = "order_id") private String orderId; (name = "status", nullable = false) (EnumType.STRING) private ScheduleStatus status; (name = "created_at") private LocalDateTime createdAt; } public enum ScheduleStatus { PRE_OCCUPIED, // 预占(下单未支付) CONFIRMED, // 已确认(支付完成) CANCELLED, // 已取消 COMPLETED // 服务已完成 } /** * 检测指定服务人员在目标时间段内是否存在档期冲突 */ public boolean hasConflict(String workerId, LocalDate startDate, LocalDate endDate) { String jpql = "SELECT COUNT(s) FROM WorkerSchedule s " + "WHERE s.workerId = :workerId " + "AND s.status IN ('PRE_OCCUPIED', 'CONFIRMED') " + "AND s.startDate <= :endDate " + "AND s.endDate >= :startDate"; Long count = em.createQuery(jpql, Long.class) .setParameter("workerId", workerId) .setParameter("startDate", startDate) .setParameter("endDate", endDate) .getSingleResult(); return count > 0; } /** * 预占档期(用户下单时调用) * 使用悲观锁保证并发安全 */ (rollbackFor = Exception.class) public WorkerSchedule preOccupySchedule(String workerId, LocalDate startDate, LocalDate endDate, String orderId) { // 行级锁查询,防止并发写入 String lockJpql = "SELECT s FROM WorkerSchedule s " + "WHERE s.workerId = :workerId " + "AND s.startDate <= :endDate " + "AND s.endDate >= :startDate " + "AND s.status IN ('PRE_OCCUPIED', 'CONFIRMED') " + "FOR UPDATE"; List<WorkerSchedule> conflicts = em.createQuery(lockJpql, WorkerSchedule.class) .setParameter("workerId", workerId) .setParameter("startDate", startDate) .setParameter("endDate", endDate) .getResultList(); if (!conflicts.isEmpty()) { throw new ScheduleConflictException( String.format("服务人员 %s 在 %s ~ %s 期间档期已被占用", workerId, startDate, endDate)); } // 无冲突,创建预占记录 WorkerSchedule schedule = new WorkerSchedule(); schedule.setWorkerId(workerId); schedule.setStartDate(startDate); schedule.setEndDate(endDate); schedule.setOrderId(orderId); schedule.setStatus(ScheduleStatus.PRE_OCCUPIED); schedule.setCreatedAt(LocalDateTime.now()); em.persist(schedule); em.flush(); log.info("档期预占成功: workerId={}, period={} ~ {}, orderId={}", workerId, startDate, endDate, orderId); return schedule; } /** * 确认档期(用户支付完成后调用) */ (rollbackFor = Exception.class) public void confirmSchedule(String orderId) { String jpql = "UPDATE WorkerSchedule s SET s.status = 'CONFIRMED' " + "WHERE s.orderId = :orderId AND s.status = 'PRE_OCCUPIED'"; int updated = em.createQuery(jpql) .setParameter("orderId", orderId) .executeUpdate(); if (updated == 0) { throw new ScheduleNotFoundException("未找到待确认的档期记录: " + orderId); } log.info("档期确认成功: orderId={}", orderId); } /** * 释放档期(用户取消订单或预占超时未支付时调用) */ (rollbackFor = Exception.class) public void releaseSchedule(String orderId) { String jpql = "UPDATE WorkerSchedule s SET s.status = 'CANCELLED' " + "WHERE s.orderId = :orderId AND s.status = 'PRE_OCCUPIED'"; int updated = em.createQuery(jpql) .setParameter("orderId", orderId) .executeUpdate(); if (updated > 0) { log.info("档期释放成功: orderId={}", orderId); } } /** * 查询指定服务人员在指定月份的可预约日期 */ public List<LocalDate> getAvailableDates(String workerId, int year, int month) { LocalDate monthStart = LocalDate.of(year, month, 1); LocalDate monthEnd = monthStart.withDayOfMonth(monthStart.lengthOfMonth()); String jpql = "SELECT s FROM WorkerSchedule s " + "WHERE s.workerId = :workerId " + "AND s.status IN ('PRE_OCCUPIED', 'CONFIRMED') " + "AND s.startDate <= :monthEnd " + "AND s.endDate >= :monthStart"; List<WorkerSchedule> occupied = em.createQuery(jpql, WorkerSchedule.class) .setParameter("workerId", workerId) .setParameter("monthStart", monthStart) .setParameter("monthEnd", monthEnd) .getResultList(); // 生成当月所有日期,排除已被占用的 List<LocalDate> allDates = new java.util.ArrayList<>(); for (LocalDate d = monthStart; !d.isAfter(monthEnd); d = d.plusDays(1)) { allDates.add(d); } return allDates.stream().filter(date -> occupied.stream().noneMatch(s -> !date.isBefore(s.getStartDate()) && !date.isAfter(s.getEndDate()) ) ).collect(java.util.stream.Collectors.toList()); } }
预占超时自动释放定时任务
以下代码实现了预占档期的超时自动释放机制,防止用户下单未支付导致档期被长期占用。
import lombok.extern.slf4j.Slf4j; import org.springframework.scheduling.annotation.Scheduled; import org.springframework.stereotype.Component; import org.springframework.transaction.annotation.Transactional; import javax.persistence.EntityManager; import javax.persistence.PersistenceContext; import java.time.LocalDateTime; import java.util.List; public class ScheduleTimeoutHandler { private EntityManager em; // 预占超时阈值:30分钟未支付则自动释放 private static final int PRE_OCCUPY_TIMEOUT_MINUTES = 30; /** * 每5分钟执行一次,扫描并释放超时的预占档期 */ (fixedRate = 5 * 60 * 1000) (rollbackFor = Exception.class) public void releaseExpiredPreOccupations() { LocalDateTime threshold = LocalDateTime.now() .minusMinutes(PRE_OCCUPY_TIMEOUT_MINUTES); String jpql = "SELECT s FROM WorkerSchedule s " + "WHERE s.status = 'PRE_OCCUPIED' " + "AND s.createdAt < :threshold"; List<ScheduleReservationService.WorkerSchedule> expired = em.createQuery(jpql, ScheduleReservationService.WorkerSchedule.class) .setParameter("threshold", threshold) .getResultList(); if (expired.isEmpty()) { return; } for (ScheduleReservationService.WorkerSchedule schedule : expired) { schedule.setStatus(ScheduleReservationService.ScheduleStatus.CANCELLED); em.merge(schedule); log.warn("预占档期超时自动释放: workerId={}, orderId={}, " + "period={} ~ {}, occupiedSince={}", schedule.getWorkerId(), schedule.getOrderId(), schedule.getStartDate(), schedule.getEndDate(), schedule.getCreatedAt()); } em.flush(); log.info("本次共释放 {} 条超时预占档期记录", expired.size()); } /** * 每天凌晨执行,将已过期的已确认档期标记为已完成 * (服务结束日期已过的记录自动归档) */ (cron = "0 0 2 * * ?") (rollbackFor = Exception.class) public void archiveCompletedSchedules() { LocalDateTime now = LocalDateTime.now(); String jpql = "UPDATE WorkerSchedule s SET s.status = 'COMPLETED' " + "WHERE s.status = 'CONFIRMED' " + "AND s.endDate < CURRENT_DATE"; int updated = em.createQuery(jpql).executeUpdate(); if (updated > 0) { log.info("归档 {} 条已完成的服务档期记录", updated); } } }
四、关键设计要点
关于预占与确认的两阶段设计:用户下单时仅预占档期(状态为PRE_OCCUPIED),支付成功后才正式确认(状态变为CONFIRMED)。这种设计避免了用户下单未支付导致档期被无效锁定的问题。预占记录设置超时时间(如30分钟),超时未支付的由定时任务自动释放。
关于并发安全的选型:上述代码采用SELECT ... FOR UPDATE悲观锁方案,适合家政预约这种并发量不高的场景(同一服务人员同一时段被多人同时抢的概率较低)。如果业务量增大,可以改为乐观锁方案(在worker_schedule表中增加version字段,更新时校验版本号),减少锁等待。
关于档期日历的性能优化:getAvailableDates方法每次实时查询数据库,在数据量较大时可能影响响应速度。生产环境中建议引入Redis缓存,按worker_id + 年月为key缓存日历数据,TTL设为5分钟。服务人员档期发生变更时主动失效对应缓存。
关于服务周期的灵活性:月嫂服务通常以26天或42天为一期,住家保姆按月续期,白班保姆可能按天计。上述代码中start_date和end_date为灵活的日期区间,不硬编码服务周期长度,由前端根据服务类型传入具体日期,后端只做冲突检测,这样新增服务类型时无需修改档期模块代码。
关于数据清理策略:随着业务运行,worker_schedule表中会积累大量历史数据。建议按季度归档,将已完成(COMPLETED)且结束日期超过6个月的记录迁移到历史表,保持主表数据量可控,确保查询性能稳定。
以上是家政管理系统档期预约模块的Java实现方案。核心思路是"区间重叠冲突检测 + 两阶段预占确认 + 定时超时释放",通过数据库唯一约束和行级锁保证并发安全,通过定时任务实现档期的自动生命周期管理,适合作为保姆月嫂类家政系统预约功能的开发参考。