首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >家政预约服务多端实践:师傅端、用户端H5+小程序协同

家政预约服务多端实践:师傅端、用户端H5+小程序协同

原创
作者头像
省钱兄科技
发布于 2026-11-18 14:53:54
发布于 2026-11-18 14:53:54
220
举报

家政预约服务多端实践:师傅端、用户端H5+小程序协同

在家政上门履约场景中,用户可以通过H5分享链接或者小程序下单,师傅则使用小程序或者H5工单页面接单、更新履约状态。多端协同的核心难点是:用户端与师傅端订单状态实时对齐、权限隔离、消息定向推送,同时兼容小程序和H5两者能力差异。本文基于SpringBoot+WebSocket+消息队列,介绍一套用户、师傅多端协同的实现方案,保证下单、派单、签到、完工全链路状态互通。

一、多端协同遇到的业务痛点

项目初期各端独立开发,出现了几类典型协同问题。 第一,状态不同步:师傅在师傅端小程序更新接单状态,用户H5页面没有及时刷新,用户误以为订单无人处理;第二,消息触达不一致,小程序支持微信订阅消息,H5仅支持站内消息,离线场景容易丢失通知;第三,角色权限管控混乱,师傅端接口和用户端接口没有隔离,存在越权查看他人工单的风险;第四,部分师傅设备环境限制,无法安装小程序,只能使用H5接单,两套端的工单操作逻辑不一致,容易出现状态机流转异常。 单纯依靠前端轮询刷新,会带来服务压力大、延迟高的问题,需要统一后端协同能力,对前端只做适配层处理。

二、整体架构设计

方案采用统一后端服务 + 多端适配层的架构,订单中心作为唯一数据源,所有用户端、师傅端的小程序、H5请求,统一接入网关。 网关层做身份和角色鉴权,区分用户角色和师傅角色;订单中心维护订单状态机,控制订单合法流转;派单引擎负责匹配师傅、生成工单;WebSocket负责在线实时推送,消息队列处理离线消息、订阅消息异步下发;Redis存储师傅在线状态、地理位置、工单缓存。 前端侧,用户端H5、用户小程序、师傅H5、师傅小程序共用同一套API,只根据端的能力差异做交互适配,不改动业务规则。

三、角色鉴权与工单权限隔离

登录时区分用户身份类型,后端通过身份标识控制接口访问范围。普通用户只能查看自己提交的订单;师傅只能查看分配给自己的工单,不能查看平台其他师傅工单。 每一次工单操作,都携带身份信息,后端校验订单归属关系,防止越权操作。

代码语言:javascript
复制
@Service
public class OrderSyncService {
    @Autowired
    private StringRedisTemplate redisTemplate;
    @Autowired
    private WebSocketPushService webSocketPushService;
    @Autowired
    private RocketMQTemplate rocketMQTemplate;
    private static final String ORDER_STATUS_KEY = "house:order:status:";

    public ResultDTO<String> updateOrderStatus(OrderStatusDTO dto) {
        // 权限校验:判断操作者是否为订单所属师傅
        OrderInfo order = orderMapper.selectById(dto.getOrderId());
        if (!order.getStaffId().equals(dto.getOperatorId())) {
            return ResultDTO.fail("无权限操作该工单");
        }
        // 状态机校验,判断是否允许流转
        boolean canChange = orderStateMachine.checkState(order.getStatus(), dto.getNewStatus());
        if (!canChange) {
            return ResultDTO.fail("当前订单状态不支持该操作");
        }
        // 更新数据库与缓存
        order.setStatus(dto.getNewStatus());
        order.setOperateTime(LocalDateTime.now());
        orderMapper.updateById(order);
        redisTemplate.opsForValue().set(ORDER_STATUS_KEY + dto.getOrderId(), dto.getNewStatus(), 3, TimeUnit.DAYS);
        // 构建事件,推送用户端和师傅端
        OrderStatusEvent event = new OrderStatusEvent();
        event.setOrderId(dto.getOrderId());
        event.setUserId(order.getUserId());
        event.setStaffId(order.getStaffId());
        event.setNewStatus(dto.getNewStatus());
        rocketMQTemplate.convertAndSend("order-status-event-topic", event);
        webSocketPushService.pushOrderEvent(event);
        return ResultDTO.success("状态更新成功");
    }
}

四、WebSocket定向推送与在线状态管理

WebSocket服务维护两类连接映射:userId和session集合、staffId和session集合。当师傅更新订单状态,推送服务同时向该用户所有在线终端(用户小程序、用户H5)推送变更事件;也向该师傅的所有在线终端(师傅小程序、师傅H5)同步最新工单信息。 增加心跳检测,定时清理离线连接,Redis记录师傅在线状态,派单引擎优先推送给在线师傅。 WebSocket作为实时通道,离线用户、师傅的消息存入站内消息表,下次打开页面自动拉取,和订阅消息形成互补。

五、派单引擎与多端接单逻辑

派单引擎根据服务品类、地理位置、师傅负载、评分筛选候选师傅,支持自动派单和抢单两种模式。 工单消息下发后,师傅无论是小程序还是H5打开,展示的工单信息、接单/拒单按钮、校验规则完全一致。师傅接单操作成功后,订单状态变更,立刻推送通知给对应用户。 同时增加接单超时机制,超过指定时长未接单,系统自动回收工单,重新进入派单池,并且推送超时提醒。

六、前端多端适配策略

前端基于UniApp实现,用户端、师傅端分为两个项目,同时编译输出小程序包和H5资源。

  1. 交互适配:小程序支持订阅消息,H5使用浏览器通知+站内消息;
  2. 定位适配:统一封装定位工具,兼容小程序定位API和H5地理定位;
  3. 图片上传:师傅签到凭证、服务完工照片,统一上传到对象存储,两端共用访问地址;
  4. 路由适配:H5通过链接跳转,小程序通过页面路由,后端返回统一的业务参数。 所有表单校验、价格、状态文案由后端返回,前端只做渲染,保证两端展示一致。

七、异常处理、监控与兜底方案

网络异常场景:前端提交操作失败时,在本地缓存操作记录,网络恢复后重试,后端依靠幂等号防止重复操作。 监控指标包含:WebSocket在线连接数、订单状态变更QPS、消息推送成功率、接单超时数量。推送失败的消息进入死信队列,后台可查看记录。 兜底方案:WebSocket连接断开时,前端开启低频率轮询作为降级方案,保证弱网环境下用户和师傅可以看到最新订单状态。

八、测试验证场景

测试场景:用户H5下单,师傅小程序收到工单;师傅H5接单,用户小程序收到状态更新;师傅拒单,订单重新派单;离线后再次打开,可收到离线消息;跨角色越权操作被拦截;订单状态非法流转被状态机拦截。

总结

这套多端协同方案,核心是订单中心作为单一可信数据源,通过状态机管控订单履约流程,WebSocket+消息队列实现用户端、师傅端小程序和H5的双向实时同步,网关层做好角色权限隔离。前端只针对平台能力差异做适配,业务逻辑收敛在后端,避免多端规则不一致。该方案可以和前面的跨端登录、草稿购物车、并发预约模块组合,形成完整家政预约平台。落地时重点做好消息定向推送、状态机校验、师傅在线状态维护,在实时性和系统稳定性之间做好平衡。

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

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

目录
  • 家政预约服务多端实践:师傅端、用户端H5+小程序协同
    • 一、多端协同遇到的业务痛点
    • 二、整体架构设计
    • 三、角色鉴权与工单权限隔离
    • 四、WebSocket定向推送与在线状态管理
    • 五、派单引擎与多端接单逻辑
    • 六、前端多端适配策略
    • 七、异常处理、监控与兜底方案
    • 八、测试验证场景
    • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档