docs: package week 4 demo and architecture

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

@@ -0,0 +1,69 @@
+# DreamWeaver Week 4 Sprint Review
+
+**Date**: 2026-04-18
+**Theme**: 求职版 Demo 包装、结果体验收尾与生产化路线
+
+---
+
+## 1. 本阶段完成
+
+- Week 2-4 总 backlog 已固化，Week 2 全部完成。
+- Week 3 已补齐音频缓存治理首版：
+  - 音频缓存状态查询
+  - 音频缓存清理
+  - 故事详情页展示缓存大小和更新时间
+- Week 3 已补齐时间线与记忆联动：
+  - 阅读事件进入孩子成长时间线
+  - 阅读事件生成的 `recent_story` 记忆带上故事模式、封面、阅读时长和来源
+  - 时间线能展示阅读记录与记忆沉淀
+- Week 4 已补齐绘本阅读位置恢复。
+- Week 4 已输出架构说明和 Demo 包装文档。
+
+---
+
+## 2. 当前项目状态
+
+DreamWeaver 已经具备求职演示所需的完整闭环：
+
+`孩子档案 -> 输入主题 -> 生成故事/绘本 -> 资产补全 -> 语音缓存 -> 阅读记录 -> 记忆沉淀 -> 成长时间线 -> 复用上下文生成新故事`
+
+同时具备可解释的系统设计：
+
+- 统一生成入口
+- 统一状态模型
+- generation job/event
+- Provider failover 和聚合指标
+- 跨故事 Provider analytics
+- 前端生成轨迹和自动轮询形态
+
+---
+
+## 3. 验证状态
+
+最近一轮验证包括：
+
+- 后端全量测试：85 passed
+- 后端 ruff：通过
+- 用户端生产构建：通过
+- 管理端生产构建：通过
+- Docker 全栈重建：通过
+- demo smoke：通过
+
+---
+
+## 4. 生产化 Backlog
+
+| Priority | Task | Why |
+| --- | --- | --- |
+| P0 | 将同步生成迁移到 Celery worker | 支持真实长任务、断点恢复和后台进度 |
+| P0 | Provider analytics 加入时间窗口和失败原因 | 让运营分析可用于成本与稳定性决策 |
+| P1 | 音频缓存过期策略与后台清理 | 控制磁盘占用和缓存生命周期 |
+| P1 | 生成任务取消与重试队列 | 防止重复任务和用户误触造成浪费 |
+| P1 | 监控告警与结构化 dashboard | 上线前需要可观测性闭环 |
+| P2 | 更细粒度叙事风格与音色策略 | 扩展体验，但不影响当前求职版主线 |
+
+---
+
+## 5. 面试表达
+
+这个项目最重要的不是“接了几个 AI API”，而是把模型的不确定性变成了可恢复、可解释、可追踪的产品体验。主内容优先保存，资产独立补全，状态明确可读，Provider 调用可观测，阅读行为还能反哺记忆和下一次生成。