Demo 验证记录

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

2026-04-18

补充验证：

新增跨故事 Provider analytics 后，backend/.venv/bin/python -m pytest backend/tests -q 通过，83 个测试通过。
用户端与管理端 npm run build 均通过；生成轨迹组件已支持未终止任务自动轮询。
docker compose up -d --build 已再次用当前代码重建本地演示栈。
./scripts/demo_smoke.sh 再次通过，并新增断言 GET /api/generations/provider-analytics 可以返回跨故事总调用、成功率、任务数、故事数和 Provider 明细。
后端新增 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 截图。

4.1 KiB Raw Blame History Unescape Escape

Demo 验证记录

2026-04-18

4.1 KiB

Raw Blame History