dreamweaver/docs/planning/demo-validation-log.md

Demo 验证记录

这份记录用于演示前快速说明“当前本地 Docker 环境已经验证到什么程度”。新的验证记录按时间倒序追加。

2026-04-18

补充验证：

• 后端新增 partial_ready、text_status 与迁移 0012_story_text_status 后，backend/.venv/bin/python -m pytest backend/tests -q 通过，82 个测试通过。
• backend/.venv/bin/python -m ruff check backend/app backend/tests backend/alembic/versions/0012_add_story_text_status_and_partial_ready.py 通过。
• 用户端与管理端 npm run build 均通过。
• docker compose up -d --build 已用当前代码重建本地演示栈。
• 当前本地 Docker 数据卷来自早期 create_all，缺少 alembic_version 且旧 stories 表没有 text_status；本轮已为演示库补齐 text_status、回填状态，并 alembic stamp head 到 0012_story_text_status。
• ./scripts/demo_smoke.sh 通过：普通故事以 partial_ready 可读返回，封面补全后仍可读且音频待补；绘本无图时 partial_ready，插图补全后 completed；generation job、story job history 和 provider stats 均可查询。

验证范围：

• 用户前端 Docker 生产构建
• 管理前端 Docker 生产构建
• 用户端与管理端生成/资产状态体验一致性
• 后端 Docker 镜像构建与服务重启
• 后端 lint 与测试
• Pydantic v2 兼容性 warning 清理
• Dockerfile build warning 清理
• 管理后台弱默认密码防护
• Generation job/event 轻量落库
• retryable_assets 标准响应字段
• 后端统一生成接口
• 故事封面资产补全
• 故事音频资产补全
• 绘本文字生成
• 绘本封面和分页插图补全
• 故事列表读取
• Provider capability policy

执行命令：

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 通过，73 个测试通过，Pydantic v2 deprecation warning 已清零。
• SMOKE_AUDIO=1 ./scripts/demo_smoke.sh 通过。
• smoke 会断言 retryable_assets 在故事、音频、绘本补全前后按预期变化。
• 本地用户端可通过 http://localhost:52080 访问。
• 本地管理端可通过 http://localhost:52888 访问。
• 技术债扫描未发现 class Config、TODO、FIXME、旧 Issue 注释或 Dockerfile FROM ... as。
• 后端不再内置 admin123 管理密码；非 debug 环境开启管理后台时会拒绝空/弱密码。
• 统一生成和资产重试会写入 generation_jobs 与 generation_job_events。
• API 响应返回 retryable_assets，前端按标准字段展示补全/重试入口。

已确认的演示能力：

• 普通故事可以先生成可读正文。
• 封面和音频可以作为资产单独重试。
• 绘本可以生成 6 页文本并补全全部插图。
• 故事列表能看到最新生成结果。
• 时间线中的绘本事件可以直接进入按 ID 恢复的绘本阅读器。

限制：

• 本机浏览器自动化脚本默认寻找标准版 Chrome；当前电脑安装的是 Google Chrome Beta，所以本轮没有生成 CDP 截图。