feat: polish generation demo workflow

docs/planning/demo-validation-log.md

@@ -0,0 +1,54 @@
+# Demo 验证记录
+
+这份记录用于演示前快速说明“当前本地 Docker 环境已经验证到什么程度”。新的验证记录按时间倒序追加。
+
+## 2026-04-18
+
+验证范围：
+
+- 用户前端 Docker 生产构建
+- 管理前端 Docker 生产构建
+- 后端 Docker 镜像构建与服务重启
+- 后端 lint 与测试
+- 后端统一生成接口
+- 故事封面资产补全
+- 故事音频资产补全
+- 绘本文字生成
+- 绘本封面和分页插图补全
+- 故事列表读取
+- Provider capability policy
+
+执行命令：
+
+```bash
+docker compose build frontend
+docker compose build frontend frontend-admin
+docker compose build backend backend-admin worker celery-beat
+docker compose up -d backend backend-admin worker celery-beat frontend frontend-admin
+cd backend && .venv/bin/python -m ruff check app tests
+cd backend && .venv/bin/python -m pytest -q
+SMOKE_AUDIO=1 ./scripts/demo_smoke.sh
+```
+
+结果：
+
+- `vue-tsc` 通过。
+- 用户端与管理端 `vite build` 通过。
+- Docker 前端镜像 `dreamweaver-frontend:dev` 构建通过。
+- Docker 管理前端镜像 `dreamweaver-admin-frontend:dev` 构建通过。
+- Docker 后端镜像 `dreamweaver-backend:dev` 构建通过。
+- `ruff check app tests` 通过。
+- `pytest -q` 通过，71 个测试通过。
+- `SMOKE_AUDIO=1 ./scripts/demo_smoke.sh` 通过。
+- 本地用户端可通过 `http://localhost:52080` 访问。
+
+已确认的演示能力：
+
+- 普通故事可以先生成可读正文。
+- 封面和音频可以作为资产单独重试。
+- 绘本可以生成 6 页文本并补全全部插图。
+- 故事列表能看到最新生成结果。
+
+限制：
+
+- 本机浏览器自动化脚本默认寻找标准版 Chrome；当前电脑安装的是 Google Chrome Beta，所以本轮没有生成 CDP 截图。