# Splash Consent（高层规范）

## 1. 背景与目标

客户端需要一个开屏页（Splash/Welcome），用于展示品牌视觉并在**首次加载**时让用户同意隐私协议与用户使用协议。用户同意后进入后续流程（Onboarding/App）。

### 目标

- **视觉开屏**：使用 `client/assets/images/index/` 下的图片资源作为主视觉
- **首次同意**：底部渐变按钮仅在首次加载时出现，用于“同意并继续”
- **协议入口**：按钮下方提供「隐私协议」「用户使用协议」入口，用户可点击查看
- **状态持久化**：同意后不再显示该按钮（后续启动直接进入后续流程）

### 非目标（本阶段不做）

- 不实现复杂的协议版本管理（如协议更新后重新弹出），后续可扩展
- 不实现后端拉取协议内容（可先使用本地静态页面或外链）

## 2. 范围与交付物

### 范围

- 新增开屏页 UI 与路由接入
- 新增“首次同意”状态的本地持久化
- 协议入口（跳转到 WebView/外部浏览器/内置页面，方案在实现阶段确定）

### 交付物

- 开屏页（含图片、按钮、协议入口）
- 本地持久化 key 约定与读写逻辑
- README/文档更新（可选）

## 3. 视觉与交互需求

### 3.1 主视觉

- 使用 `client/assets/images/index/` 下的图片资源（例如 `index_flowers.png`）
- 布局建议：
  - 图片居中或铺满上半部分（按实际设计微调）
  - 适配不同屏幕尺寸，确保不变形/不裁切关键内容

### 3.2 底部渐变按钮（仅首次出现）

- **出现条件**：仅在首次加载且未同意协议时显示
- **按钮文案**：建议“同意并继续”（文案可后续调整，需支持 i18n）
- **按钮渐变色**：从 `#F69F7B` 到 `#F99CC0`
- **点击行为**：
  - 写入本地状态：用户已同意
  - 跳转到后续流程入口（例如 Onboarding 或 Home 的启动分发）

### 3.3 协议入口

- 位于按钮下方，展示：
  - **隐私协议**
  - **用户使用协议**
- 点击行为：打开对应协议内容
  - 支持外链或内置页面（实现阶段确认）

## 4. 首次加载判定与持久化

### 4.1 判定规则

- **首次加载定义**：App 首次启动且用户未完成协议同意

### 4.2 存储 Key（建议）

- `consent.accepted`: boolean

> 说明：后续如需协议版本化，可扩展为 `consent.versionAccepted = <version>`。

## 5. 路由与流程（与现有客户端集成）

### 5.1 流程顺序（建议）

1. App 启动
2. 若 `consent.accepted !== true`：进入开屏页（展示按钮与协议入口）
3. 用户点击“同意并继续”后：
   - 写入 `consent.accepted=true`
   - 进入后续流程（例如 Onboarding/App Shell 的启动分发）

### 5.2 与现有功能的关系

- 开屏页位于 Onboarding 之前（更符合“先同意协议再使用”的要求）
- 同意后按既有规则继续：
  - 已完成 onboarding：进入 Home
  - 未完成 onboarding：进入 Onboarding

## 6. 验收标准

- 首次启动：
  - 出现开屏页，展示图片
  - 底部渐变按钮可见，颜色正确（`#F69F7B` → `#F99CC0`）
  - “隐私协议/用户使用协议”可点击打开
  - 点击“同意并继续”后进入后续流程
- 非首次启动：
  - 不再出现“同意按钮”（且开屏页按产品要求可直接跳过或不再展示）
  - 直接进入后续流程

## 7. 风险与注意事项

- 协议内容来源若为外链，需要保证链接长期可用；若为本地页面，需要考虑后续更新机制
- iOS 不同机型安全区（底部 Home Indicator）需保证按钮与协议入口不被遮挡