首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >家政上门预约双端存储设计:购物车、预约草稿跨端同步

家政上门预约双端存储设计:购物车、预约草稿跨端同步

原创
作者头像
省钱兄科技
发布于 2026-11-18 14:49:36
发布于 2026-11-18 14:49:36
160
举报

家政上门预约双端存储设计:购物车、预约草稿跨端同步

在家政预约场景,用户经常在H5挑选服务加入购物车,切换到小程序继续填写预约信息;或者在小程序填写一半预约表单,打开H5继续编辑。如果购物车、预约草稿只保存在前端本地存储,小程序storage、H5的localStorage互相隔离,切换终端后数据丢失,会打断用户预约流程。本文基于SpringBoot+Redis,设计一套云端存储方案,实现购物车、预约草稿在小程序和H5之间跨端同步,同时处理未登录访客、多端同时编辑冲突、过期清理等场景。

一、本地存储方案的痛点

小程序和H5的本地存储相互独立,小程序使用storage,H5依赖localStorage,数据无法互通。 未登录访客数据只能留在当前设备,更换设备、清除缓存后数据直接丢失;如果两端同时编辑同一份预约草稿,没有冲突检测机制,会出现数据覆盖;购物车包含家政服务、附加项目、面积、预约时段等复杂字段,单纯前端存储无法联动后端校验库存、服务范围。 另外,草稿属于临时数据,长期堆积会占用存储资源,需要自动过期清理机制,这些能力都需要后端统一管控。

二、整体存储架构设计

方案采用本地缓存+云端存储的双层模式。前端本地缓存用于弱网下快速渲染页面,提升体验;登录后以云端数据作为唯一可信数据源。 用户登录状态下,购物车、预约草稿数据写入Redis,同时落地MySQL持久化;Redis支撑高频读写,MySQL用于兜底恢复和定时清理。每条数据携带版本号,用于多端并发编辑冲突判定。数据变更后通过WebSocket推送消息给该用户所有在线终端,自动刷新购物车和草稿列表。 区分两类数据:购物车是多条服务的集合,支持增删勾选;预约草稿是单份预约表单快照,包含地址、预约时间、附加项目、备注等下单信息。

三、数据模型与存储结构设计

购物车采用Redis Hash结构,key为house:cart:userId,hash-field为服务ID,value存储JSON字符串,包含服务ID、附加项目、勾选状态、录入面积。 预约草稿单独一张数据表,核心字段:用户ID、草稿ID、草稿类型、表单JSON、版本号、最后编辑时间、过期时间。草稿设置过期时间,超过7天自动清理。 版本号是冲突控制核心,每次更新草稿,版本号自增;前端提交更新时带上当前读到的版本号,后端对比版本,版本不一致则判定冲突,拒绝覆盖。

四、后端核心同步代码实现

代码语言:javascript
复制
@Service
public class AppointmentDraftService {
    @Autowired
    private StringRedisTemplate redisTemplate;
    @Autowired
    private AppointmentDraftMapper draftMapper;
    @Autowired
    private WebSocketNoticeService webSocketNoticeService;
    private static final String DRAFT_REDIS_KEY = "house:draft:";
    private static final String CART_REDIS_KEY = "house:cart:";

    // 更新预约草稿,乐观锁控制冲突
    public ResultDTO<String> saveDraft(DraftSaveDTO dto) {
        String redisKey = DRAFT_REDIS_KEY + dto.getUserId() + ":" + dto.getDraftId();
        // 查询数据库草稿
        AppointmentDraft draft = draftMapper.selectById(dto.getDraftId());
        if(draft == null){
            draft = new AppointmentDraft();
            draft.setUserId(dto.getUserId());
            draft.setDraftId(dto.getDraftId());
            draft.setVersion(1);
        }else{
            if(!draft.getVersion().equals(dto.getVersion())){
                return ResultDTO.fail("数据已在其他终端修改,请刷新后重试");
            }
            draft.setVersion(draft.getVersion() + 1);
        }
        draft.setFormJson(dto.getFormJson());
        draft.setEditTime(LocalDateTime.now());
        draft.setExpireTime(LocalDateTime.now().plusDays(7));
        draftMapper.updateById(draft);
        // 更新Redis缓存
        redisTemplate.opsForValue().set(redisKey, JSON.toJSONString(draft), 7, TimeUnit.DAYS);
        // 推送变更通知给用户所有在线终端
        webSocketNoticeService.sendDraftChangeNotice(dto.getUserId(), draft);
        return ResultDTO.success("草稿保存成功");
    }

    // 购物车新增/修改项
    public ResultDTO<Void> addCartItem(CartItemDTO dto){
        String cartKey = CART_REDIS_KEY + dto.getUserId();
        redisTemplate.opsForHash().put(cartKey, dto.getServiceId(), JSON.toJSONString(dto));
        redisTemplate.expire(cartKey, 30, TimeUnit.DAYS);
        webSocketNoticeService.sendCartChangeNotice(dto.getUserId());
        return ResultDTO.success();
    }
}

五、未登录访客与登录合并策略

未登录访客的数据保留在前端本地,用户登录之后,前端主动拉取云端购物车、草稿,执行合并逻辑:

  1. 云端已有数据:以云端数据为主,前端本地新增的服务项合并进云端购物车,重复服务项以云端为准;
  2. 云端无数据:直接把本地访客购物车同步到云端; 合并完成后,前端清空本地独立访客缓存,后续全部走云端同步,保证小程序、H5登录后数据统一。

六、前端同步逻辑与弱网兼容

前端封装统一的同步工具,小程序、H5共用一套逻辑:

  1. 页面打开优先读取云端数据,同步更新本地缓存;
  2. 用户修改购物车、保存草稿,先更新本地缓存,再异步调用后端同步接口;
  3. 弱网环境下同步失败,在本地标记待同步队列,网络恢复后自动重试;
  4. 收到WebSocket变更推送,自动拉取最新数据,覆盖本地缓存,实现无感跨端刷新。 前端本地缓存仅作为展示兜底,提交预约、加载数据时,优先信任云端返回结果。

七、过期清理、冲突处理与监控

定时任务每日扫描草稿表,删除超过过期时间的草稿,同时清理对应Redis缓存;购物车设置30天有效期,减少无效数据。 冲突处理采用乐观锁,不做自动合并,提示用户刷新获取最新数据,避免表单字段错乱。监控指标包含草稿保存次数、购物车同步请求量、冲突失败次数、同步失败重试次数,异常上涨时触发告警。

八、测试验证场景

测试场景包含:H5添加家政服务到购物车,打开小程序购物车自动同步;小程序填写预约草稿,H5打开可继续编辑;两端同时编辑同一份草稿,触发版本冲突提示;访客H5加入购物车,小程序登录后自动合并;草稿到期自动清理;断网编辑,联网后自动同步云端。

总结

这套购物车和预约草稿跨端存储方案,依靠云端Redis+MySQL做统一存储,版本号乐观锁解决多端并发编辑冲突,WebSocket实现变更实时推送,同时兼顾未登录访客的本地缓存与登录合并。区分购物车和预约草稿的业务特性,设置不同过期策略,从根本解决小程序、H5本地存储隔离带来的数据不一致问题。该方案和前面的登录态、订单推送模块可以无缝配合,打通家政预约全链路跨端体验。落地时需要重点做好弱网重试、数据合并规则、过期清理,在用户体验和存储资源之间做好平衡。

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

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

目录
  • 家政上门预约双端存储设计:购物车、预约草稿跨端同步
    • 一、本地存储方案的痛点
    • 二、整体存储架构设计
    • 三、数据模型与存储结构设计
    • 四、后端核心同步代码实现
    • 五、未登录访客与登录合并策略
    • 六、前端同步逻辑与弱网兼容
    • 七、过期清理、冲突处理与监控
    • 八、测试验证场景
    • 总结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档