一、引言
随着生活服务数字化程度不断提升,家政服务平台已成为连接客户与服务人员的重要桥梁。保姆、月嫂等家政服务具有预约制、时段性强、人员匹配要求高等特点,其下单预约流程的设计与普通电商订单存在显著差异。
本文将从技术实现角度,梳理家政服务平台客户下单预约的完整业务流程,并给出核心环节的代码示例,供开发者参考。
二、业务流程概览
客户下单预约的完整流程可分为以下几个阶段:
1. 服务浏览与筛选
客户进入平台后,根据服务类型(保姆、月嫂、保洁等)、服务区域、价格区间等条件筛选服务人员。系统需根据筛选条件查询符合条件的服务人员列表,并展示其基本信息、评分、历史订单量等。
2. 服务人员详情查看
客户点击某位服务人员,查看详细信息,包括资质证书、服务经验、用户评价、可预约时间段等。
3. 提交预约订单
客户选择服务类型、服务地址、期望服务时间、服务时长等信息后提交预约。此阶段需要进行以下校验:
- 该服务人员所选时间段是否可预约(是否存在时间冲突)
- 服务地址是否在可服务范围内
- 客户信息是否完整
4. 订单确认与支付
系统生成订单后,客户完成支付。支付成功后订单状态变更为"已预约"。
5. 服务人员接单/平台派单
根据业务模式不同,可以是服务人员主动接单,也可以是平台自动派单。接单后订单状态变更为"已接单"。
6. 服务执行与完成
服务人员按约定时间上门服务,服务完成后客户确认,订单状态变更为"已完成",客户可进行评价。
三、核心数据模型设计
在实现预约流程之前,需要设计合理的数据模型。以下是核心实体的关键字段说明:
订单表(service_order) 主要包含:订单ID、客户ID、服务人员ID、服务类型、服务地址、预约开始时间、预约结束时间、订单状态、总金额、支付方式、创建时间等字段。
服务人员排期表(staff_schedule) 主要包含:排期ID、服务人员ID、订单ID、开始时间、结束时间、排期状态等字段。
订单状态建议使用枚举管理,包括:待支付、已预约、已接单、服务中、已完成、已取消等状态。
四、核心代码实现
预约下单接口(含时间冲突校验)
以下示例使用 Spring Boot + MyBatis-Plus 实现客户提交预约的核心逻辑,重点在于服务人员时间冲突校验和订单创建:
public class OrderServiceImpl implements OrderService { private ServiceOrderMapper orderMapper; private StaffScheduleMapper scheduleMapper; private StaffMapper staffMapper; (rollbackFor = Exception.class) public Result createAppointment(OrderCreateDTO dto) { // 1. 参数校验 if (dto.getStaffId() == null || dto.getStartTime() == null || dto.getEndTime() == null || dto.getAddress() == null) { return Result.fail("必填参数不能为空"); } // 2. 校验服务人员是否存在且状态正常 Staff staff = staffMapper.selectById(dto.getStaffId()); if (staff == null || staff.getStatus() != 1) { return Result.fail("服务人员不存在或已停用"); } // 3. 核心:校验时间冲突 LambdaQueryWrapper<StaffSchedule> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(StaffSchedule::getStaffId, dto.getStaffId()) .eq(StaffSchedule::getScheduleStatus, 1) .lt(StaffSchedule::getStartTime, dto.getEndTime()) .gt(StaffSchedule::getEndTime, dto.getStartTime()); Long conflictCount = scheduleMapper.selectCount(wrapper); if (conflictCount > 0) { return Result.fail("所选时间段已被预约,请选择其他时间"); } // 4. 创建订单 ServiceOrder order = new ServiceOrder(); order.setCustomerId(dto.getCustomerId()); order.setStaffId(dto.getStaffId()); order.setServiceType(dto.getServiceType()); order.setAddress(dto.getAddress()); order.setStartTime(dto.getStartTime()); order.setEndTime(dto.getEndTime()); order.setOrderStatus(OrderStatus.PENDING_PAYMENT.getCode()); order.setTotalAmount(calculateAmount(dto)); orderMapper.insert(order); // 5. 创建排期记录(锁定时间段) StaffSchedule schedule = new StaffSchedule(); schedule.setStaffId(dto.getStaffId()); schedule.setOrderId(order.getId()); schedule.setStartTime(dto.getStartTime()); schedule.setEndTime(dto.getEndTime()); schedule.setScheduleStatus(1); scheduleMapper.insert(schedule); return Result.success(order.getId()); } private BigDecimal calculateAmount(OrderCreateDTO dto) { long hours = (dto.getEndTime().getTime() - dto.getStartTime().getTime()) / (1000 * 60 * 60); Staff staff = staffMapper.selectById(dto.getStaffId()); return staff.getHourlyRate().multiply(BigDecimal.valueOf(hours)); } }
订单状态流转管理
家政服务订单的状态流转是业务核心,需要严格控制状态变更的合法性,防止出现非法状态跳转:
public class OrderStatusServiceImpl implements OrderStatusService { private ServiceOrderMapper orderMapper; private StaffScheduleMapper scheduleMapper; // 定义合法的状态流转规则 private static final Map<Integer, Set<Integer>> ALLOWED_TRANSITIONS = new HashMap<>(); static { // 待支付 -> 已预约(支付成功) / 已取消(超时未支付或主动取消) ALLOWED_TRANSITIONS.put(OrderStatus.PENDING_PAYMENT.getCode(), Set.of(OrderStatus.APPOINTED.getCode(), OrderStatus.CANCELLED.getCode())); // 已预约 -> 已接单(服务人员确认) / 已取消(客户取消) ALLOWED_TRANSITIONS.put(OrderStatus.APPOINTED.getCode(), Set.of(OrderStatus.ACCEPTED.getCode(), OrderStatus.CANCELLED.getCode())); // 已接单 -> 服务中(开始服务) / 已取消(双方协商取消) ALLOWED_TRANSITIONS.put(OrderStatus.ACCEPTED.getCode(), Set.of(OrderStatus.IN_SERVICE.getCode(), OrderStatus.CANCELLED.getCode())); // 服务中 -> 已完成 ALLOWED_TRANSITIONS.put(OrderStatus.IN_SERVICE.getCode(), Set.of(OrderStatus.COMPLETED.getCode())); } (rollbackFor = Exception.class) public Result changeOrderStatus(Long orderId, Integer targetStatus, Long operatorId) { ServiceOrder order = orderMapper.selectById(orderId); if (order == null) { return Result.fail("订单不存在"); } Integer currentStatus = order.getOrderStatus(); // 校验状态流转是否合法 Set<Integer> allowedTargets = ALLOWED_TRANSITIONS.get(currentStatus); if (allowedTargets == null || !allowedTargets.contains(targetStatus)) { return Result.fail("当前订单状态不允许此操作"); } // 更新订单状态 order.setOrderStatus(targetStatus); order.setUpdateTime(LocalDateTime.now()); orderMapper.updateById(order); // 如果订单被取消,释放排期 if (targetStatus == OrderStatus.CANCELLED.getCode()) { LambdaQueryWrapper<StaffSchedule> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(StaffSchedule::getOrderId, orderId); StaffSchedule schedule = scheduleMapper.selectOne(wrapper); if (schedule != null) { schedule.setScheduleStatus(0); scheduleMapper.updateById(schedule); } } return Result.success("状态更新成功"); } }
五、设计要点总结
在实际开发家政服务平台的预约流程时,除了上述核心代码外,还需关注以下几个方面:
并发安全:多个客户同时预约同一服务人员的同一时间段时,需要在数据库层面加锁或使用乐观锁机制,防止超卖。可以在排期表上对 (staff_id, start_time, end_time) 建立唯一索引来兜底。
超时处理:订单创建后若客户长时间未支付,应通过定时任务或延迟队列自动取消订单并释放排期,避免时间段被无效锁定。
通知机制:订单状态变更时应及时通知相关方(如支付成功通知服务人员、接单成功通知客户等),可通过消息队列异步处理。
退款逻辑:已支付的订单在取消时需要根据业务规则判断是否退款、退款比例等,这部分逻辑建议独立为单独的退款服务。
六、结语
家政服务平台的预约流程核心在于时间段的冲突校验和订单状态的严格管控。以上代码给出了基本的实现思路,实际项目中还需要结合具体的业务需求进行扩展和完善。希望本文对正在开发类似系统的同学有所帮助。