fischer
/
geo
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
geo/docs/tasks/03-下一步行动建议系统任务规范.md

4.8 KiB
Raw Blame History

GEO平台 下一步行动建议系统 任务规范

任务目标

在每个相关页面底部显示上下文相关的"下一步行动"建议

参考设计

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

功能要求

1. 行动建议生成规则

根据用户当前状态生成行动建议：

当前状态 主要行动 次要行动 可选行动
新用户无数据 创建第一个品牌 - 了解GEO
有数据评分低 查看差距分析 添加更多竞品 设置预警
评分高无增长 设置涨粉预警 对比历史趋势 导出报告
竞品威胁 查看差距分析 设置预警 添加查询词

2. 行动卡片设计

┌─────────────────────────────────────────────────────────────┐
│ 🎯 为您推荐的下一步行动                                    │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ ⚠️ 主要                                                 │ │
│ │ 您的品牌在Kimi平台落后竞品15分                           │ │
│ │ [查看差距分析 →]                                        │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                             │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 💡 次要                                                 │ │
│ │ 添加更多查询词以获得更完整的分析                           │ │
│ │ [添加查询词 →]                                          │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                             │
│ ┌─────────────────────────────────────────────────────────┐ │
│ │ 🔔 可选                                                 │ │
│ │ 设置竞品超越预警                                         │ │
│ │ [立即设置 →]                                            │ │
│ └─────────────────────────────────────────────────────────┘ │
│                                                             │
└─────────────────────────────────────────────────────────────┘

3. 优先级规则

  • 主要行动（Primary）: 最重要且紧急的改进机会
  • 次要行动（Secondary）: 建议但非必须的优化项
  • 可选行动（Optional）: 高级功能或辅助功能

4. 实现位置

  • Dashboard页面底部（固定显示）
  • 品牌详情页底部
  • 竞品对比页底部
  • 可作为通用组件复用

技术要求

  • 独立组件：NextActionCard
  • 上下文感知：根据当前页面和数据状态生成建议
  • 性能优化：建议数据可缓存
  • 降级策略：无数据时显示默认引导

测试要求

3.1 单元测试

  • 不同状态的建议生成逻辑测试
  • 行动卡片渲染测试
  • 跳转链接测试

3.2 E2E测试

  • Dashboard中行动建议显示测试
  • 点击跳转功能测试
  • 不同用户状态下的建议变化测试

验收标准

  1. ✅ Dashboard底部显示3个行动建议
  2. ✅ 建议与用户当前状态匹配
  3. ✅ 点击行动可正确跳转
  4. ✅ 主要行动有视觉强调（红色/橙色边框）
  5. ✅ 无数据时显示引导行动
  6. ✅ 组件可复用至其他页面

文件位置

  • 组件: /Users/Chiguyong/Code/Fischer/geo/frontend/components/dashboard/NextActionCard.tsx
  • 逻辑: /Users/Chiguyong/Code/Fischer/geo/frontend/lib/next-action.ts
  • 测试: /Users/Chiguyong/Code/Fischer/geo/frontend/e2e/tests/next-action.spec.ts