# 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 完成记录
- 核心链路测试结果

这套材料的目标是让项目从“我做过很多功能”变成“我能用产品经理方式定义问题、收敛范围、推动工程实现并验证结果”。