一、前言
家政行业数字化转型加速,保姆、月嫂等上门服务类业务对信息化系统的需求日益迫切。与标准电商系统不同,家政服务涉及人员资质管理、排期调度、上门服务履约等特殊业务场景,系统架构需要针对性设计。
本文从整体架构出发,梳理家政服务平台的核心模块划分、技术选型思路以及关键业务代码实现,帮助开发者快速搭建一套可用的家政服务平台。
二、系统整体架构设计
2.1 技术选型
- 后端框架:Spring Boot 2.7+ / MyBatis-Plus
- 前端框架:Vue 3 + Element Plus(管理后台)、uni-app(用户端小程序/H5)
- 数据库:MySQL 8.0 + Redis(缓存与分布式锁)
- 消息队列:RabbitMQ(订单超时处理、消息通知)
- 文件存储:MinIO / 阿里云OSS(服务人员证件照、合同文件等)
- 支付:微信支付 / 支付宝
2.2 核心模块划分
整套系统可拆分为以下核心模块:
- 用户模块:客户注册登录、实名认证、地址管理
- 服务人员模块:服务人员入驻审核、资质管理、技能标签、评分体系
- 服务商品模块:服务类型管理(保姆/月嫂/保洁等)、价格策略配置
- 订单预约模块:下单预约、排期冲突校验、订单状态机管理
- 调度派单模块:智能匹配、人工派单、服务人员抢单
- 支付结算模块:在线支付、退款处理、服务人员佣金结算
- 评价售后模块:服务评价、投诉处理、售后工单
- 后台管理模块:数据看板、人员审核、订单管理、运营管理
三、数据库核心表设计思路
系统涉及的核心数据表包括:
客户表(customer):存储客户基本信息、联系方式、实名认证状态、默认地址等。
服务人员表(staff):存储服务人员基本信息、服务类型、资质证书URL、服务区域、时薪/月薪标准、评分、接单状态等。
服务类型表(service_type):存储服务分类(如住家保姆、白班月嫂、钟点保洁等),关联定价模式(按小时/按天/按月)。
订单表(service_order):存储订单编号、客户ID、服务人员ID、服务类型ID、服务地址快照、预约起止时间、订单状态、金额明细、支付状态等。
排期表(staff_schedule):记录服务人员的已占用时间段,用于预约冲突检测。
评价表(order_review):存储客户对服务的评价内容、评分、标签等。
四、关键业务流程实现
4.1 服务人员入驻与资质审核流程
服务人员入驻是平台运营的基础环节。服务人员提交个人信息、身份证、健康证、职业资格证书等材料后,后台管理员进行审核。审核通过后服务人员状态变更为"可接单",方可被客户搜索和预约。
审核流程需要注意:证件有效期管理(健康证通常一年一检)、证书真伪核验、服务人员黑名单机制等。
4.2 客户下单预约流程
客户选择服务类型和服务人员后,填写服务地址、期望服务时间、服务时长等信息提交预约。系统在创建订单前必须完成以下校验:
- 服务人员当前状态是否为"可接单"
- 所选时间段是否存在排期冲突
- 服务地址是否在服务人员的服务范围内
- 客户是否已完成实名认证(部分高价值服务要求实名)
校验通过后创建订单并锁定排期,等待客户支付。
4.3 订单全生命周期状态管理
家政服务订单的状态流转比普通电商更为复杂,因为涉及线下履约环节。典型状态包括:待支付、已支付待接单、已接单待服务、服务中、待客户确认、已完成、已取消、退款中、已退款。
每一次状态变更都需要记录操作日志,便于售后纠纷追溯。
五、核心代码实现
服务人员智能匹配与推荐
客户在下单前通常需要根据条件筛选合适的服务人员,以下代码实现了基于服务类型、区域、评分等多维度的匹配查询逻辑:
public class StaffMatchServiceImpl implements StaffMatchService { private StaffMapper staffMapper; private StaffScheduleMapper scheduleMapper; public Result<List<StaffVO>> matchStaff(StaffMatchDTO dto) { // 1. 基础条件查询 LambdaQueryWrapper<Staff> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(Staff::getStatus, 1) // 状态为可接单 .eq(dto.getServiceType() != null, Staff::getServiceType, dto.getServiceType()) .ge(dto.getMinRating() != null, Staff::getRating, dto.getMinRating()) .le(dto.getMaxHourlyRate() != null, Staff::getHourlyRate, dto.getMaxHourlyRate()); List<Staff> candidates = staffMapper.selectList(wrapper); // 2. 过滤:排除在指定时间段已有排期的服务人员 if (dto.getStartTime() != null && dto.getEndTime() != null) { List<Long> busyStaffIds = scheduleMapper.selectBusyStaffIds( dto.getStartTime(), dto.getEndTime()); candidates = candidates.stream() .filter(s -> !busyStaffIds.contains(s.getId())) .collect(Collectors.toList()); } // 3. 过滤:服务区域匹配 if (dto.getDistrictCode() != null) { candidates = candidates.stream() .filter(s -> s.getServiceAreas() != null && s.getServiceAreas().contains(dto.getDistrictCode())) .collect(Collectors.toList()); } // 4. 按评分降序、接单量降序排列,取前20条 candidates.sort((a, b) -> { int ratingCompare = b.getRating().compareTo(a.getRating()); if (ratingCompare != 0) return ratingCompare; return b.getOrderCount().compareTo(a.getOrderCount()); }); List<StaffVO> result = candidates.stream() .limit(20) .map(this::convertToVO) .collect(Collectors.toList()); return Result.success(result); } private StaffVO convertToVO(Staff staff) { StaffVO vo = new StaffVO(); vo.setId(staff.getId()); vo.setName(staff.getName()); vo.setAvatarUrl(staff.getAvatarUrl()); vo.setRating(staff.getRating()); vo.setOrderCount(staff.getOrderCount()); vo.setHourlyRate(staff.getHourlyRate()); vo.setYearsOfExperience(staff.getYearsOfExperience()); vo.setTags(staff.getTags()); return vo; } }
订单超时自动取消(基于RabbitMQ延迟队列)
家政服务订单创建后,如果客户在规定时间内未完成支付,系统需要自动取消订单并释放已锁定的排期,避免时间段被无效占用。以下使用RabbitMQ的死信队列机制实现延迟取消:
public class OrderTimeoutConsumer { private ServiceOrderMapper orderMapper; private StaffScheduleMapper scheduleMapper; private OrderLogMapper orderLogMapper; // 监听订单超时取消队列 (queues = "order.timeout.cancel.queue") public void handleOrderTimeout(Long orderId) { ServiceOrder order = orderMapper.selectById(orderId); // 幂等校验:仅处理状态为"待支付"的订单 if (order == null || order.getOrderStatus() != OrderStatus.PENDING_PAYMENT.getCode()) { return; } // 取消订单 order.setOrderStatus(OrderStatus.CANCELLED.getCode()); order.setCancelReason("支付超时,系统自动取消"); order.setUpdateTime(LocalDateTime.now()); orderMapper.updateById(order); // 释放排期,让该时间段可被其他客户预约 LambdaQueryWrapper<StaffSchedule> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(StaffSchedule::getOrderId, orderId); StaffSchedule schedule = scheduleMapper.selectOne(wrapper); if (schedule != null) { schedule.setScheduleStatus(0); // 0-已释放 scheduleMapper.updateById(schedule); } // 记录操作日志 OrderLog log = new OrderLog(); log.setOrderId(orderId); log.setOperationType("AUTO_CANCEL"); log.setOperationDesc("订单超时未支付,系统自动取消并释放排期"); log.setCreateTime(LocalDateTime.now()); orderLogMapper.insert(log); } } // 订单创建时发送延迟消息 public class OrderProducer { private RabbitTemplate rabbitTemplate; public void sendTimeoutMessage(Long orderId, long delayMillis) { rabbitTemplate.convertAndSend( "order.timeout.exchange", "order.timeout.cancel.queue", orderId, message -> { message.getMessageProperties().setExpiration(String.valueOf(delayMillis)); return message; } ); } }
六、系统部署与运维要点
6.1 环境规划
建议至少准备三套环境:开发环境(本地或云服务器)、测试环境(功能联调)、生产环境(正式运营)。生产环境建议使用云服务器集群部署,数据库启用主从复制。
6.2 安全注意事项
- 服务人员身份证、健康证等敏感文件存储需加密处理,访问接口需鉴权
- 客户手机号等个人信息在接口返回时需脱敏处理
- 支付回调接口需做签名验证,防止伪造请求
- 后台管理系统需接入操作审计日志
6.3 性能优化方向
- 服务人员列表查询使用Redis缓存,设置合理过期时间
- 排期冲突校验使用数据库唯一索引兜底,防止并发下的超卖问题
- 订单列表分页查询注意索引优化,避免全表扫描
- 图片资源使用CDN加速
七、总结
家政服务平台的开发核心在于服务人员排期管理和订单状态机流转两大主线。排期管理要保证并发场景下的数据一致性,订单状态机要保证每一次流转的合法性和可追溯性。在此基础上,围绕服务人员入驻审核、智能匹配推荐、超时自动处理等场景进行功能完善,即可搭建出一套满足基本业务需求的家政服务平台。