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