168 lines
7.2 KiB
Markdown
168 lines
7.2 KiB
Markdown
# DreamWeaver 求职版重启：Week 2 执行 Backlog
|
||
|
||
**Version**: 1.0
|
||
**Date**: 2026-04-18
|
||
**Sprint Length**: 5 个工作日
|
||
**Sprint Theme**: 演示闭环、前端状态体验与求职表达打磨
|
||
|
||
---
|
||
|
||
## 1. Sprint Executive Summary
|
||
|
||
Week 1 已经完成产品主线收敛、统一生成入口、Storybook 恢复、资产补全、Provider 分层和本地 Docker 可运行基础。Week 2 不应重新发散到“更多功能”，而应围绕求职演示版完成三件事：
|
||
|
||
1. 把用户端关键体验打磨到能稳定演示。
|
||
2. 把统一生成工作流的代码与说明继续收束。
|
||
3. 把演示脚本、项目讲解和风险预案沉淀成可复用材料。
|
||
|
||
Week 2 的目标不是做“完整商业产品”，而是做出一个面试时能自然讲清楚的 AI 产品案例：用户价值明确、核心链路能跑、失败降级能解释、系统设计有取舍。
|
||
|
||
---
|
||
|
||
## 2. Sprint Goal
|
||
|
||
在 5 个工作日内，将 DreamWeaver 推进到“可连续演示、可复盘讲解、可继续扩展”的求职版 MVP。
|
||
|
||
### Success Definition
|
||
|
||
- 用户端能完成：创建故事/绘本 -> 查看详情/阅读绘本 -> 补全封面/语音 -> 回到故事库。
|
||
- 演示前可以用 smoke 脚本快速确认 Docker 环境可用。
|
||
- 关键页面能表达生成状态、部分完成、失败重试和资产就绪状态。
|
||
- 面试讲解材料能覆盖产品定位、用户价值、生成工作流、Provider 分层和工程取舍。
|
||
- Week 2 结束时，主仓库只保留与演示和短期迭代有关的文档与入口。
|
||
|
||
---
|
||
|
||
## 3. Scope
|
||
|
||
### In Scope
|
||
|
||
- 用户端生成与结果页状态体验
|
||
- 故事库与绘本阅读器的演示稳定性
|
||
- 音频播放和缓存体验验证
|
||
- 演示脚本与 smoke 自动化
|
||
- Provider 分层和 Generation Workflow 的讲解材料
|
||
- 小范围测试补齐与回归验证
|
||
|
||
### Out of Scope
|
||
|
||
- 会员、支付、商业化
|
||
- 多租户 Provider 市场
|
||
- 大规模视觉重做
|
||
- 复杂工作流引擎和生产级任务编排
|
||
- 生产级部署、高可用、监控大盘
|
||
- 新增大量第三方 Provider
|
||
|
||
---
|
||
|
||
## 4. Priorities
|
||
|
||
| Priority | Item | Why It Matters |
|
||
| --- | --- | --- |
|
||
| P0 | 演示链路稳定 | 面试现场不能依赖临场修复 |
|
||
| P0 | 前端状态表达 | AI 产品必须让用户理解等待、失败和恢复 |
|
||
| P0 | 演示脚本与 smoke 检查 | 保证每次展示前可快速复验 |
|
||
| P1 | Generation Workflow 继续收束 | 强化系统设计表达力 |
|
||
| P1 | Provider 分层讲解材料 | 体现 AIPM 对多模型能力的产品化理解 |
|
||
| P1 | 测试覆盖补齐 | 提升项目成熟度信号 |
|
||
| P2 | 局部 UI 视觉优化 | 只做服务演示理解的优化 |
|
||
|
||
---
|
||
|
||
## 5. Week 2 Backlog
|
||
|
||
| ID | Workstream | Task | Output | Priority | Estimate | Status |
|
||
| --- | --- | --- | --- | --- | --- | --- |
|
||
| W2-01 | Demo | 固化本地 Docker smoke 脚本 | `scripts/demo_smoke.sh` | P0 | 0.5d | Done |
|
||
| W2-02 | Demo | 形成求职演示 checklist | `docs/planning/demo-checklist.md` | P0 | 0.5d | Done |
|
||
| W2-03 | Planning | 输出 Week 2 执行 backlog | 当前文档 | P0 | 0.5d | Done |
|
||
| W2-04 | Product | 写 3 分钟项目讲解稿 | 面试口径：产品、工作流、Provider、取舍 | P0 | 0.5d | Done |
|
||
| W2-05 | Frontend | 打磨创建弹窗的状态文案 | 用户知道正在生成故事/绘本/资产 | P0 | 0.5d | Done |
|
||
| W2-06 | Frontend | 强化故事详情页资产状态与重试 CTA | 图片/音频失败时可理解、可操作 | P0 | 1.0d | Done |
|
||
| W2-07 | Frontend | 强化绘本阅读器降级态 | 缺图、失败、加载中不出现空白体验 | P0 | 1.0d | Done |
|
||
| W2-08 | Backend | 梳理旧生成 API 兼容层策略 | 保留/标记 deprecated/迁移计划 | P1 | 0.5d | Done |
|
||
| W2-09 | Backend | 判断 generation job 是否需要落库 | ADR 或技术说明 | P1 | 0.5d | Done |
|
||
| W2-10 | QA | 补前端关键路径构建与 smoke 验证记录 | Docker build + smoke 输出 | P1 | 0.5d | Done |
|
||
| W2-11 | Docs | 输出 Week 1 Sprint Review | `docs/planning/week-1-sprint-review.md` | P1 | 0.5d | Done |
|
||
| W2-12 | Docs | 更新 README 的演示前检查流程 | README 本地演示说明 | P1 | 0.5d | Done |
|
||
| W2-13 | Tech Debt | 清理 Pydantic v2 warning、Dockerfile warning 和旧 TODO | 测试无 warning，Docker build 无 casing warning | P1 | 0.5d | Done |
|
||
| W2-14 | Frontend | 同步管理端生成状态与资产补全体验 | 用户端/管理端状态体验不再分叉 | P1 | 0.5d | Done |
|
||
| W2-15 | Security | 移除管理后台弱默认密码 | 非 debug 管理后台拒绝空/弱密码 | P1 | 0.5d | Done |
|
||
| W2-16 | Workflow | 轻量落库 generation job/event 与 retryable assets | 生成/资产补全过程可追踪，前端按标准字段展示 CTA | P1 | 1.0d | Done |
|
||
| W2-17 | Workflow | 落地 `partial_ready` 与 `text_status` 细粒度状态 | 主内容可读、资产待补全、资产失败三类状态可明确区分 | P1 | 0.5d | Done |
|
||
|
||
---
|
||
|
||
## 6. Suggested Execution Sequence
|
||
|
||
### Day 1: 演示可复验
|
||
|
||
- 完成 smoke 脚本
|
||
- 完成演示 checklist
|
||
- 完成 Week 1 Sprint Review
|
||
- 确认 Docker 环境能一键跑通
|
||
|
||
### Day 2: 用户端状态体验
|
||
|
||
- 优化创建弹窗生成状态
|
||
- 优化故事详情页图片/音频状态与重试
|
||
- 保证失败时用户有明确下一步
|
||
|
||
### Day 3: 绘本阅读体验
|
||
|
||
- 优化绘本阅读器缺图/失败/加载态
|
||
- 验证按 ID 恢复、刷新恢复、故事库进入
|
||
- 补关键前端构建验证
|
||
|
||
### Day 4: 系统设计收尾
|
||
|
||
- 明确旧 API 兼容层策略
|
||
- 决定 generation job 是否落库
|
||
- 整理 Provider 和 Generation Workflow 的讲解图/话术
|
||
|
||
### Day 5: 求职演示彩排
|
||
|
||
- 按 checklist 连续跑 3 次
|
||
- 输出 3 分钟项目讲解稿
|
||
- 记录风险预案和下一阶段计划
|
||
|
||
---
|
||
|
||
## 7. Definition of Done
|
||
|
||
- [x] smoke 脚本能在本地 Docker 栈中完成健康检查、登录、生成、重试和读回验证。
|
||
- [x] 用户端主链路可手动演示，不需要打开数据库或日志解释状态。
|
||
- [x] 故事和绘本的主要失败降级态有清楚展示和重试方式。
|
||
- [x] README、docs index、演示 checklist 与当前代码一致。
|
||
- [x] 面试讲解能在 3 分钟内说明产品价值、技术工作流和取舍。
|
||
- [x] 全量后端测试、ruff、Docker build 在演示前可通过。
|
||
- [x] `partial_ready`、`text_status`、job progress 和 Provider stats 在 API、前端与文档中保持一致。
|
||
|
||
---
|
||
|
||
## 8. Risks
|
||
|
||
| Risk | Likelihood | Impact | Mitigation |
|
||
| --- | --- | --- | --- |
|
||
| 前端状态优化变成视觉重做 | Medium | High | 只改状态、文案、CTA，不做大规模改版 |
|
||
| 继续深挖后端抽象导致演示延期 | Medium | High | generation job 先做决策，不急着落库 |
|
||
| TTS provider 网络不稳定 | Medium | Medium | smoke 脚本支持跳过音频，演示前优先用缓存 |
|
||
| Demo 数据不足 | Medium | Medium | smoke 脚本自动生成故事与绘本样本 |
|
||
| 面试讲解过技术化 | Medium | High | 讲解顺序固定为用户问题 -> 产品方案 -> 系统取舍 |
|
||
|
||
---
|
||
|
||
## 9. Week 2 Output Package
|
||
|
||
Week 2 结束时，应能交付：
|
||
|
||
- 本地 Docker demo
|
||
- smoke 脚本
|
||
- 演示 checklist
|
||
- 3 分钟项目讲解稿
|
||
- Week 1 Sprint Review
|
||
- Week 2 完成记录
|
||
- 核心链路测试结果
|
||
|
||
这套材料的目标是让项目从“我做过很多功能”变成“我能用产品经理方式定义问题、收敛范围、推动工程实现并验证结果”。
|