一、业务背景与问题定义
家政上门服务业务通常包含多种服务类型——日常保洁、深度保洁、家电清洗、开荒保洁、收纳整理等。不同服务类型在定价模型、服务时长、所需人员技能、可预约时段等方面存在显著差异。如何在同一套系统中优雅地支撑多服务类型的下单流程,是系统设计时需要重点解决的问题。
本文从领域建模、流程编排和核心代码三个层面,分享一套经过实践验证的设计方案。
二、整体系统架构
系统采用经典的前后端分离架构:
| 层级 | 技术选型 | 说明 |
| 前端 | 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); } // 按小时计价策略(如日常保洁) ("hourlyPricing") public class HourlyPricingStrategy implements PricingStrategy { public BigDecimal calculatePrice(ServiceOrderContext ctx) { BigDecimal unitPrice = ctx.getServiceType().getUnitPrice(); Integer hours = ctx.getRequestedHours(); return unitPrice.multiply(BigDecimal.valueOf(hours)); } } // 按面积计价策略(如开荒保洁) ("areaPricing") public class AreaPricingStrategy implements PricingStrategy { public BigDecimal calculatePrice(ServiceOrderContext ctx) { BigDecimal unitPrice = ctx.getServiceType().getUnitPrice(); BigDecimal area = ctx.getRequestedArea(); return unitPrice.multiply(area); } } // 统一下单服务 public class OrderService { private Map<String, PricingStrategy> pricingStrategies; 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" ="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 ="openMap" /> <van-button block type="primary" ="nextStep">下一步</van-button> </div> <!-- Step 3: 选择时段 --> <div v-show="currentStep === 2"> <van-calendar v-model:show="showCalendar" ="onDateConfirm" :min-date="minDate" /> <van-picker v-if="slots.length" :columns="slots" ="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="确认下单" ="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>
五、关键设计决策与踩坑记录
- 策略模式 vs 条件分支:初期用
if-else按服务类型硬编码定价逻辑,新增类型时改动面大且容易遗漏。重构为策略模式后,新增服务类型只需实现PricingStrategy接口并注册 Bean,主流程零改动。 - 时段锁的粒度:锁的 Key 设计为
staffId + date + slotStart三元组,而非仅按日期加锁。这样同一师傅不同时段互不影响,避免过度锁定导致可用时段骤减。 - 前端步骤向导的状态管理:多步骤表单容易出现用户中途退出后数据丢失的问题。解决方案是将表单状态持久化到
localStorage,页面恢复时自动回填。 - H5 端地图选点:微信内置浏览器对 Geolocation API 支持不稳定,建议接入腾讯地图 H5 SDK 的选点组件,兼容性更好。
六、总结
本文围绕家政上门服务系统的多服务类型下单场景,从领域建模、流程编排到前后端核心代码进行了完整梳理。核心设计思想是用策略模式隔离差异,用统一流程骨架保证一致性。实际项目中还需补充订单状态机、支付回调、售后退款等模块,欢迎交流探讨。