景点打卡流程

概述

景点打卡流程用于支持用户在路线或景点详情页发起线下景点打卡，并在成功后更新路线进度与积分奖励。

流程步骤

步骤	用户动作	系统处理	分支
1	在路线或景点详情点击打卡	校验登录、手机号、景点状态	未登录则弹授权
2	进入 NFC 打卡页	初始化设备能力与标签监听	不支持则提示失败
3	用户触碰线下标签	发起预校验，验证标签归属与有效性	错误标签进入失败弹窗
4	调用确认接口	事务内写打卡记录、更新路线进度、记积分流水	成功返回奖励积分
5	展示结果弹窗	同步刷新景点详情、路线详情、积分余额	同景点重复打卡不重复奖励

系统处理要点

• 打卡入口位于路线详情或景点详情页面。
• 打卡前需完成以下校验：
  • 用户登录状态
  • 手机号状态
  • 景点状态是否允许打卡
• 进入打卡页后，系统需初始化：
  • NFC 设备能力检测
  • 标签监听能力
• 用户触碰线下标签后，系统需执行预校验：
  • 标签归属校验
  • 标签有效性校验
• 确认打卡时，需在事务内完成：
  • 写入打卡记录
  • 更新路线进度
  • 记录积分流水

分支与异常处理

• 未登录：弹出授权窗口。
• 设备不支持 NFC：提示打卡失败。
• 标签错误或无效：进入失败弹窗。
• 同景点重复打卡：允许展示结果，但不重复发放奖励积分。

成功结果

打卡成功后，系统需返回并展示以下结果：

• 奖励积分
• 刷新景点详情
• 刷新路线详情
• 刷新积分余额

关键规则

• 打卡确认接口需保证事务一致性。
• 积分发放与路线进度更新需与打卡记录写入保持同步。
• 同一景点重复打卡不应重复奖励。