基于Spring Boot的家政服务平台开发:客户下单预约核心流程设计与实现

简介: 本文详解家政服务平台预约下单全流程,涵盖服务筛选、时间冲突校验、订单创建、状态流转(待支付→已预约→已接单→已完成)等核心环节,并提供Spring Boot+MyBatis-Plus实战代码与并发、超时、通知等设计要点,助力开发者高效构建高可靠预约系统。

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

一、引言

随着生活服务数字化程度不断提升,家政服务平台已成为连接客户与服务人员的重要桥梁。保姆、月嫂等家政服务具有预约制、时段性强、人员匹配要求高等特点,其下单预约流程的设计与普通电商订单存在显著差异。

本文将从技术实现角度,梳理家政服务平台客户下单预约的完整业务流程,并给出核心环节的代码示例,供开发者参考。


二、业务流程概览

客户下单预约的完整流程可分为以下几个阶段:

1. 服务浏览与筛选

客户进入平台后,根据服务类型(保姆、月嫂、保洁等)、服务区域、价格区间等条件筛选服务人员。系统需根据筛选条件查询符合条件的服务人员列表,并展示其基本信息、评分、历史订单量等。

2. 服务人员详情查看

客户点击某位服务人员,查看详细信息,包括资质证书、服务经验、用户评价、可预约时间段等。

3. 提交预约订单

客户选择服务类型、服务地址、期望服务时间、服务时长等信息后提交预约。此阶段需要进行以下校验:

  • 该服务人员所选时间段是否可预约(是否存在时间冲突)
  • 服务地址是否在可服务范围内
  • 客户信息是否完整

4. 订单确认与支付

系统生成订单后,客户完成支付。支付成功后订单状态变更为"已预约"。

5. 服务人员接单/平台派单

根据业务模式不同,可以是服务人员主动接单,也可以是平台自动派单。接单后订单状态变更为"已接单"。

6. 服务执行与完成

服务人员按约定时间上门服务,服务完成后客户确认,订单状态变更为"已完成",客户可进行评价。


三、核心数据模型设计

在实现预约流程之前,需要设计合理的数据模型。以下是核心实体的关键字段说明:

订单表(service_order) 主要包含:订单ID、客户ID、服务人员ID、服务类型、服务地址、预约开始时间、预约结束时间、订单状态、总金额、支付方式、创建时间等字段。

服务人员排期表(staff_schedule) 主要包含:排期ID、服务人员ID、订单ID、开始时间、结束时间、排期状态等字段。

订单状态建议使用枚举管理,包括:待支付、已预约、已接单、服务中、已完成、已取消等状态。


四、核心代码实现

预约下单接口(含时间冲突校验)

以下示例使用 Spring Boot + MyBatis-Plus 实现客户提交预约的核心逻辑,重点在于服务人员时间冲突校验和订单创建:

@Service
public class OrderServiceImpl implements OrderService {

    @Autowired
    private ServiceOrderMapper orderMapper;

    @Autowired
    private StaffScheduleMapper scheduleMapper;

    @Autowired
    private StaffMapper staffMapper;

    @Transactional(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));
    }
}

订单状态流转管理

家政服务订单的状态流转是业务核心,需要严格控制状态变更的合法性,防止出现非法状态跳转:

@Service
public class OrderStatusServiceImpl implements OrderStatusService {

    @Autowired
    private ServiceOrderMapper orderMapper;

    @Autowired
    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()));
    }

    @Transactional(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) 建立唯一索引来兜底。

超时处理:订单创建后若客户长时间未支付,应通过定时任务或延迟队列自动取消订单并释放排期,避免时间段被无效锁定。

通知机制:订单状态变更时应及时通知相关方(如支付成功通知服务人员、接单成功通知客户等),可通过消息队列异步处理。

退款逻辑:已支付的订单在取消时需要根据业务规则判断是否退款、退款比例等,这部分逻辑建议独立为单独的退款服务。


六、结语

家政服务平台的预约流程核心在于时间段的冲突校验和订单状态的严格管控。以上代码给出了基本的实现思路,实际项目中还需要结合具体的业务需求进行扩展和完善。希望本文对正在开发类似系统的同学有所帮助。

相关文章
|
18天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
7731 57
|
3天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1454 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),含详细图文教程及热门插件推荐。
5677 68
|
6天前
|
云安全 人工智能 安全
|
13天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2907 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)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
1906 0
|
10天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1869 1