gaokao-volunteer-system/docs/UX_DESIGN.md

# 用户体验设计文档 (UX Design)

## 用户交互流程与体验设计

**版本**: v1.0
**状态**: 设计中
**最后更新**: 2026-06-11

---

## 1. 多端支持策略

### 1.1 当前状态 (v2.0)

| 端               |    状态     | 支持方式    | 使用场景               |
| ---------------- | :---------: | ----------- | ---------------------- |
| **Hermes对话**   |  ✅ 已支持  | 文字对话    | 深度咨询、复杂方案生成 |
| **命令行**       |  ✅ 已支持  | 终端命令    | 技术用户、批量处理     |
| **Web端 (PC)**   | ⏳ 2027年Q2 | 浏览器      | 完整功能、可视化报告   |
| **Web端 (手机)** | ⏳ 2027年Q2 | 响应式/PWA  | 移动端访问、咨询       |
| **原生App**      | 📋 2028年+  | iOS/Android | 高级体验、推送通知     |

**说明**：

- ❌ 不做小程序（限制多、需要审核、不易扩展）
- ✅ Web端为主战场（PC + 手机一套代码）
- ✅ 未来根据需要做原生App

### 1.2 Web端设计 (2027年Q2) - 核心交付物

#### 技术方案

- **响应式设计**: 一套代码适配 PC + 平板 + 手机
- **PWA支持**: 可添加到主屏幕，接近原生体验
- **不依赖任何应用商店**：浏览器即用，无审核限制
- **离线缓存**: 报告可离线查看

#### 核心功能

```
Web端功能架构:
├── 首页
│   ├── 快速咨询入口
│   ├── 省份选择
│   └── 成功案例展示
│
├── 咨询流程
│   ├── 信息采集表单
│   ├── 实时对话界面
│   └── 方案生成进度
│
├── 报告中心
│   ├── 历史报告列表
│   ├── PDF下载
│   └── 分享功能
│
└── 个人中心
    ├── 咨询记录
    ├── 收藏院校
    └── 设置
```

#### 移动端 Web 体验

- 单手操作友好
- 触摸优化的按钮
- 适配手机屏幕
- PWA 可添加到桌面

### 1.3 原生 App 设计 (2028年+)

#### 何时启动？

- Web端用户量稳定后
- 收到用户"想要推送通知"的反馈
- 商业化需要更深度集成

#### App 类型

- iOS App Store
- Android 应用市场
- 跨平台框架（Flutter/React Native）

---

## 2. 用户注册与登录策略

### 2.1 核心原则

> **"先服务，后注册"** - 降低使用门槛，先让用户感受到价值

### 2.2 咨询模式对比

| 模式         | 是否需要注册 |    功能限制     |   数据保存    | 适用场景           |
| ------------ | :----------: | :-------------: | :-----------: | ------------------ |
| **匿名咨询** |  ❌ 不需要   | 只能生成1个方案 |   ❌ 不保存   | 初次体验、快速了解 |
| **临时会话** |  ❌ 不需要   |    完整功能     | ⚠️ 仅本次会话 | 一次性咨询         |
| **注册用户** |   ✅ 需要    |    完整功能     |  ✅ 永久保存  | 长期跟踪、多次咨询 |

### 2.3 匿名咨询流程 (v2.0)

#### 设计说明

**当前版本(v2.0)完全支持不注册咨询：**

```
用户打开Hermes/命令行/Web
    ↓
直接输入："我是湖南考生，578分..."
    ↓
龙老师立即回应，开始咨询
    ↓
完整信息采集 → 方案生成 → 报告输出
    ↓
报告保存到本地 (/tmp/ 或当前目录)
    ↓
咨询完成，不强制注册
```

#### 匿名咨询限制

- ✅ 可完整体验所有功能
- ✅ 可生成可视化报告
- ⚠️ 报告仅保存在本地，不保存到云端
- ⚠️ 关闭会话后无法查看历史

---

## 3. 智能注册引导机制

### 3.1 自动注册触发条件

> **非强制，但智能引导**

#### 触发场景1：信息完整性达标

```
当用户提供了以下信息时：
- 姓名（或考生姓名）
- 手机号（或家长手机号）
- 省份
- 分数/位次

系统自动提示：
"您提供的资料已经很完整了，是否保存档案？
保存后您可以在任何设备上查看，下次咨询时不用重复填写。"
```

#### 触发场景2：报告生成完成后

```
报告生成后提示：
"✅ 您的志愿方案已生成！

💾 保存到云端，方便随时查看？
• 手机、电脑都能看
• 可分享给家人
• 填报前可再次咨询修改

[立即保存]  [仅本地保存]"
```

#### 触发场景3：主动提示补充信息时

```
当咨询过程中发现信息缺失：
"为了更好地为您规划，建议补充以下信息：
□ 考生姓名（用于生成报告）
□ 手机号（方便接收填报提醒）
□ 体检情况

补充后自动为您创建档案，下次登录可继续查看。"
```

### 3.2 注册流程设计

#### 极简注册 (3步完成)

```
Step 1: 确认基本信息（已预填）
━━━━━━━━━━━━━━━━━━━━
姓名：李明 (已填写)
手机号：138****8888 (已填写)
省份：湖南 (已填写)

[信息正确]  [修改]

Step 2: 设置密码
━━━━━━━━━━━━━━━━━━━━
设置登录密码（至少6位）：
[__________]

确认密码：
[__________]

💡 提示：密码用于查看档案，请牢记

Step 3: 完成
━━━━━━━━━━━━━━━━━━━━
✅ 注册成功！

您的档案号：GK20260611001

您可以通过以下方式查看：
• Web端：访问 gk.example.com
• 直接回复：查看我的方案
```

#### 密码策略

- 最小长度：6位
- 复杂度：不强制（用户自己选择）
- 找回方式：手机号验证码

### 3.3 软注册机制

#### 概念

> 先创建临时档案，用户确认后再升级为正式账户

#### 流程

```
1. 用户开始咨询
2. 系统自动生成临时档案ID (如：TEMP_20260611_001)
3. 咨询过程中自动保存信息到临时档案
4. 咨询完成时提示："是否保存档案？"
5. 用户确认后，临时档案升级为用户档案
6. 引导设置密码完成注册
```

#### 优势

- 不中断咨询流程
- 用户感受到"已有数据"，更愿意注册
- 注册过程顺滑

---

## 4. 主动信息补充提示机制

### 4.1 信息分级

| 级别     | 信息项                | 必要性 | 缺失提示                     |
| -------- | --------------------- | :----: | ---------------------------- |
| **必需** | 省份、分数/位次、选科 | ⭐⭐⭐ | 必须提供，否则无法咨询       |
| **重要** | 兴趣类型、学科强弱    | ⭐⭐⭐ | 缺少时影响方案质量，主动询问 |
| **有用** | 家庭情况、目标城市    |  ⭐⭐  | 完善后方案更精准，适时提示   |
| **可选** | 体检情况、特殊需求    |   ⭐   | 仅在相关时询问               |

#### 完善度评分

```
信息完善度：75% (重要信息已收集)

已提供：✅
• 省份、分数、选科
• 兴趣类型

建议补充：⚠️
• 学科强弱（影响专业推荐精准度）
• 家庭资源（影响院校层次建议）

点击下方快速补充：
[补充学科强弱] [补充家庭情况] [跳过，直接生成方案]
```

### 4.2 主动提示策略

#### 策略1：适时询问 (Timing-based)

```python
# 对话过程中，适时插入
if not has_strong_subjects:
    if conversation_turn >= 3 and random() < 0.3:
        prompt("对了，您孩子最擅长哪两门学科？这对我推荐专业很重要。")

if not has_family_info:
    if conversation_turn >= 5:
        prompt("顺便问一下，家里是普通工薪还是有一定资源？")
```

#### 策略2：方案生成前检查 (Pre-generation check)

```
龙老师：
"信息收得差不多了，我再确认几个关键点，确保方案更精准：

• 物理和数学是孩子的强项吗？
• 家里希望孩子毕业后直接工作还是考研？
• 有没有明确不想去的城市？

[快速回答] [直接生成方案]"
```

#### 策略3：报告中的待完善标注

```
报告页脚：
━━━━━━━━━━━━━━━━━━━━
📌 此方案基于以下信息生成：
✅ 省份、分数、位次
✅ 选科组合
✅ 兴趣类型
⚠️  学科强弱（未提供，使用默认值）
⚠️  家庭情况（未提供，使用典型值）

[补充信息，优化方案] [保持原方案]
```

### 4.3 非打扰式设计

#### 原则

> 不强制、不频繁、有价值时才问

#### 实现

- ✅ 最多每3轮对话询问1次
- ✅ 提供"跳过"选项
- ✅ 说明询问原因（为什么需要）
- ✅ 给出快速选择（减少输入成本）

---

## 5. 用户旅程地图

### 5.1 新用户旅程

```
Day 0: 初次接触
├── 渠道：朋友推荐/搜索/广告
├── 进入：Hermes对话 / Web / App
└── 动作：开始第一次咨询

Day 0: 第一次咨询 (匿名)
├── 提供基本信息（省份、分数）
├── 龙老师询问关键信息
├── 方案生成
├── 报告输出
└── 提示："保存档案可随时查看"

Day 0-7: 注册转化窗口期
├── 收到提醒（如有手机号）
├── 再次访问
└── 决定：注册 / 继续匿名

Day 7-30: 深度用户转化
├── 多次咨询
├── 查看历史方案对比
└── 决定：深度版付费（如有）
```

### 5.2 注册用户旅程

```
注册后
├── 档案创建
├── 历史咨询记录
├── 可跨设备同步（Web端 + 手机）
├── 可分享报告给家人
└── 接收填报提醒
```

---

## 6. 信息存储策略

### 6.1 数据分级存储

| 数据类型   |  匿名会话   | 临时档案 |  注册用户   | 存储时长 |
| ---------- | :---------: | :------: | :---------: | :------: |
| 咨询内容   |   ✅ 内存   |  ✅ 7天  |   ✅ 永久   |   见上   |
| 生成的方案 | ✅ 本地文件 |  ✅ 7天  |   ✅ 永久   |   见上   |
| PDF报告    |   ✅ 本地   |  ✅ 7天  |   ✅ 云端   |   见上   |
| 手机号     |     ❌      | ⚠️ 部分  | ✅ 加密存储 |    -     |

### 6.2 隐私保护

#### 数据安全措施

- ✅ 手机号加密存储
- ✅ 敏感信息脱敏显示
- ✅ 用户可删除自己的数据
- ✅ 不出售用户数据

#### 用户知情权

```
注册时明确告知：
"我们收集的信息仅用于志愿填报服务，包括：
• 基本信息（省份、分数等）
• 联系方式（用于接收提醒）
• 咨询记录（用于优化方案）

我们承诺：
• 不出售您的数据
• 不用于广告推送
• 可随时删除您的数据

[同意并继续] [查看隐私政策]"
```

---

## 7. 实现时间表

| 功能             | 版本  | 预计时间  | 优先级 |
| ---------------- | :---: | :-------: | :----: |
| 匿名咨询完整支持 | v2.0  | ✅ 已完成 |   P0   |
| 智能注册引导     | v2.1  |  2026 Q3  |   P1   |
| Web端 (PC+手机)  | v2.2  |  2027 Q2  |   P1   |
| 云端数据同步     | v2.2  |  2027 Q2  |   P1   |
| 跨设备查看       | v2.2  |  2027 Q2  |   P1   |
| 主动信息提示     | v2.1  |  2026 Q3  |   P1   |
| 原生App          | v3.0+ |   2028+   |   P3   |

---

## 8. 关键决策记录

### Decisions

#### D001: 是否支持完全匿名咨询？

**决策**: ✅ 支持
**理由**: 降低使用门槛，让用户先体验价值
**影响**: 需要在本地保存报告，不能云端同步

#### D002: 注册是否强制？

**决策**: ❌ 不强制，智能引导
**理由**: 尊重用户选择，体验优先
**实现**: 多次触发点引导，但不阻断流程

#### D003: 手机号是否必需？

**决策**: ⚠️ 推荐但不强制
**理由**: 重要但不阻断咨询
**用途**: 接收填报提醒、密码找回、个性化服务

#### D004: 主动提示频率？

**决策**: 最多3轮对话1次
**理由**: 平衡信息完整度和用户体验
**实现**: 带"跳过"选项，说明原因

#### D005: 是否做小程序？

**决策**: ❌ 不做
**理由**: 小程序限制多（审核、功能受限、扩展困难）
**替代方案**: Web端响应式设计 + PWA，覆盖所有用户场景

#### D006: Web端 vs 原生App？

**决策**: 优先 Web端，按需启动 App
**理由**: Web端开发快、跨平台、用户访问门槛低
**App启动条件**: Web端用户量大、有推送/深度集成需求时

---

## 9. 常见问题

### Q: 不注册能完整咨询吗？

**A**: ✅ 可以。当前版本(Hermes/命令行)已完全支持不注册咨询，所有功能可用，只是报告仅保存在本地。

### Q: 注册后有什么好处？

**A**:

- 方案永久保存，随时查看
- 跨设备同步（手机/电脑）
- 可分享给家人
- 接收填报提醒
- 多次咨询对比

### Q: 手机号会用于营销吗？

**A**: ❌ 不会。仅用于：密码找回、填报提醒（可选）、紧急联系。

### Q: 不想被频繁询问补充信息怎么办？

**A**: 每次询问都有"跳过"选项。也可一次性回复："使用默认值"，后续不再询问。

### Q: 未来会做App吗？

**A**: 计划2028年启动，前提是Web端用户量稳定、用户有深度集成需求。Web端是主战场。

### Q: 为什么不做小程序？

**A**:

- 小程序审核严格，政策相关功能可能受限
- 功能受限（不能做复杂逻辑）
- 跨平台体验不一致
- 维护成本高
- Web端已经能覆盖所有用户场景

---

## 10. 附录

### A. 用户反馈收集渠道

- Web端反馈表单
- 对话中直接反馈
- 邮件反馈

### B. 数据删除流程

```
用户：删除我的档案
系统：确认要删除吗？这将删除所有咨询记录。
用户：确认
系统：✅ 已删除。感谢您的使用！
```

### C. 相关文档

- [PRD](PRD.md) - 产品需求文档
- [ROADMAP](ROADMAP.md) - 产品路线图
- [ARCHITECTURE](../docs/ARCHITECTURE.md) - 技术架构

---

**版本**: v1.0
**最后更新**: 2026-06-11
**下次评审**: 2026年7月（用户反馈后）