geo/docs/tasks/01-新用户引导向导任务规范.md

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