页面全局约定

概述

本条目定义项目页面层面的统一约定，适用于各类列表页、详情页与提交流程页面，用于保证交互一致性、异常处理统一性与数据埋点规范化。

1. 登录门槛

• 浏览型页面：可免登录访问
• 以下场景相关页面：要求用户登录并绑定手机号
  • 资产
  • 抽奖
  • 打卡
  • 订单
  • 中奖
  • 图鉴
  • 地址
• 未满足条件时：需弹出授权引导

2. 全局状态

所有列表页、详情页、提交页需统一具备以下状态：

• 加载中
• 空状态
• 失败态
• 登录失效态

3. 全局防抖

以下操作按钮在点击后需立即置为 loading 状态，禁止重复提交：

• 抽奖
• 打卡
• 下单
• 支付
• 徽章解锁
• 图鉴解锁

4. 全局埋点字段

统一埋点字段包括：

• userId
• sessionId
• pageId
• bizType
• bizId
• traceId
• networkType
• deviceModel
• appVersion

5. 通用异常文案

• 网络异常：网络开小差了，请稍后重试
• 登录失效：登录状态已失效，请重新授权后继续

实施要点

• 页面初始化时应明确登录校验策略
• 所有关键提交类按钮必须接入统一防重复提交机制
• 所有页面状态与异常提示应保持统一文案与表现形式
• 埋点上报需确保全局字段完整传递