保姆月嫂家政服务平台全栈开发实战:从架构设计到系统落地

简介: 本文详解家政服务平台架构设计,涵盖Spring Boot+Vue技术栈、人员资质管理、智能排期调度、订单状态机等核心模块,提供数据库设计、关键代码(如服务匹配、RabbitMQ延迟取消)及安全运维要点,助力快速搭建高可用家政系统。

家政社区服务1.jpg 家政社区服务2.jpg 家政社区服务3.jpg

一、前言

家政行业数字化转型加速,保姆、月嫂等上门服务类业务对信息化系统的需求日益迫切。与标准电商系统不同,家政服务涉及人员资质管理、排期调度、上门服务履约等特殊业务场景,系统架构需要针对性设计。

本文从整体架构出发,梳理家政服务平台的核心模块划分、技术选型思路以及关键业务代码实现,帮助开发者快速搭建一套可用的家政服务平台。


二、系统整体架构设计

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 订单全生命周期状态管理

家政服务订单的状态流转比普通电商更为复杂,因为涉及线下履约环节。典型状态包括:待支付、已支付待接单、已接单待服务、服务中、待客户确认、已完成、已取消、退款中、已退款。

每一次状态变更都需要记录操作日志,便于售后纠纷追溯。


五、核心代码实现

服务人员智能匹配与推荐

客户在下单前通常需要根据条件筛选合适的服务人员,以下代码实现了基于服务类型、区域、评分等多维度的匹配查询逻辑:

@Service
public class StaffMatchServiceImpl implements StaffMatchService {

    @Autowired
    private StaffMapper staffMapper;

    @Autowired
    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的死信队列机制实现延迟取消:

@Component
public class OrderTimeoutConsumer {

    @Autowired
    private ServiceOrderMapper orderMapper;

    @Autowired
    private StaffScheduleMapper scheduleMapper;

    @Autowired
    private OrderLogMapper orderLogMapper;

    // 监听订单超时取消队列
    @RabbitListener(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);
    }
}

// 订单创建时发送延迟消息
@Service
public class OrderProducer {

    @Autowired
    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加速

七、总结

家政服务平台的开发核心在于服务人员排期管理和订单状态机流转两大主线。排期管理要保证并发场景下的数据一致性,订单状态机要保证每一次流转的合法性和可追溯性。在此基础上,围绕服务人员入驻审核、智能匹配推荐、超时自动处理等场景进行功能完善,即可搭建出一套满足基本业务需求的家政服务平台。

相关文章
|
18天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
7748 57
|
3天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1459 0
|
5天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
18天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5679 68
|
6天前
|
云安全 人工智能 安全
|
13天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2910 9
|
5天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
3天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
1931 0
|
10天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1869 1