diff --git a/docs/MVP-WorkOrders.md b/docs/MVP-WorkOrders.md index c63d764..d992856 100644 --- a/docs/MVP-WorkOrders.md +++ b/docs/MVP-WorkOrders.md @@ -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`。 +- 公网部署排在本地核心功能稳定之后。 +- 文档或代码无法确认的问题必须先询问用户,不擅自决定产品行为。