家政上门服务系统开发实战:多服务类型下单流程设计与核心代码解析

简介: 本文分享家政上门服务系统多类型下单的设计方案:通过策略模式抽象服务类型(定价、时段、技能等),统一五步下单流程,前后端协同实现可扩展架构。含Spring Boot+Vue3实战代码与关键踩坑经验。

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

一、业务背景与问题定义

家政上门服务业务通常包含多种服务类型——日常保洁、深度保洁、家电清洗、开荒保洁、收纳整理等。不同服务类型在定价模型、服务时长、所需人员技能、可预约时段等方面存在显著差异。如何在同一套系统中优雅地支撑多服务类型的下单流程,是系统设计时需要重点解决的问题。

本文从领域建模、流程编排和核心代码三个层面,分享一套经过实践验证的设计方案。

二、整体系统架构

系统采用经典的前后端分离架构:

层级 技术选型 说明
前端 Vue 3 + Vant 4 移动端 H5,适配微信内置浏览器
网关 Nginx 反向代理、HTTPS 终止、静态资源托管
后端 Spring Boot 3.x RESTful API,统一鉴权与限流
数据层 MySQL 8.0 + Redis 业务数据持久化 + 缓存/分布式锁
消息 RocketMQ 订单状态变更事件驱动

三、多服务类型建模思路

3.1 服务类型抽象

核心思路是将"服务类型"作为一等公民建模,通过策略模式将不同服务类型的差异化逻辑解耦:

ServiceType(服务类型)
├── id, name, code              -- 基础信息
├── pricingModel                -- 定价模型(按小时/按面积/按件)
├── durationEstimate            -- 预估服务时长
├── requiredSkills              -- 所需技能标签
├── slotGranularity             -- 时段粒度(2小时/半天/全天)
└── cancellationPolicy          -- 取消政策

不同服务类型的下单差异主要体现在:

  • 定价计算:日常保洁按小时计价,开荒保洁按面积计价,家电清洗按台计价。
  • 时段粒度:日常保洁支持 2 小时粒度预约,开荒保洁以半天为单位。
  • 人员匹配:不同技能标签对应不同师傅池。

3.2 下单流程统一编排

尽管服务类型各异,下单流程可以抽象为统一的五步流水线:

选择服务类型 → 配置服务参数 → 选择时段 → 填写信息 → 确认提交

每一步的具体行为由服务类型策略驱动,流程骨架保持不变。这种设计使得新增服务类型时只需扩展策略实现,无需修改主流程。

四、核心代码示例

后端——基于策略模式的多服务类型定价与下单服务

// 定价策略接口
public interface PricingStrategy {
    BigDecimal calculatePrice(ServiceOrderContext context);
}

// 按小时计价策略(如日常保洁)
@Service("hourlyPricing")
public class HourlyPricingStrategy implements PricingStrategy {
    @Override
    public BigDecimal calculatePrice(ServiceOrderContext ctx) {
        BigDecimal unitPrice = ctx.getServiceType().getUnitPrice();
        Integer hours = ctx.getRequestedHours();
        return unitPrice.multiply(BigDecimal.valueOf(hours));
    }
}

// 按面积计价策略(如开荒保洁)
@Service("areaPricing")
public class AreaPricingStrategy implements PricingStrategy {
    @Override
    public BigDecimal calculatePrice(ServiceOrderContext ctx) {
        BigDecimal unitPrice = ctx.getServiceType().getUnitPrice();
        BigDecimal area = ctx.getRequestedArea();
        return unitPrice.multiply(area);
    }
}

// 统一下单服务
@Service
public class OrderService {

    @Autowired
    private Map<String, PricingStrategy> pricingStrategies;
    @Autowired
    private RedisTemplate<String, String> redisTemplate;

    public OrderVO createOrder(OrderCreateDTO dto) {
        ServiceTypeDO serviceType = serviceTypeMapper.selectById(dto.getServiceTypeId());

        // 1. 根据服务类型选择定价策略
        PricingStrategy strategy = pricingStrategies.get(serviceType.getPricingModel());
        ServiceOrderContext ctx = buildContext(dto, serviceType);
        BigDecimal totalPrice = strategy.calculatePrice(ctx);

        // 2. 分布式锁防止时段冲突
        String lockKey = String.format("slot:%d:%s:%s",
                dto.getStaffId(), dto.getAppointmentDate(), dto.getSlotStart());
        Boolean locked = redisTemplate.opsForValue()
                .setIfAbsent(lockKey, "1", 10, TimeUnit.SECONDS);
        if (!locked) {
            throw new BusinessException("该时段已被预约,请重新选择");
        }

        try {
            // 3. 创建订单
            OrderDO order = new OrderDO();
            order.setServiceTypeId(dto.getServiceTypeId());
            order.setUserId(dto.getUserId());
            order.setTotalPrice(totalPrice);
            order.setAppointmentDate(dto.getAppointmentDate());
            order.setSlotStart(dto.getSlotStart());
            order.setAddress(dto.getAddress());
            order.setStatus(OrderStatus.PENDING_PAYMENT);
            orderMapper.insert(order);

            return OrderVO.from(order);
        } finally {
            redisTemplate.delete(lockKey);
        }
    }
}

前端——多步骤下单向导组件(Vue 3)

<template>
  <div class="order-wizard">
    <van-steps :active="currentStep" active-color="#1989fa">
      <van-step>选择服务</van-step>
      <van-step>服务配置</van-step>
      <van-step>预约时段</van-step>
      <van-step>确认信息</van-step>
    </van-steps>

    <!-- Step 1: 选择服务类型 -->
    <div v-show="currentStep === 0">
      <van-grid :column-num="2" :border="false">
        <van-grid-item v-for="st in serviceTypes" :key="st.id"
          :icon="st.icon" :text="st.name" @click="selectServiceType(st)" />
      </van-grid>
    </div>

    <!-- Step 2: 根据服务类型动态渲染配置表单 -->
    <div v-show="currentStep === 1">
      <van-field v-if="selectedType?.pricingModel === 'hourly'"
        v-model="form.hours" label="服务时长(小时)" type="number" />
      <van-field v-if="selectedType?.pricingModel === 'area'"
        v-model="form.area" label="房屋面积(㎡)" type="number" />
      <van-field v-model="form.address" label="服务地址" readonly is-link @click="openMap" />
      <van-button block type="primary" @click="nextStep">下一步</van-button>
    </div>

    <!-- Step 3: 选择时段 -->
    <div v-show="currentStep === 2">
      <van-calendar v-model:show="showCalendar" @confirm="onDateConfirm" :min-date="minDate" />
      <van-picker v-if="slots.length" :columns="slots" @confirm="onSlotConfirm" />
    </div>

    <!-- Step 4: 确认提交 -->
    <div v-show="currentStep === 3">
      <van-cell title="服务类型" :value="selectedType?.name" />
      <van-cell title="预约时段" :value="form.slotLabel" />
      <van-cell title="服务地址" :value="form.address" />
      <van-cell title="预估费用" :value="`¥${estimatedPrice}`" />
      <van-submit-bar :price="estimatedPrice * 100" button-text="确认下单" @submit="submitOrder" />
    </div>
  </div>
</template>

<script setup>
import { ref, reactive, computed } from 'vue'
import { showToast } from 'vant'
import { fetchServiceTypes, fetchSlots, createOrder } from '@/api/order'

const currentStep = ref(0)
const serviceTypes = ref([])
const selectedType = ref(null)
const slots = ref([])
const showCalendar = ref(false)
const minDate = new Date()

const form = reactive({
  hours: '', area: '', address: '', slotId: null, slotLabel: ''
})

const estimatedPrice = computed(() => {
  if (!selectedType.value) return 0
  const unit = Number(selectedType.value.unitPrice) || 0
  if (selectedType.value.pricingModel === 'hourly') return unit * (Number(form.hours) || 0)
  if (selectedType.value.pricingModel === 'area') return unit * (Number(form.area) || 0)
  return unit
})

async function selectServiceType(st) {
  selectedType.value = st
  currentStep.value = 1
}

async function onDateConfirm(date) {
  showCalendar.value = false
  const res = await fetchSlots({
    serviceTypeId: selectedType.value.id,
    date: formatDate(date)
  })
  slots.value = res.data.map(s => ({ text: `${s.startTime}-${s.endTime}`, value: s.id }))
}

async function submitOrder() {
  try {
    await createOrder({
      serviceTypeId: selectedType.value.id,
      ...form,
      totalPrice: estimatedPrice.value
    })
    showToast({ type: 'success', message: '下单成功' })
  } catch (e) {
    showToast({ type: 'fail', message: e.message || '下单失败' })
  }
}
</script>

五、关键设计决策与踩坑记录

  1. 策略模式 vs 条件分支:初期用 if-else 按服务类型硬编码定价逻辑,新增类型时改动面大且容易遗漏。重构为策略模式后,新增服务类型只需实现 PricingStrategy 接口并注册 Bean,主流程零改动。
  2. 时段锁的粒度:锁的 Key 设计为 staffId + date + slotStart 三元组,而非仅按日期加锁。这样同一师傅不同时段互不影响,避免过度锁定导致可用时段骤减。
  3. 前端步骤向导的状态管理:多步骤表单容易出现用户中途退出后数据丢失的问题。解决方案是将表单状态持久化到 localStorage,页面恢复时自动回填。
  4. H5 端地图选点:微信内置浏览器对 Geolocation API 支持不稳定,建议接入腾讯地图 H5 SDK 的选点组件,兼容性更好。

六、总结

本文围绕家政上门服务系统的多服务类型下单场景,从领域建模、流程编排到前后端核心代码进行了完整梳理。核心设计思想是用策略模式隔离差异,用统一流程骨架保证一致性。实际项目中还需补充订单状态机、支付回调、售后退款等模块,欢迎交流探讨。

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