testing-standards

Spycner 的头像作者 Spycner

Klassenzeit monorepo的测试约定、测试运行器配置、覆盖率要求和失败解释。

📖 中文导读:Klassenzeit monorepo的测试约定、测试运行器配置、覆盖率要求和失败解释。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: testing-standards description: Testing conventions, test runner configurations, coverage requirements, and failure interpretation for the Klassenzeit monorepo.

Testing Standards

Test Runner Commands

Backend (Spring Boot / JUnit)

make test-backend           # Run all backend tests
./gradlew test              # Direct Gradle command
./gradlew test --tests "ClassName"  # Run specific test class

Frontend (Vitest / React Testing Library)

make test-frontend          # Run all frontend tests
npm run test                # Run tests once
npm run test:watch          # Watch mode
npm run test:coverage       # With coverage report
npm run test:ui             # Vitest UI

E2E (Playwright)

make test-e2e               # Run all E2E tests
npm run test:e2e            # Direct Playwright run
npm run test:e2e:ui         # Playwright UI mode
npm run test:api            # API integration tests only

Coverage Reports

Type Location Minimum Threshold
Backend backend/build/reports/jacoco/test/html/index.html 80% line coverage
Frontend frontend/coverage/index.html 80% line coverage
E2E e2e/playwright-report/index.html Critical paths covered

Coverage Requirements

  • New code: Minimum 80% line coverage
  • Public API functions: Must have unit tests
  • Critical user flows: Must have E2E tests
  • Edge cases: Error scenarios must be tested

Interpreting Failures

Priority Order

  1. Check if failure is flaky (re-run once with same seed)
  2. Look for recent changes to test file or tested module
  3. Check for environment issues (missing fixtures, DB state, port conflicts)
  4. Inspect assertion messages carefully for root cause

Common Failure Patterns

Backend

  • NullPointerException: Missing mock setup or fixture data
  • ConstraintViolationException: Invalid test data for entity constraints
  • LazyInitializationException: Missing @Transactional or eager fetch

Frontend

  • Unable to find element: Component not rendered, wrong query, async timing
  • act() warning: State update outside test act boundary
  • Mock not called: Wrong mock path or missing mock setup

E2E

  • Timeout: Slow page load, element not visible, wrong selector
  • Element not attached: DOM changed between find and action
  • Navigation error: Auth redirect, missing route, CORS issue

Test File Conventions

  • Backend: src/test/java/**/*Test.java
  • Frontend: src/**/*.test.tsx (co-located with source)
  • E2E: e2e/tests/**/*.spec.ts

Pre-Test Checklist

  1. Services running (make services-up)
  2. Database migrated (Flyway runs on backend startup)
  3. Environment variables set (.env files in place)
  4. Dependencies installed (npm install in frontend/e2e)