# GEO平台 新用户引导向导 任务规范

## 任务目标
实现新用户5分钟快速上手引导流程

## 参考设计
见文档: `/Users/Chiguyong/Code/Fischer/geo/docs/8-产品优化/GEO平台用户体验优化方案-v1.0.md` 第3.1节

## 功能要求

### 1. 引导流程 (5步)

**Step 1: 输入品牌名称**
- 输入框 + 开始分析按钮
- 自动品牌名称验证
- 跳过选项（如已有品牌）

**Step 2: 确认竞品（可跳过）**
- 系统推荐3个竞品（可多选）
- 支持手动添加
- "跳过"按钮

**Step 3: 选择监控平台（可跳过）**
- 7个平台多选（默认全选）
- "跳过"按钮

**Step 4: 品牌健康报告展示**
- 综合评分大数字展示
- 健康等级标签（优秀/良好/及格/危险）
- 领先/落后竞品概览
- 颜色编码（绿/黄/橙/红）

**Step 5: 下一步行动建议**
- 主要行动（最需要改进的）
- 次要行动（可选项）
- 跳过直接进入Dashboard

### 2. 技术要求

- Next.js 14 App Router
- TypeScript
- Ant Design组件
- TailwindCSS
- 响应式设计
- 渐进式披露原则

### 3. 入口条件

- 用户已登录
- 用户没有品牌数据时显示
- 完成后标记用户已完成引导

## 测试要求

### 3.1 单元测试
- 每个Step组件渲染测试
- 表单验证测试
- 导航逻辑测试

### 3.2 E2E测试
- 完整引导流程测试（5步）
- 跳过流程测试
- 直接进入Dashboard测试

## 验收标准

1. ✅ 用户首次登录无品牌时自动显示引导
2. ✅ 5步引导流程完整可执行
3. ✅ 每个Step可跳过
4. ✅ 引导完成后显示健康报告
5. ✅ 引导完成后记录状态
6. ✅ 后续登录不再显示引导（除非主动触发）
7. ✅ 所有UI使用颜色传达状态（绿=好，红=差）

## 文件位置
- 前端: `/Users/Chiguyong/Code/Fischer/geo/frontend/app/(dashboard)/onboarding/`
- 测试: `/Users/Chiguyong/Code/Fischer/geo/frontend/e2e/tests/onboarding.spec.ts`
