audio_codebuddy/tests/e2e/core-business

核心业务测试：书籍生成完整链路

适用于每次修改核心业务代码后、每次发布上线前的回归校验。 测试目标：保证「大纲 → 内容 → 音频」这条核心业务链路从前端页面到后端 API 都可工作。

测试范围

CORE-1  预估字数与时长                          (GET  /api/book-generator/langgraph/estimate)
CORE-2  创建书籍（停在 draft，不自动生成）       (POST /api/book-generator/langgraph/books)
CORE-3  生成大纲，等待 outline_completed        (POST .../outline + 轮询 /progress)
CORE-4  生成全部章节内容，等待 content_completed (POST .../chapters + 轮询 /progress)
CORE-5  生成全部章节音频，等待 allCompleted      (POST .../audio + 轮询 /audio-status)
CORE-6  书籍最终态为 audio_completed / video_completed
CORE-7  书籍列表页可访问，能看到刚生成的书       (UI: /#/pages/book-generator/index)
CORE-8  创建页可访问、表单可填写                 (UI: /#/pages/book-generator/create)
CORE-9  详情页正确显示状态                       (UI: /#/pages/book-generator/detail)
CORE-10 章节详情页可访问                         (UI: /#/pages/book-generator/chapter-detail)

设计原则

1. 状态变更走 API — 避开 uni.showModal 等 uni-app H5 模态框，测试稳定可重跑。
2. 可见性校验走 UI — 任何前端展示层（列表 / 详情 / 状态文本）改动能被立即发现。
3. 失败立即抛错 — 不静默跳过，任一阶段失败 = 整个 describe 标红。

运行环境

组件	地址	必须先启动
后端	http://127.0.0.1:3000	✅
前端 H5	http://127.0.0.1:5173	✅
数据库	MySQL（Prisma）	✅
LLM 服务	后端 .env 中配置	✅
TTS 服务	后端 .env 中配置	✅

运行方式

# 方式一：通过根目录脚本（推荐）
./scripts/run-core-business-test.sh

# 方式二：直接调 playwright
npx playwright test \
  --project=core-business \
  --config=tests/playwright.config.ts

# 方式三：只跑核心业务用例
cd tests/e2e/core-business && \
  npx playwright test book-core-flow.spec.ts \
    --config=../../playwright.config.ts

时长参考

阶段	参考时长
CORE-1~2	< 5s
CORE-3 大纲	30 ~ 60s
CORE-4 内容	60 ~ 180s
CORE-5 音频	60 ~ 240s
CORE-6~10 UI	< 30s
合计	3 ~ 8 分钟

单测超时设 10 分钟，避免环境抖动。LLM / TTS 真实调用，时长不可压缩。

失败处理

• 看 tests/test-results/report HTML 报告
• 看 tests/test-results/results.json 结构化结果
• 看后端日志（特别是 prisma / langgraph / TTS provider 报错）

修改触发矩阵

改动文件	必须跑？
server/src/modules/book-generator/**	✅
my-uniapp-vue3/src/pages/book-generator/**	✅
my-uniapp-vue3/src/utils/book-generator-api.ts	✅
server/prisma/schema.prisma（Book / Chapter 表）	✅
部署 / 发布脚本	✅
其他无关文件	可选