一、前言
在保姆、月嫂等家政O2O平台中,服务套餐是连接客户需求与服务供给的核心商业载体。与标准电商商品不同,家政服务套餐需要兼顾服务类型(住家/白班/钟点)、服务周期(按天/按月/按疗程)、人员等级(初级/中级/高级/金牌)等多维属性,其配置模型的设计直接影响平台的运营效率和客户体验。
本文从业务建模出发,讲解家政O2O平台中服务套餐配置模块的数据库设计、核心业务逻辑及代码实现,供开发者参考。
二、服务套餐的业务建模
2.1 套餐的核心属性
一个完整的家政服务套餐通常包含以下关键属性:
- 所属服务类型:如住家保姆、白班月嫂、育儿嫂、钟点保洁等
- 服务人员等级:初级、中级、高级、金牌等不同级别对应不同定价
- 计价模式:按小时计价(钟点工)、按天计价(短期服务)、按月计价(长期驻家)
- 服务时长/周期:单次服务时长、总服务天数或月数
- 基础价格与加价规则:节假日加价、夜间加价、加急加价等
- 包含的服务项目:如月嫂套餐包含新生儿护理、产妇护理、月子餐制作等
- 适用区域:不同城市或区域可能配置不同价格体系
2.2 套餐与订单的关系
客户下单时选择的并非"服务人员"本身,而是先选定一个服务套餐,再由平台匹配或客户自选服务人员。这种设计的好处是:套餐作为标准化商品,便于运营管理和价格管控;服务人员作为履约资源,与套餐解耦。
订单创建时,需要将套餐的价格快照写入订单,避免套餐后续调价影响历史订单。
三、数据库核心表设计
3.1 服务套餐表(service_package)
核心字段包括:套餐ID、套餐名称、服务类型ID、服务等级、计价模式(hour/day/month)、基础单价、单次最低时长、最小起订量、包含服务项目(JSON数组)、适用区域编码列表、套餐描述、封面图URL、排序权重、上架状态、创建时间、更新时间。
3.2 套餐加价规则表(package_price_rule)
核心字段包括:规则ID、套餐ID、规则类型(节假日/夜间/加急/自定义)、加价方式(固定金额/百分比)、加价数值、生效时间段、状态。
3.3 套餐与服务人员关联表(package_staff)
核心字段包括:关联ID、套餐ID、服务人员ID、该人员在此套餐下的实际单价(可能因个人资历有浮动)、是否默认推荐。
四、套餐配置的核心业务流程
4.1 后台运营配置套餐
运营人员在后台创建套餐时,需要依次完成:选择服务类型 → 设定服务等级与计价模式 → 配置基础价格 → 添加加价规则 → 关联服务人员 → 设定适用区域 → 上架发布。
4.2 客户端套餐展示与选择
客户在小程序或H5端浏览时,系统根据客户所在区域筛选可用套餐,按服务类型分组展示。客户选定套餐后进入服务人员选择环节,或直接由平台智能匹配。
4.3 下单时的价格计算
客户提交预约时,系统需要根据套餐基础价格、加价规则、服务时长等综合计算最终订单金额。计算过程需要考虑多个加价规则的叠加逻辑。
五、核心代码实现
套餐价格计算器
以下代码实现了订单下单时的价格计算逻辑,支持基础价格、时长计价、节假日加价、夜间加价等多种规则的叠加计算:
public class PackagePriceCalculator { private ServicePackageMapper packageMapper; private PackagePriceRuleMapper ruleMapper; public Result<PriceCalculationVO> calculatePrice(PriceCalculationDTO dto) { ServicePackage pkg = packageMapper.selectById(dto.getPackageId()); if (pkg == null || pkg.getStatus() != 1) { return Result.fail("套餐不存在或已下架"); } PriceCalculationVO vo = new PriceCalculationVO(); vo.setPackageId(pkg.getId()); vo.setPackageName(pkg.getName()); // 1. 计算基础价格 BigDecimal baseAmount = calculateBaseAmount(pkg, dto); vo.setBaseAmount(baseAmount); // 2. 查询并应用加价规则 LambdaQueryWrapper<PackagePriceRule> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(PackagePriceRule::getPackageId, pkg.getId()) .eq(PackagePriceRule::getStatus, 1); List<PackagePriceRule> rules = ruleMapper.selectList(wrapper); BigDecimal surchargeTotal = BigDecimal.ZERO; List<PriceSurchargeVO> surchargeDetails = new ArrayList<>(); for (PackagePriceRule rule : rules) { BigDecimal surcharge = applyRule(rule, dto, baseAmount); if (surcharge.compareTo(BigDecimal.ZERO) > 0) { surchargeTotal = surchargeTotal.add(surcharge); PriceSurchargeVO detail = new PriceSurchargeVO(); detail.setRuleType(rule.getRuleType()); detail.setRuleDescription(buildRuleDescription(rule)); detail.setAmount(surcharge); surchargeDetails.add(detail); } } vo.setSurchargeDetails(surchargeDetails); vo.setSurchargeTotal(surchargeTotal); vo.setFinalAmount(baseAmount.add(surchargeTotal)); return Result.success(vo); } private BigDecimal calculateBaseAmount(ServicePackage pkg, PriceCalculationDTO dto) { long duration = calculateDuration(pkg.getPricingMode(), dto.getStartTime(), dto.getEndTime()); return pkg.getBasePrice().multiply(BigDecimal.valueOf(duration)); } private long calculateDuration(String pricingMode, LocalDateTime start, LocalDateTime end) { switch (pricingMode) { case "hour": return java.time.Duration.between(start, end).toHours(); case "day": return java.time.temporal.ChronoUnit.DAYS.between(start, end); case "month": return java.time.temporal.ChronoUnit.MONTHS.between(start, end); default: return 1; } } private BigDecimal applyRule(PackagePriceRule rule, PriceCalculationDTO dto, BigDecimal baseAmount) { if (!isRuleApplicable(rule, dto)) { return BigDecimal.ZERO; } if ("fixed".equals(rule.getSurchargeMode())) { return rule.getSurchargeValue(); } else { return baseAmount.multiply(rule.getSurchargeValue()).divide(BigDecimal.valueOf(100), 2, RoundingMode.HALF_UP); } } private boolean isRuleApplicable(PackagePriceRule rule, PriceCalculationDTO dto) { if (dto.getStartTime() == null) return false; switch (rule.getRuleType()) { case "night": int hour = dto.getStartTime().getHour(); return hour >= 22 || hour < 6; case "holiday": return isHoliday(dto.getStartTime().toLocalDate()); default: return true; } } private boolean isHoliday(LocalDate date) { // 实际项目中可对接节假日API或本地节假日表 return false; } private String buildRuleDescription(PackagePriceRule rule) { String typeDesc = "fixed".equals(rule.getSurchargeMode()) ? "加收" + rule.getSurchargeValue() + "元" : "加收" + rule.getSurchargeValue() + "%"; return rule.getRuleType() + ":" + typeDesc; } }
套餐后台管理(含上下架与区域配置)
后台运营对套餐的管理是平台日常运营的核心操作,以下代码实现了套餐的创建、编辑、上下架以及适用区域配置:
("/admin/package") public class PackageAdminController { private ServicePackageMapper packageMapper; private PackagePriceRuleMapper ruleMapper; private PackageStaffMapper packageStaffMapper; ("/create") public Result createPackage( PackageCreateDTO dto) { // 1. 参数校验 if (dto.getName() == null || dto.getServiceTypeId() == null || dto.getBasePrice() == null || dto.getPricingMode() == null) { return Result.fail("套餐名称、服务类型、基础价格和计价模式为必填项"); } // 2. 创建套餐主记录 ServicePackage pkg = new ServicePackage(); pkg.setName(dto.getName()); pkg.setServiceTypeId(dto.getServiceTypeId()); pkg.setServiceLevel(dto.getServiceLevel()); pkg.setPricingMode(dto.getPricingMode()); pkg.setBasePrice(dto.getBasePrice()); pkg.setMinDuration(dto.getMinDuration()); pkg.setIncludedServices(dto.getIncludedServices()); pkg.setApplicableAreas(dto.getApplicableAreas()); pkg.setDescription(dto.getDescription()); pkg.setCoverUrl(dto.getCoverUrl()); pkg.setSortWeight(dto.getSortWeight() != null ? dto.getSortWeight() : 0); pkg.setStatus(0); // 默认下架状态,需手动上架 packageMapper.insert(pkg); // 3. 批量插入加价规则 if (dto.getPriceRules() != null && !dto.getPriceRules().isEmpty()) { for (PackagePriceRuleDTO ruleDTO : dto.getPriceRules()) { PackagePriceRule rule = new PackagePriceRule(); rule.setPackageId(pkg.getId()); rule.setRuleType(ruleDTO.getRuleType()); rule.setSurchargeMode(ruleDTO.getSurchargeMode()); rule.setSurchargeValue(ruleDTO.getSurchargeValue()); rule.setStatus(1); ruleMapper.insert(rule); } } // 4. 关联服务人员 if (dto.getStaffIds() != null && !dto.getStaffIds().isEmpty()) { for (Long staffId : dto.getStaffIds()) { PackageStaff ps = new PackageStaff(); ps.setPackageId(pkg.getId()); ps.setStaffId(staffId); ps.setIsDefault(0); packageStaffMapper.insert(ps); } } return Result.success(pkg.getId()); } ("/toggleStatus") public Result togglePackageStatus( Long packageId, Integer status) { ServicePackage pkg = packageMapper.selectById(packageId); if (pkg == null) { return Result.fail("套餐不存在"); } // 上架前校验:必须关联至少一名服务人员 if (status == 1) { LambdaQueryWrapper<PackageStaff> wrapper = new LambdaQueryWrapper<>(); wrapper.eq(PackageStaff::getPackageId, packageId); Long staffCount = packageStaffMapper.selectCount(wrapper); if (staffCount == 0) { return Result.fail("该套餐尚未关联服务人员,无法上架"); } } pkg.setStatus(status); pkg.setUpdateTime(LocalDateTime.now()); packageMapper.updateById(pkg); return Result.success(status == 1 ? "套餐已上架" : "套餐已下架"); } ("/updateAreas") public Result updateApplicableAreas( Long packageId, List<String> areaCodes) { ServicePackage pkg = packageMapper.selectById(packageId); if (pkg == null) { return Result.fail("套餐不存在"); } pkg.setApplicableAreas(areaCodes); pkg.setUpdateTime(LocalDateTime.now()); packageMapper.updateById(pkg); return Result.success("适用区域更新成功"); } }
六、设计要点与扩展建议
价格快照机制:客户下单时,必须将当时的套餐价格、加价规则等计算结果以快照形式写入订单记录。后续运营调整套餐价格不会影响已创建的订单,这是避免售后纠纷的关键设计。
套餐版本管理:运营频繁调整套餐内容时,建议引入版本号机制。每次修改套餐核心字段(价格、服务项目等)时自动递增版本号,历史订单关联旧版本号,便于追溯。
区域化定价:同一套餐在不同城市可能有不同定价。可以通过"基础套餐 + 区域价格系数"的方式实现,避免为每个城市单独创建套餐,降低运营维护成本。
套餐推荐策略:在客户端展示时,可以根据客户历史订单、所在区域的热销数据、服务人员评分等维度进行个性化排序,提升转化率。
七、总结
家政O2O平台的服务套餐配置模块,核心在于灵活的价格模型和清晰的套餐-订单关联关系。价格模型需要支持多种计价模式和加价规则的叠加计算,套餐与订单之间需要通过价格快照保证数据一致性。在此基础上,配合后台的套餐管理、区域配置、人员关联等功能,即可构建一套完整的家政服务商品化体系。