zhangxiang
015cb0dc78
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/目录下添加测试 - 保持测试文件数量精简，避免重复测试
- 优先使用单元测试覆盖功能细节