tonytech/kindergarten_java
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
1a79fef30f
kindergarten_java/docs/test-logs/admin/2026-03-16-course-package-test-plan.md
En 938503f2b8 chore: 更新启动脚本使用 Java (Spring Boot) 后端 
- 修改后端目录从 reading-platform-backend 改为 reading-platform-java
- 修改后端端口从 3000 改为 8080
- 修改启动命令从 npm run start:dev 改为 mvn spring-boot:run
- 添加 JAVA_HOME 自动检测和设置（默认使用 /f/Java/jdk-17）
- 修改日志文件从 reading-platform-backend.log 改为 reading-platform-java.log
- 修改健康检查接口为 /actuator/health
- 增加启动等待超时时间到 60 秒（Java 启动较慢）

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-16 10:35:30 +08:00

5.7 KiB
Raw Blame History

课程包创建流程全面测试计划

测试概述

本次测试针对课程包创建流程进行全面 E2E 测试，确保从登录到课程包创建成功的整个流程正常工作。

测试文件

  • tests/e2e/admin/course-package-comprehensive.spec.ts - 综合测试用例

测试场景

1. 完整流程测试

  • 测试文件: 完整流程：填写所有 7 个步骤创建课程包
  • 测试内容:
    • 步骤 1: 基本信息（课程名称、主题、年级、核心内容、绘本名称、领域标签）
    • 步骤 2: 课程介绍（课程简介、课程亮点、课程目标）
    • 步骤 3: 排课参考（总课时、课时时长、排课建议）
    • 步骤 4: 导入课（跳过）
    • 步骤 5: 集体课（创建并填写完整信息）
    • 步骤 6: 领域课（跳过）
    • 步骤 7: 环创建设（填写环境创设内容）
  • 预期结果: 课程包创建成功，列表中显示新课程包

2. 最小化测试

  • 测试文件: 最小化流程：只填写必填项创建课程包
  • 测试内容:
    • 步骤 1: 只填写 4 个必填项（课程名称、主题、年级、核心内容）
    • 步骤 2-7: 全部跳过
  • 预期结果: 课程包创建成功，验证必填项逻辑正确

3. 验证逻辑测试

  • 测试文件 1: 必填项验证：未填必填项时无法进入下一步

    • 不填写任何内容，直接点击下一步
    • 验证仍停留在步骤 1

  • 测试文件 2: 部分填写验证：只填部分必填项时无法进入下一步

    • 只填写课程名称，不填写主题和年级
    • 验证无法进入下一步

4. 数据持久化测试

  • 测试文件: 数据验证：创建后查看详情数据完整
  • 测试内容:
    • 创建课程包
    • 进入课程包详情页
    • 验证保存的数据完整
  • 预期结果: 详情页显示的数据与填写的一致

测试数据

完整流程测试数据

{
  name: '完整测试课程包-{timestamp}',
  theme: '社会认知',
  grades: ['小班'],
  bookName: '折耳兔奇奇',
  coreContent: '通过折耳兔奇奇的故事，帮助孩子理解友谊和分享的重要性，培养社交能力。',
  domainTags: ['倾听与表达'],
  introSummary: '这是一门专为小班幼儿设计的课程...',
  introHighlights: '1. 故事情节生动有趣...',
  introGoals: '1. 理解故事内容...',
  totalHours: '8',
  hourDuration: '30',
  scheduleAdvice: '建议每周 1-2 课时...',
  collectiveName: '集体课——折耳兔奇奇绘本阅读',
  collectiveDuration: 25,
  collectiveObjectives: '1. 认知：完整观看绘本动画...',
  collectivePreparation: '1. 绘本 PPT\n2. 相关图片...',
  environmentConstruction: '1. 夸夸卡展示区...',
}

最小化测试数据

{
  name: '最小化测试课程包-{timestamp}',
  theme: '社会认知',
  grades: ['中班'],
  coreContent: '最小化测试课程，仅包含必填项。',
  domainTags: ['人际交往'],
}

运行测试

前提条件

  1. 后端服务运行在 http://localhost:8080
  2. 前端服务运行在 http://localhost:5173
  3. 数据库包含测试主题数据
  4. 超管账号可用 (admin/123456)

启动服务

# 启动所有服务
./start-all.sh

# 或分别启动
# 后端
cd reading-platform-java
mvn spring-boot:run

# 前端（新终端）
cd reading-platform-frontend
npm run dev

运行测试

cd reading-platform-frontend

# 无头模式（快速执行，不显示浏览器）
npm run test:e2e -- --project=chromium course-package-comprehensive.spec.ts

# 有头模式（显示浏览器操作过程）
npm run test:e2e:headed -- --project=chromium course-package-comprehensive.spec.ts

# UI 调试模式（可视化管理测试用例）
npm run test:e2e:ui

运行单个测试

# 运行完整流程测试
npm run test:e2e -- --grep "完整流程"

# 运行最小化测试
npm run test:e2e -- --grep "最小化"

# 运行验证逻辑测试
npm run test:e2e -- --grep "必填项验证"

# 运行数据持久化测试
npm run test:e2e -- --grep "数据验证"

测试通过标准

  1. ✅ 超管登录成功
  2. ✅ 能进入课程管理页面
  3. ✅ 能进入课程创建页面
  4. ✅ 7 个步骤能正常切换
  5. ✅ 必填项验证生效
  6. ✅ 提交后显示成功提示
  7. ✅ 跳转到课程列表页
  8. ✅ 新课程包在列表中可见
  9. ✅ 查看课程包详情，数据完整

测试检查清单

测试前检查

  • 后端服务已启动
  • 前端服务已启动
  • 数据库连接正常
  • 测试主题数据存在
  • 超管账号可用

测试后清理

  • 停止前后端服务
  • 清理测试数据（可选）
  • 查看测试报告
  • 记录测试结果

测试报告

测试完成后，查看 HTML 报告：

# 生成测试报告
npx playwright show-report

# 或打开报告文件
# reading-platform-frontend/playwright-report/index.html

故障排查

常见问题

  1. 登录失败

    • 检查超管账号密码是否正确
    • 检查后端服务是否运行
    • 检查数据库用户表是否有 admin 用户

  2. 页面加载超时

    • 检查前端服务是否运行
    • 检查端口 5173 是否被占用
    • 增加超时时间 test.setTimeout()

  3. 元素找不到

    • 检查页面结构是否变化
    • 检查选择器是否正确
    • 使用 page.waitForTimeout() 增加等待时间

  4. 创建失败

    • 检查后端日志
    • 检查请求参数格式
    • 检查数据库表结构

测试日志

测试执行过程中的关键日志会输出到控制台，包括：

  • ✅ 每个步骤完成情况
  • 🎉 测试通过确认
  • ❌ 错误信息（如有）

更新记录

日期 更新内容
2026-03-16 创建测试计划和测试用例