docs: add week 2 plan and demo smoke checklist

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

@@ -0,0 +1,96 @@
+# 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 本地演示可验证。