dreamweaver/docs/planning/week-1-sprint-review.md

DreamWeaver 求职版重启：Week 1 Sprint Review

Date: 2026-04-18 Theme: 产品聚焦与核心生成链路收敛

---

1. Sprint Summary

Week 1 将 DreamWeaver 从“功能很多但主线分散”的项目，推进为“围绕个性化 AI 绘本与陪伴式讲述”的求职版 MVP 基础。核心变化不是增加更多功能，而是收敛产品叙事、统一生成入口、补齐可恢复能力、梳理 Provider 分层，并让本地 Docker 演示具备可重复验证的基础。

---

2. Completed Outcomes

Product

• 明确产品定位：面向 3-8 岁亲子场景的个性化 AI 绘本与陪伴式讲述产品。
• 明确三条核心价值：
  • 个性化连续性
  • 陪伴式体验
  • 生成稳定性
• 明确求职版不追求“功能最多”，而追求“价值闭环清楚、系统设计可解释、演示链路稳定”。

Generation Workflow

• 新增统一生成入口：
  • POST /api/generations
  • GET /api/generations/{id}
  • POST /api/generations/{id}/retry-assets
• 普通故事和绘本创建入口已切到统一 API。
• Storybook 阅读器支持按 ID 恢复。
• 故事与绘本详情支持统一状态字段：
  • generation_status
  • image_status
  • audio_status
  • last_error
• 服务层抽出公共步骤：
  • 上下文准备
  • 主记录保存
  • 封面补全
  • 绘本插图补全
  • 音频缓存与生成
• 引入 AssetCompletionResult 表达资产补全结果。

Provider

• 新增 provider_policy.py，将 Capability / 默认 Provider / Routing Strategy / API key ref 映射从 runtime router 中拆出。
• Provider Router 继续负责 failover、熔断、成本、指标和 adapter 执行。
• 新增 /admin/providers/capabilities，用于展示能力分层。
• 新增 docs/technical/provider-routing.md，沉淀术语表和面试表达口径。

Engineering

• 本地 Docker Compose 入口已收敛为一个。
• 后端全量 ruff 通过。
• 后端测试从 53 个增长到 71 个并通过。
• 用户端和 admin 前端均可 Docker 构建。
• 已新增演示 smoke 脚本和演示 checklist。

---

3. What Changed In The Product Story

之前的 DreamWeaver 容易被理解成“会调很多模型的儿童故事工具”。Week 1 之后，项目故事可以变成：

DreamWeaver 把 AI 文本、绘本、图片和语音能力收敛成一条亲子阅读工作流。主内容优先可读，封面、插图和语音作为可恢复资产补全；Provider 体系隐藏在产品能力背后，通过 Capability 和 Routing Policy 保证生成稳定性。

这个表达更接近 AI 产品经理需要讲清楚的内容：用户问题、产品闭环、系统边界、失败恢复和取舍。

---

4. Remaining Gaps

• 前端状态体验仍可继续强化，尤其是生成中、部分完成、失败重试的文案和 CTA。
• 旧生成 API 仍作为兼容层保留，需要 Week 2 明确 deprecation 策略。
• AssetCompletionResult 目前是服务层对象，是否落库成 generation job 需要继续评估。
• 记忆系统和成长时间线仍是后续增强点，不应抢占演示闭环优先级。

---

5. Week 2 Recommendation

Week 2 应优先做“演示稳定 + 前端状态体验 + 面试材料”，而不是继续深挖底层架构。建议顺序：

1. 固化 smoke 脚本和演示 checklist。
2. 打磨故事详情和绘本阅读器状态体验。
3. 明确旧 API 兼容层策略。
4. 输出 3 分钟项目讲解稿。
5. 连续跑 3 次本地演示回归。

---

6. Sprint Verdict

Week 1 达成目标。项目已经具备求职版 MVP 的基础形态：产品定位清楚、核心生成链路可跑、状态模型可解释、Provider 分层可讲、Docker 本地演示可验证。