docs: sync workflow progress and weekend handoff

docs/planning/weekend-handoff-2026-04-17.md

@@ -0,0 +1,125 @@
+# DreamWeaver Weekend Handoff - 2026-04-17
+
+## Purpose
+
+这份文档用于周末在另一台电脑上继续推进 DreamWeaver 时快速接手，不需要先重新阅读大量聊天记录或从工作区猜测上下文。
+
+---
+
+## What Is Already On Remote
+
+当前远端已经包含一个阶段性 checkpoint：
+
+- Commit: `a97a2fe`
+- Message: `feat: persist story generation states and cache audio`
+
+这个 checkpoint 覆盖的主线如下：
+
+- 新增并落地统一生成状态字段：
+  - `generation_status`
+  - `image_status`
+  - `audio_status`
+  - `last_error`
+- Storybook 阅读页支持按 ID 恢复
+- 故事列表页、故事详情页、绘本阅读页接入统一状态展示
+- 音频首次生成后缓存落盘并可复用
+- 统一状态语义中 `degraded_completed` 已和错误展示保持一致
+
+---
+
+## What Is Not Yet On Remote
+
+当前这台机器的工作区里仍存在大量未提交改动，它们 **不属于上面的 checkpoint**，也不会自动出现在另一台电脑上。
+
+因此，周末接手时应该默认：
+
+- 远端 `main` 只包含“统一状态模型 + Storybook 恢复 + 音频缓存”这一条主线
+- 其他本机未提交内容需要后续再整理，不应假设它们已经同步
+
+---
+
+## Recommended Reading Order
+
+周末继续前，建议先阅读：
+
+1. `docs/product/job-search-relaunch-prd.md`
+2. `docs/product/unified-generation-workflow-prd.md`
+3. `docs/planning/week-1-execution-backlog.md`
+4. `docs/planning/document-status-inventory.md`
+
+---
+
+## Environment Setup On The Next Machine
+
+建议接手后先完成以下动作：
+
+1. `git pull`
+2. `cd backend && alembic upgrade head`
+3. `cd backend && ./.venv/Scripts/python.exe -m pytest -q`
+4. `cd frontend && npm install`
+5. `cd frontend && ./node_modules/.bin/vue-tsc --noEmit`
+
+如果主前端完整构建失败，优先检查 Rollup 可选原生包是否正常安装，而不是先怀疑本轮代码逻辑。
+
+---
+
+## Current Product / Engineering Position
+
+当前阶段不是“继续加功能”，而是把 DreamWeaver 收敛成可讲述、可演示、可恢复的求职版产品。
+
+已经完成的关键支点：
+
+- 状态模型已落地，不再只是文档概念
+- Storybook 恢复能力已补上
+- 音频体验开始形成闭环
+
+还没完成的关键工作：
+
+- 普通故事、完整生成、绘本生成仍是多条 service 路径
+- 缺少统一资产重试入口
+- 缺少更清晰的统一 workflow 编排边界
+- admin-frontend 范围和 Provider 边界仍未收束
+
+---
+
+## Best Next Step
+
+周末最值得继续做的第一优先级：
+
+### P0: 统一资产补全过程
+
+目标：
+
+- 抽出封面生成和音频生成的共同步骤
+- 让图片 / 音频共享一套资产状态回写逻辑
+- 为后续“统一重试入口”打基础
+
+为什么先做：
+
+- 它直接承接已经落地的状态模型
+- 它比继续加页面更能体现系统设计能力
+- 它能把当前三条生成路径往统一 workflow 再推近一步
+
+### P1: 统一重试入口
+
+目标：
+
+- 至少设计出一个清晰的 retry API 方向
+- 即使不一次性重命名为 `/api/generations/...`，也先做到内部统一
+
+### P1: 收敛 service workflow
+
+目标：
+
+- 梳理普通故事 / 完整生成 / 绘本生成的共同步骤
+- 把“验证上下文 -> 生成主内容 -> 保存主记录 -> 补全资产 -> 状态回写”整理成更明确的共享流程
+
+---
+
+## Important Reminder
+
+如果周末是在另一台电脑上继续，不要默认“今天下午所有本地修改”都已经上远端。当前最可靠的 source of truth 是：
+
+- 远端代码：以 commit `a97a2fe` 为准
+- 产品目标：以 `docs/product/job-search-relaunch-prd.md` 为准
+- 当前执行主线：以 `docs/product/unified-generation-workflow-prd.md` 与 `docs/planning/week-1-execution-backlog.md` 为准