数据同步规则

概述

本条目定义项目中的关键数据同步规则，用于约束不同数据类型在写入、缓存与回源刷新时的处理方式，确保数据一致性与用户体验。

同步规则

数据类型	同步规则
积分与订单	采用事务写入，订单状态变化必须同步写积分流水或退款流水
打卡与路线进度	打卡成功后立即更新路线进度缓存，客户端回源刷新
消息未读数	列表页进入时回源刷新，不依赖本地计算
商品库存	列表页允许缓存 60 秒；详情页与下单页必须回源获取实时库存 [AI假设项 A1]

详细说明

1. 积分与订单

• 使用事务写入保证订单与积分/退款流水的一致性。
• 当订单状态发生变化时，必须同步写入：
  • 积分流水，或
  • 退款流水
• 目标是避免出现订单状态已变更但积分数据未同步的异常情况。

2. 打卡与路线进度

• 用户打卡成功后，需要立即更新路线进度缓存。
• 客户端通过回源刷新获取最新路线进度。
• 该规则用于保证路线进度展示的及时性。

3. 消息未读数

• 消息未读数在进入列表页时必须回源刷新。
• 不依赖客户端本地计算未读数。
• 该规则用于降低本地状态误差带来的未读数不一致问题。

4. 商品库存

• 商品列表页可使用缓存，缓存时长为 60 秒。
• 商品详情页与下单页必须回源获取实时库存。
• 该规则兼顾列表浏览性能与交易场景下的库存准确性。
• [AI假设项 A1]：该实时库存要求为文档中的假设性标注项，落地时需进一步确认是否为正式规则。

实施要点

• 涉及交易的数据应优先保证强一致性。
• 涉及展示层的数据可根据场景采用缓存 + 回源刷新策略。
• 对库存、订单、积分等核心业务数据，需明确不同页面的数据新鲜度要求。