首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >家政预约服务多端方案:统一后端支撑小程序、H5预约能力

家政预约服务多端方案:统一后端支撑小程序、H5预约能力

原创
作者头像
码兄科技
发布于 2026-11-18 13:42:33
发布于 2026-11-18 13:42:33
640
举报

家政预约服务多端方案:统一后端支撑小程序、H5预约能力

家政上门预约业务渠道分散,用户既可以通过微信小程序长期使用,也可以通过H5分享链接快速下单。如果为小程序、H5分别开发两套后端接口,会出现业务逻辑重复、订单数据隔离、迭代同步困难等问题。本文基于SpringBoot搭建统一后端,把预约下单、档期校验、订单管理、消息通知等核心能力收敛在一套服务内,通过渠道标识做差异化适配,支撑小程序和H5双端预约业务。

一、多端独立后端带来的问题

分开开发两套后端,服务项目、预约时段、订单状态、技师派单逻辑需要重复维护,修改一处业务规则,两端代码都要同步改动,容易出现逻辑不一致。同时用户账号不互通,小程序和H5产生两个独立用户档案,无法共享地址、优惠券、历史订单。 另外,小程序和H5的通知、支付能力不一样,两套服务会增加运维、监控、故障排查成本。当用户跨端操作订单,很容易出现状态不同步、档期重复锁定的履约事故。

二、统一后端分层架构设计

整体采用前后端分离架构,后端只维护一套业务服务,小程序、H5作为前端接入层,不单独部署业务服务。 接入层通过请求头携带渠道标识,用来区分请求来源;业务层统一实现预约下单、时段校验、订单状态流转、技师匹配;适配层封装渠道差异化能力,包含登录、支付、消息通知;存储层使用MySQL持久化订单、服务项目、用户数据,Redis负责档期分布式锁、热点数据缓存。 所有预约相关的REST接口对双端开放,接口入参、出参结构统一,渠道差异不在业务逻辑里判断,而是下沉到适配模块,保证核心预约逻辑干净无侵入。

三、渠道识别与账号打通方案

使用微信UnionID作为用户唯一身份标识,小程序授权、H5网页授权完成后,绑定同一个UnionID,后端生成统一的JWT令牌,令牌内携带channel渠道字段。 渠道字段仅用于选择对应的登录、支付、通知实现,不影响订单、档期、价格等核心计算逻辑。同一个用户切换小程序、H5访问,读取的是同一套预约订单、地址信息,实现账号互通。

四、统一预约下单核心逻辑实现

预约下单的核心校验逻辑对双端完全一致,包含时段是否开放、该时段是否被锁定、服务范围是否覆盖用户地址、价格计算。使用Redis分布式锁防止超约,保证同一个时段不会被重复预约。 Java核心代码示例:

代码语言:javascript
复制
@Service
public class AppointOrderService {
    @Autowired
    private StringRedisTemplate redisTemplate;
    @Autowired
    private OrderMapper orderMapper;
    @Autowired
    private ChannelNotifyFactory channelNotifyFactory;

    private static final String SCHEDULE_LOCK = "house:schedule:lock:";

    @Transactional(rollbackFor = Exception.class)
    public ResultDTO createAppoint(AppointDTO dto) {
        String lockKey = SCHEDULE_LOCK + dto.getServiceId() + "_" + dto.getAppointTime();
        Boolean lockSuccess = redisTemplate.opsForValue().setIfAbsent(lockKey, "1", 5, TimeUnit.SECONDS);
        if (Boolean.FALSE.equals(lockSuccess)) {
            return ResultDTO.fail("当前时段已被预约,请更换时间");
        }
        AppointOrder order = new AppointOrder();
        BeanUtils.copyProperties(dto, order);
        order.setOrderStatus(1);
        orderMapper.insert(order);
        // 根据渠道选择通知方式
        channelNotifyFactory.getNotifyHandler(dto.getChannel()).sendOrderCreateNotify(order);
        return ResultDTO.success(order);
    }
}

通知工厂类根据channel动态匹配小程序订阅消息或者H5站内消息,业务代码不需要写大量if判断区分平台。

五、渠道差异化适配隔离

差异化能力全部抽离成独立适配组件,采用工厂模式管理。 登录适配:小程序调用wx.login,H5走网页授权; 支付适配:小程序使用微信支付小程序版,H5使用JSAPI支付; 消息适配:小程序支持订阅消息推送,H5依靠站内消息、浏览器通知; 接口限流适配:可以针对小程序、H5配置不同的限流阈值,H5来自公网链接,风险更高,限流策略更严格。 核心预约、档期、派单、评价逻辑完全复用,不会因为渠道不同而出现业务差异。

六、接口规范、版本与灰度策略

接口统一做版本管理,请求头携带版本号,后续迭代升级时,可以在不影响老版本的前提下新增字段。返回的基础字段统一,渠道需要的扩展字段按需附加,避免接口返回冗余数据。 同时增加渠道白名单配置,H5渠道可以单独开启防刷校验,增加验证码、频率限制,降低恶意刷预约的风险。

七、测试和运维保障要点

测试重点验证跨端操作:小程序下单,H5查看和修改订单;H5下单,小程序查看订单状态,校验档期互斥是否生效。 运维层面统一日志,所有请求带上渠道标识,日志、监控、告警都可以按渠道维度统计,方便定位H5或者小程序单独出现的问题。增加渠道异常大盘,统计各渠道下单失败、通知失败数量。

总结

这套统一后端支撑多端预约的方案,核心思路是业务逻辑统一、渠道差异隔离,避免为小程序、H5维护两套业务代码。通过UnionID打通账号,渠道标识配合工厂模式处理登录、支付、通知等差异化能力,Redis分布式锁保障预约档期安全。该方案降低了重复开发、版本同步的成本,后续新增技师APP、管理后台,都可以复用这套预约服务。在落地过程中,需要做好渠道适配层的单元测试,区分渠道风险等级配置安全策略,同时完善日志埋点,保证不同渠道的问题能够快速定位。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 家政预约服务多端方案:统一后端支撑小程序、H5预约能力
    • 一、多端独立后端带来的问题
    • 二、统一后端分层架构设计
    • 三、渠道识别与账号打通方案
    • 四、统一预约下单核心逻辑实现
    • 五、渠道差异化适配隔离
    • 六、接口规范、版本与灰度策略
    • 七、测试和运维保障要点
    • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档