家政O2O平台开发服务套餐配置模块的设计与实现

简介: 本文详解家政O2O平台服务套餐配置方案,涵盖多维属性建模(服务类型、等级、计价模式等)、数据库设计(套餐表、加价规则表、人员关联表)、核心业务流程(配置、展示、价格计算)及Java代码实现,强调价格快照、版本管理与区域化定价等关键设计。

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

一、前言

在保姆、月嫂等家政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 下单时的价格计算

客户提交预约时,系统需要根据套餐基础价格、加价规则、服务时长等综合计算最终订单金额。计算过程需要考虑多个加价规则的叠加逻辑。


五、核心代码实现

套餐价格计算器

以下代码实现了订单下单时的价格计算逻辑,支持基础价格、时长计价、节假日加价、夜间加价等多种规则的叠加计算:

@Service
public class PackagePriceCalculator {

    @Autowired
    private ServicePackageMapper packageMapper;

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

套餐后台管理(含上下架与区域配置)

后台运营对套餐的管理是平台日常运营的核心操作,以下代码实现了套餐的创建、编辑、上下架以及适用区域配置:

@RestController
@RequestMapping("/admin/package")
public class PackageAdminController {

    @Autowired
    private ServicePackageMapper packageMapper;

    @Autowired
    private PackagePriceRuleMapper ruleMapper;

    @Autowired
    private PackageStaffMapper packageStaffMapper;

    @PostMapping("/create")
    public Result createPackage(@RequestBody 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());
    }

    @PostMapping("/toggleStatus")
    public Result togglePackageStatus(@RequestParam Long packageId, @RequestParam 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 ? "套餐已上架" : "套餐已下架");
    }

    @PostMapping("/updateAreas")
    public Result updateApplicableAreas(@RequestParam Long packageId, 
                                         @RequestBody 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平台的服务套餐配置模块,核心在于灵活的价格模型和清晰的套餐-订单关联关系。价格模型需要支持多种计价模式和加价规则的叠加计算,套餐与订单之间需要通过价格快照保证数据一致性。在此基础上,配合后台的套餐管理、区域配置、人员关联等功能,即可构建一套完整的家政服务商品化体系。

相关文章
|
18天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
7750 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),含详细图文教程及热门插件推荐。
5680 68
|
6天前
|
云安全 人工智能 安全
|
13天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2912 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)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
1936 0
|
10天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1869 1