W1-W3: 基线修复与测试基础设施搭建 - 修复 Jenkins JDK 21 兼容性,统一 E2E 目录,修复 storageState 冲突 - 搭建后端测试基类 BaseContractTest + Testcontainers PostgreSQL - 创建 TestDataFactory 链式构造,完善 Vitest 基座与 Playwright fixtures - 建立 docker-compose.test.yml 与测试数据隔离方案 W4-W5: 单元测试补齐(阶段 2) - 补齐 gym-member/gym-groupCourse/gym-checkIn/gym-payment 核心模块单元测试 - 补齐 gym-coach/manage-sys 模块单元测试 - 前端 utils/composables/stores 单元测试,37 文件 502 项测试 - JaCoCo 覆盖率门禁从 30% 调整至 55%,21 模块全部通过 W6-W7: 集成与契约测试(阶段 3) - Repository 集成测试:会员/团课/签到/支付关键表,Testcontainers 100% 通过 - Handler 集成测试:WebTestClient 覆盖正向/异常/权限路径 - 网关集成测试:JWT/RBAC/签名/限流/重试 - Flyway 迁移测试:验证迁移脚本可重复执行 - OpenAPI 契约测试:覆盖 ≥80% P0 接口,202 项契约测试 0 失败 - 跨模块契约测试:会员-支付-团课数据一致性 W8-W9: E2E 与用户旅程测试(阶段 4) - 管理员 Web 核心流程 E2E:用户/角色/菜单/字典/配置 - 小程序会员端核心页面 E2E:购卡/预约/签到 - 5 条 P0 用户旅程全链路自动化,60 条 journey 测试 0 失败 W10: 变异测试与质量门禁(阶段 5) - 后端 PIT 配置:pitest-maven 1.19.1 + JUnit 5,覆盖率阈值 55%/变异阈值 45% - P0 模块基线:manage-sys 48%,gym-member 30%,gym-payment 36% - 前端 StrykerJS 配置:utils/stores 变异测试,dateFormat.ts 70.83% - Jenkins 质量门禁:JaCoCo/PIT/E2E 统一检查,不达标阻断构建 W11: 持续运行与改进(阶段 6) - 测试指标收集脚本 scripts/collect-test-metrics.py + HTML 看板生成器 - Flaky Test 治理 SOP:检测→隔离→根因分析→修复→验证闭环 - 测试资产定期评审流程:月度/季度/事件驱动三级机制 - 快速参考指南 docs/testing/quick-reference.md - 累计 10 份测试文档,7 个里程碑全部达成
E2E测试说明
测试结构
本项目的E2E测试采用分层测试策略:
冒烟测试(smoke/)
快速验证基础功能是否正常工作。
login-logout.spec.ts- 登录登出基础流程
核心旅程测试(journeys/)
验证关键业务端到端流程。
admin-complete-workflow.spec.ts- 管理员完整工作流user-permission-boundary.spec.ts- 用户权限边界验证file-management-workflow.spec.ts- 文件上传下载流程audit-workflow.spec.ts- 审计日志查看流程
运行测试
运行冒烟测试
npm run test:e2e:smoke
运行核心旅程测试
npm run test:e2e:journeys
运行所有测试
npm run test:e2e
测试数据
测试使用的用户账号:
- 管理员:username:
admin, password:Test@123 - 普通用户:username:
user, password:Test@123
测试策略
- 冒烟测试:每次代码提交时运行,快速反馈
- 核心旅程测试:PR合并前运行,验证关键业务流程
- 单元测试:补充功能覆盖率,目标80%
维护指南
- 新增核心业务功能时,在
journeys/目录下添加测试 - 新增基础功能时,在
smoke/目录下添加测试 - 保持测试文件数量精简,避免重复测试
- 优先使用单元测试覆盖功能细节