feat: add week 3 audio and timeline enhancements

docs/planning/week-2-to-4-execution-backlog.md

@@ -0,0 +1,77 @@
+# DreamWeaver 求职版重启：Week 2-4 执行 Backlog
+
+**Version**: 1.0
+**Date**: 2026-04-18
+**Scope**: 从可演示 MVP 推进到可讲清楚、可复验、可继续生产化的项目包
+
+---
+
+## 1. 总体目标
+
+Week 2 已完成演示闭环、统一生成工作流、generation job/event、状态模型、Provider 轨迹和 smoke 验证。Week 3-4 不继续堆大功能，而是围绕 PRD Phase 2 做增强：
+
+1. 让音频缓存从“可用”变成“可治理、可解释”。
+2. 让孩子档案、故事、阅读事件、记忆和时间线之间形成更清楚的产品闭环。
+3. 让 Provider 运营视角从单故事扩展到跨故事摘要。
+4. 把结果页、语音体验、测试、架构图和演示材料收成求职版项目包。
+
+---
+
+## 2. Week 2 完成状态
+
+| ID | Workstream | Task | Output | Priority | Status |
+| --- | --- | --- | --- | --- | --- |
+| W2-01 | Demo | 固化本地 Docker smoke 脚本 | `scripts/demo_smoke.sh` | P0 | Done |
+| W2-02 | Demo | 形成求职演示 checklist | `docs/planning/demo-checklist.md` | P0 | Done |
+| W2-03 | Planning | 输出 Week 2 执行 backlog | `docs/planning/week-2-execution-backlog.md` | P0 | Done |
+| W2-04 | Product | 写 3 分钟项目讲解稿 | `docs/planning/interview-pitch.md` | P0 | Done |
+| W2-05 | Frontend | 打磨创建弹窗状态文案 | 用户知道故事/绘本/资产正在生成 | P0 | Done |
+| W2-06 | Frontend | 强化故事详情页资产状态与重试 CTA | 图片/音频失败时可理解、可操作 | P0 | Done |
+| W2-07 | Frontend | 强化绘本阅读器降级态 | 缺图、失败、加载中不出现空白体验 | P0 | Done |
+| W2-08 | Backend | 梳理旧生成 API 兼容层策略 | `docs/technical/api-compatibility.md` | P1 | Done |
+| W2-09 | Backend | 判断 generation job 是否需要落库 | `docs/technical/generation-job-state.md` | P1 | Done |
+| W2-10 | QA | 补前端关键路径构建与 smoke 验证记录 | `docs/planning/demo-validation-log.md` | P1 | Done |
+| W2-11 | Docs | 输出 Week 1 Sprint Review | `docs/planning/week-1-sprint-review.md` | P1 | Done |
+| W2-12 | Docs | 更新 README 演示前检查流程 | README 本地演示说明 | P1 | Done |
+| W2-13 | Tech Debt | 清理 Pydantic v2 warning、Dockerfile warning 和旧 TODO | 测试与构建无关键 warning | P1 | Done |
+| W2-14 | Frontend | 同步管理端生成状态与资产补全体验 | 用户端/管理端状态体验不分叉 | P1 | Done |
+| W2-15 | Security | 移除管理后台弱默认密码 | 非 debug 管理后台拒绝空/弱密码 | P1 | Done |
+| W2-16 | Workflow | 轻量落库 generation job/event 与 retryable assets | 生成/资产补全过程可追踪 | P1 | Done |
+| W2-17 | Workflow | 落地 `partial_ready` 与 `text_status` | 主内容可读、资产待补全、资产失败可区分 | P1 | Done |
+| W2-18 | Ops | 跨故事 Provider 运营摘要 | `GET /api/generations/provider-analytics` | P1 | Done |
+| W2-19 | Frontend | 生成轨迹未终止任务自动轮询 | 前端为后台 worker 进度流预留体验 | P1 | Done |
+
+---
+
+## 3. Week 3 计划
+
+| ID | Workstream | Task | Output | Priority | Status |
+| --- | --- | --- | --- | --- | --- |
+| W3-01 | Planning | 固化 Week 2-4 总 backlog | 当前文档 | P0 | Done |
+| W3-02 | Backend | 音频缓存治理首版 | 音频缓存元信息、stale repair、删除缓存接口 | P0 | Done |
+| W3-03 | Frontend | 语音体验补充缓存状态 | 故事详情页展示缓存命中/文件大小/更新时间 | P1 | Done |
+| W3-04 | Product Loop | 时间线增强阅读事件和记忆上下文 | 时间线展示已读、重听、近期记忆来源 | P0 | Done |
+| W3-05 | Memory | 阅读事件写入更可解释的 memory value | recent_story 包含阅读时长、mode、封面、事件来源 | P1 | Done |
+| W3-06 | QA | 为 W3-02/W3-04 补测试和 smoke 断言 | 后端测试 + smoke 覆盖新增接口 | P0 | Done |
+| W3-07 | Docs | 更新 PRD、README、验证日志 | 文档与实现一致 | P1 | Done |
+
+---
+
+## 4. Week 4 计划
+
+| ID | Workstream | Task | Output | Priority | Status |
+| --- | --- | --- | --- | --- | --- |
+| W4-01 | Frontend | 结果页与阅读页体验收尾 | 故事详情、绘本阅读、故事库状态一致 | P0 | Pending |
+| W4-02 | Docs | 架构图与系统说明 | `docs/technical/architecture.md` 或 Mermaid 图 | P0 | Pending |
+| W4-03 | Demo | 求职版 Demo 包装 | 演示路径、风险预案、检查命令一页化 | P0 | Pending |
+| W4-04 | QA | 全量回归与验证记录 | pytest、ruff、前端 build、Docker smoke | P0 | Pending |
+| W4-05 | Product | 项目复盘与下一阶段路线 | Week 4 review + production backlog | P1 | Pending |
+
+---
+
+## 5. 执行原则
+
+- 每次推进 3-5 个能一起验证的任务，不做只改一行的小碎片。
+- 每批任务必须有明确验证：测试、构建、smoke 或文档验收。
+- 不扩大到支付、多租户、复杂监控或大规模视觉重做。
+- 优先保留求职表达价值：能解释用户价值、AI 不确定性、Provider 分层和工程取舍。