STEP 4 / 5

📝 需求文档

写清楚每一个细节，不留死角
📝 Demo 验证完了，现在要把想法写成正式需求文档（PRD）。

好文档的标准：开发看了一句话都不用问你。

下面4个模块，一个都不能少！
🧪 互动 1/3 · 交互流程图
🔄 交互流程：详细到每一步

点击下面流程图的每个步骤，查看详细交互说明。
想一想：还有哪些步骤没写清楚？

👤 用户打开首页
↓
📊 点击「专家关注排行榜」
↓
🥇 看到 TOP 关注点列表
↓
🔎 点击某一项查看详情
↓
💾 点击「我想学这个」
↓
✅ 完成记录 + 推荐课程
📌 详细交互：
• 首页加载时，判断用户是否首次使用
• 首次：展示引导动画（3步）
• 非首次：直接展示主页内容
• 底部 Tab 栏：首页 / 排行榜 / 我的
📌 详细交互：
• 点击后触发埋点：「click_rank_enter」
• 页面转场动画：从右滑入（0.3s）
• 加载中展示 Skeleton 占位条（2条）
📌 详细交互：
• 列表按「提及次数」降序排列
• 每条展示：排名徽章 + 关键词 + 提及次数 + 趋势箭头
• 支持下拉刷新（刷新动画：三个跳动的点）
• 空状态：提示「暂无数据，请联系管理员」
📌 详细交互：
• 进入详情页，展示：关键词定义 / 老板提及原因 / 相关课程
• 支持分享（生成海报，带二维码）
• 支持收藏（收藏后显示在「我的」页面）
📌 详细交互：
• 点击后弹确认框：「确认对【XX】感兴趣？」
• 确认后：写入后端 + 展示推荐课程卡片
• 如果未登录：跳转登录页，登录后返回当前页（不是首页！）
• 网络错误：Toast 提示「网络不太好，稍后再试」
📌 详细交互：
• 展示成功动画（✅ 打勾，0.5s）
• 推荐课程卡片：课程名 / 讲师 / 时长 / 报名按钮
• 同时发送企微通知给用户的导师（如果已绑定）
• 可点击「返回排行榜」继续浏览
💡 自检提问：每一步的加载中、空状态、错误状态都写清楚了吗？没写 = 开发会来问你 = 文档不合格。
🧪 互动 2/3 · 找逻辑冲突
⚠️ 主流程：有没有逻辑冲突？

下面是一段「主流程描述」，里面藏了3个逻辑冲突。
你能找出来吗？点击你认为有问题的句子：

📋 主流程描述（请找茬）：

① 用户进入排行榜页面，默认展示全公司所有专家的关注点。
② 用户可以选择按「部门」筛选，但系统不会记住用户的上次选择。
③ 用户点击「我想学这个」后，系统直接记录兴趣并推荐课程。
④ 如果用户未登录，点击任何按钮都会跳转到登录页，登录后返回首页（不是返回刚才的页面）。
⑤ 推荐课程如果加载失败，整个页面展示「系统错误」并阻止用户继续浏览。
🧪 互动 3/3 · 边际条件
🌀 边际条件：极端情况怎么处理？

边际条件 = 正常情况下不会发生，但一旦发生就很崩溃的事。
点击下面的场景，查看「标准答案」怎么处理：

🌐 网络不好 / 请求超时 ▶
处理方式：
• 所有网络请求设置 5s 超时
• 超时后展示 Toast：「网络不太好，点击重试」
• 重试最多 2 次，2次失败后展示离线占位图
• 支持弱网模式：仅加载文字，不加载图片
🤖 Bot 无法回答用户问题 ▶
处理方式（Bot 二期功能）：
• 无法回答时，回复：「这个问题我还在学习，要不要去问xx专家？」
• 同时记录该问题到「未回答问题池」，每周人工补充
• 提供兜底方案：展示相关文档链接列表
• 如果连续3次无法回答，主动询问「你是否想预约专家1对1沟通？」
🤖 Bot 的回答质量很差（用户投诉） ▶
处理方式：
• 每条 Bot 回复下方加「👍 有帮助 / 👎 没帮助」反馈按钮
• 累计「没帮助」>30%，自动触发告警给PM
• PM 介入检查：是数据问题、模型问题，还是 prompt 问题
• 同时展示「换一个方式回答」按钮，用户可要求重新回答
📭 数据为空（老板没有任何关注点记录） ▶
处理方式：
• 展示空状态插画 + 文案：「这位老板很神秘，暂时没有公开关注点～」
• 提供替代行动：推荐「全公司TOP关注点」
• 允许用户输入「我想了解xx」进行反馈（收集长尾需求）
⚡ 服务器崩了 / 502 错误 ▶
处理方式：
• 展示友好错误页（插画 + 「我们的服务开小差了」）
• 提供重试按钮
• 同时触发告警通知运维同学
• 用户可点击「返回首页」继续使用缓存数据
🤖 用户问了一个超出Bot知识范围的问题 ▶
处理方式（Bot 二期）：
• Bot 诚实回答：「这个问题超出了我的知识范围，我帮你去问了xx专家，预计X天内回复你～」
• 同时给xx专家发企微通知：「有个新人问了你擅长的问题，有空回答一下吗？」
• 专家回答后，自动同步给提问用户 + 更新 Bot 知识库
💪 练习：你还想到哪些边际条件？
• Bot 回答太慢（>10s）怎么办？
• 用户问了敏感问题（如「老板会不会开除我」）怎么办？
• 用户上传的文档格式不支持怎么办？
🧪 知识卡片 · 实现方式（答案高亮）
🛠️ 需求能力 / 模型层实现方式

如果要做「老板Bot」（二期），需求文档里必须写清楚技术实现方案。
下面是一份标准答案（高亮部分），请仔细阅读：

📋 「老板Bot」技术实现方案（标准答案）
1. 数据来源
✅ 老板历史评审记录（Word/PDF）→ 用 Python + PDFMiner 解析
✅ 会议录音转文字 → 用 Whisper API 转写
✅ 评审意见 / 邮件回复 → 用 正则 + NLP 提取决策关键词
2. 模型选型
✅ 蒸馏方案：用 GPT-4o 或 Qwen2.5 做基座，蒸馏老板决策逻辑
✅ 部署方式：部署在公司内网服务器（不对外，数据安全）
✅ 知识库：用 向量数据库（Milvus） 存储老板历史语料
3. 效果评估
✅ 准确率目标：>85%（找3位专家做盲测对比）
✅ 响应时间：<2s（超时用户会流失）
✅ 评估方式：找 3位部门专家 + 5位新人 做A/B测试
4. 数据安全（HR系统特别重要！）
⚠️ Bot 只能回答「公开决策逻辑」，不能泄露员工隐私、薪资、未公开战略
⚠️ 所有 Bot 对话记录仅限运维排查用，不能被其他人查看
⚠️ 需要加敏感词过滤：薪资、裁员、晋升名单等关键词直接拒绝回答
✅ 记住：实现方案写不清楚 = 开发按自己的理解做 = 做出来的东西不是你要的。