docs: 整理 MVP-2 用户反馈工单

This commit is contained in:
meijiali
2026-07-03 17:17:16 +08:00
parent 08d66656a9
commit 4dc6878f45
+41 -31
View File
@@ -917,17 +917,18 @@ WO-10 收尾与 P1 评估
### MVP-2 工单总览 ### MVP-2 工单总览
本轮用户反馈确认的主线工单如下。执行时先修本地核心链路,再做页面信息简化,最后进入公网部署;公网部署不是当前按钮 500、导出失效、任务卡住的根因,不能优先于本地可用性修复。
| 编号 | 工单 | 优先级 | 目标 | | 编号 | 工单 | 优先级 | 目标 |
|---|---|---|---| |---|---|---|---|
| WO-11 | 全站 Internal Server Error 排查与兜底 | P0 | 解决点击按钮或刷新页面出现 500 的阻塞问题 | | WO-11 | 全站 Internal Server Error 排查与兜底 | P0 | 解决点击按钮或刷新页面出现 500 的阻塞问题 |
| WO-12 | 导出 Markdown / CSV 点击失效修复 | P0 | 恢复报告和评论导出主链路 | | WO-12 | 导出 Markdown / CSV 点击失效修复 | P0 | 恢复报告和评论导出主链路 |
| WO-13 | 抓取任务进度透明化与耗时预期 | P0 | 降低长任务黑盒感,让用户知道任务是否真的在推进 | | WO-13 | 抓取任务进度透明化与耗时预期 | P0 | 降低长任务黑盒感,让用户知道任务是否真的在推进 |
| WO-14 | Demo 数据保留与新任务并存体验 | P0 | 打开页面即可看 demo 数据,同时还能新跑完整流程 | | WO-15 | 公网部署方案与上线验收 | P0 | 本地核心链路稳定后,从本机 Docker 演示推进到可公网访问的部署 |
| WO-15 | 公网部署方案与上线验收 | P0 | 从本机 Docker 演示推进到可公网访问的部署 | | WO-16 | UI 信息简化与产品化文案清理 | P1 | 简化任务 ID、时间、规模、标题和错误文案,移除演示页脚 |
| WO-16 | UI 产品化改版 | P1 | 在不破坏主链路的前提下提升页面观感和演示质感 |
| WO-17 | 默认规模数据量解释与展示优化 | P1 | 把“未达到 1250”解释为真实内容/评论不足,并在 UI 中清楚呈现 |
| WO-18 | 长时间 running 但无进度排查 | P0 | 定位任务是否真实运行,避免页面状态与数据库事实不一致 | | WO-18 | 长时间 running 但无进度排查 | P0 | 定位任务是否真实运行,避免页面状态与数据库事实不一致 |
| WO-19 | Internal Network Error / 500 统一排查 | P0 | 让按钮、刷新、搜索、导出失败时给出可理解错误,不再黑盒报错 |
保留工单:WO-14 Demo 数据方案、WO-17 默认规模数据量解释、WO-19 前端错误提示统一仍可作为后续补充,但本轮不插队到上述主线之前。
### WO-11 全站 Internal Server Error 排查与兜底 ### WO-11 全站 Internal Server Error 排查与兜底
@@ -1145,6 +1146,7 @@ feat: 增加可复现 demo 数据
背景: 背景:
- 用户明确需要公网部署,而不仅是本机 Docker 访问。 - 用户明确需要公网部署,而不仅是本机 Docker 访问。
- 本轮反馈确认:部署应排在本地核心功能稳定之后。先修复按钮 500、导出失效、running 卡住和进度黑盒,再把系统暴露给其他人使用。
目标: 目标:
@@ -1198,7 +1200,7 @@ chore: 增加公网部署配置
- 是否允许公网用户直接消耗真实 TikHub 和 AI Key。 - 是否允许公网用户直接消耗真实 TikHub 和 AI Key。
- 是否需要限制同一时间只能运行一个任务。 - 是否需要限制同一时间只能运行一个任务。
### WO-16 UI 产品化改版 ### WO-16 UI 信息简化与产品化文案清理
优先级:P1 优先级:P1
@@ -1206,20 +1208,23 @@ chore: 增加公网部署配置
- 用户明确希望后续修改 UI。 - 用户明确希望后续修改 UI。
- 当前页面主链路可用,但仍需要提升产品化观感。 - 当前页面主链路可用,但仍需要提升产品化观感。
- 本轮明确反馈:任务 ID、创建时间、创建规模、任务名称和失败原因显示过长或过技术化,影响实际使用。
目标: 目标:
- 在不破坏功能的前提下,让首页、任务列表、任务详情、报告页、内容详情页更适合演示。 - 在不破坏功能的前提下,让首页、任务列表、任务详情、报告页、内容详情页更适合实际使用和演示。
- 列表和详情页默认展示短编号,避免直接暴露完整 UUID。
- 清理用户界面上的内部英文错误枚举和演示性质文案。
包含范围: 包含范围:
- 首页信息架构优化 - 任务 ID 展示为顺序号,例如 `#1``#2``#3`;完整 UUID 只保留在详情或排查信息中
- 任务列表更像仪表盘 - 创建时间展示为 `YYYY-MM-DD HH:mm`,不显示秒、毫秒或时区冗余字符
- 任务详情页突出进度、阶段、失败原因、AI 成功率 - 创建规模展示为紧凑格式,例如 `小红书 · 5热点 × 5内容 × 50评论`
- 热点报告页和内容详情页优化阅读层次 - 任务列表、任务详情标题和面包屑不要出现过长字符串
- 按钮状态更清楚:可点击、加载中、禁用、失败 - 失败状态不直接展示 `system / unexpected_restart` 等内部英文枚举;改为中文解释或隐藏技术细节
- 空状态更友好 - 移除页脚 `内部演示工具 | 仅供学习参考`
- 移动端基础适配 - 保持首页、任务列表、任务详情、报告页、内容详情页基本布局稳定,避免把 UI 清理和大规模视觉重设计混在一起
边界情况: 边界情况:
@@ -1235,6 +1240,10 @@ chore: 增加公网部署配置
- 主要 CTA 明确。 - 主要 CTA 明确。
- 运行中和失败态清楚。 - 运行中和失败态清楚。
- UI 改动不影响创建任务、查看报告和导出。 - UI 改动不影响创建任务、查看报告和导出。
- 任务列表和详情页默认显示顺序号,不直接铺开完整 UUID。
- 创建时间、创建规模和任务标题短而可读。
- 用户界面不出现 `system / unexpected_restart` 等内部错误枚举。
- 页脚不再展示 `内部演示工具 | 仅供学习参考`
建议 commit 建议 commit
@@ -1454,21 +1463,15 @@ Git 流程:
```text ```text
WO-18 长时间 running 但无进度排查 WO-18 长时间 running 但无进度排查
WO-19 Internal Network Error / 500 统一排查
WO-11 全站 500 排查与兜底 WO-11 全站 500 排查与兜底
WO-12 导出点击失效修复 WO-12 导出点击失效修复
WO-13 抓取进度透明化 WO-13 抓取进度透明化
WO-14 Demo 数据方案 WO-16 UI 信息简化与产品化文案清理
WO-15 公网部署 WO-15 公网部署
WO-16 UI 产品化改版
WO-17 默认规模数据量解释优化
``` ```
原因: 原因:
@@ -1476,18 +1479,25 @@ WO-17 默认规模数据量解释优化
- 500 和导出失效会直接破坏验收,优先级最高。 - 500 和导出失效会直接破坏验收,优先级最高。
- 当前验收中新发现 running 状态和数据库事实不一致,因此 WO-18 / WO-19 应先于继续做公网部署和 UI 大改。 - 当前验收中新发现 running 状态和数据库事实不一致,因此 WO-18 / WO-19 应先于继续做公网部署和 UI 大改。
- 进度透明化解决“黑盒运行”的核心体验问题。 - 进度透明化解决“黑盒运行”的核心体验问题。
- Demo 数据和公网部署强相关,应该在部署前明确 - UI 信息简化适合在主链路稳定后进行,避免把 bug 和展示修改混在一起
- UI 改版适合在主链路稳定后进行,避免把 bug 和视觉修改混在一起 - 公网部署排在最后,避免把本地已知坏链路发布出去
## 15. MVP-2 待用户确认问题 ## 15. MVP-2 待用户确认问题
以下问题需要用户确认后再进入对应工单开发: 以下问题需要用户确认后再进入对应工单开发:
1. 公网部署选择哪种方式:云服务器 Docker Compose、PaaS、还是临时内网穿透演示 1. WO-18:对“长时间无变化”的提示阈值,第一版是否使用 10 分钟
2. 公网访问是否需要密码 / 简单登录 2. WO-18:不存在的任务 ID 页面保留 404,还是跳回首页并显示提示
3. 公网用户是否允许直接消耗真实 TikHub 和 AI Key 3. WO-12:评论为空时,CSV 导出是下载只有表头的文件,还是按钮禁用并提示暂无评论
4. Demo 数据使用真实抓取结果脱敏,还是使用模拟数据 4. WO-13:任务进度是否需要显示预计剩余时间,还是只显示阶段、运行时长和最近更新时间
5. 公网 demo 是否允许展示真实评论文本和作者昵称 5. WO-15:公网部署选择哪种方式:云服务器 Docker Compose、PaaS、还是临时内网穿透演示
6. 评论为空时,CSV 导出是下载只有表头的文件,还是按钮禁用并提示暂无评论 6. WO-15:公网访问是否需要密码 / 简单登录
7. 任务进度是否需要显示预计剩余时间,还是只显示阶段、运行时长和最近更新时间 7. WO-15:公网用户是否允许直接消耗真实 TikHub 和 AI Key
8. UI 风格方向内部数据仪表盘,还是更偏演示型产品页面。 8. WO-16:后续如果做大规模视觉改版,UI 风格方向内部数据仪表盘,还是更偏演示型产品页面。
已确认默认:
- 任务 ID 展示采用顺序号 `#1/#2/#3`,完整 UUID 只保留在详情或排查信息中。
- 本轮问题记录在 `docs/MVP-WorkOrders.md`,不新建 `docs/IssueInbox.md`
- 公网部署排在本地核心功能稳定之后。
- 文档或代码无法确认的问题必须先询问用户,不擅自决定产品行为。