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

97 lines
3.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 本地演示可验证。