Skip to content

Test Strategy

wcorn edited this page Apr 2, 2026 · 1 revision

테스트 전략

프로젝트 전체에 적용하는 테스트 방법론과 각 레벨의 범위를 정의한다.

1. 테스트 피라미드

통합 테스트 중심의 Testing Trophy 구조를 따른다.

        ╱  E2E  ╲              ← 핵심 유저 플로우만 (최소)
       ╱──────────╲
      ╱ Integration ╲          ← 가장 두텁게 (핵심)
     ╱────────────────╲
    ╱    Unit Tests     ╲      ← 복잡한 로직만 (선별적)
   ╱──────────────────────╲
  ╱     Static Analysis     ╲  ← 타입체크 + 린트 (자동)
 ╱────────────────────────────╲
레벨 무엇을 검증하나 mock 범위 실행 빈도
Static 타입, 문법 - 매 빌드
Unit 복잡한 순수 로직 없음 (Classicist) 매 PR
Integration 모듈 간 연결, API 계약 FE: API만 MSW / BE: 없음 매 PR
E2E 유저 플로우 관통 없음 (전체 실행) 매 머지 or 수동

2. Static Analysis

코드 작성 시점에 잡을 수 있는 것은 테스트로 검증하지 않는다.

BE FE
타입 체크 Java 컴파일러 TypeScript (tsc -b)
린트 - ESLint

3. Unit Test — 복잡한 비즈니스 로직만

외부 의존성 없이 순수 로직을 검증한다. 단순 위임(CRUD 호출)은 단위 테스트하지 않는다.

방법론: Classicist (Detroit 스타일)

  • mock을 최소화하고 실제 객체를 사용한다
  • 테스트가 구현 세부사항에 결합되지 않아 리팩토링에 강하다
  • 복잡한 로직 클래스를 new로 직접 생성해서 테스트한다

BE 대상

대상 예시 방법
도메인 로직 우선순위 정렬, 블록 배치, 가용시간 계산 new로 생성, 입력→출력 검증
토큰 처리 JWT 생성, 파싱, 만료 판정 실제 키로 생성 후 검증
유틸/헬퍼 날짜 계산, 데드라인 역산 순수 함수 입력→출력

FE 대상

대상 예시
유틸 함수 날짜 포맷, 시간 계산, 데이터 변환
상태 로직 Zustand 스토어의 복잡한 상태 전이

단위 테스트하지 않는 것

  • Service의 단순 위임 (Repository 호출 후 반환)
  • Controller의 요청/응답 매핑
  • Entity의 getter/setter
  • 컴포넌트 렌더링
  • API 훅의 호출 여부

4. Integration Test — 가장 두텁게

실제 인프라를 사용하되, 테스트 범위를 명확히 잘라서 실행한다.

BE — 2가지 레벨

Repository 통합 (Domain 모듈)

[Test] → Repository → TestContainers DB
  • JPA 매핑, 쿼리 메서드, 연관관계가 실제 DB에서 동작하는지 검증
  • @DataJpaTest + TestContainers
  • 대상: 커스텀 쿼리, 복잡한 연관관계, cascade/orphan 설정

API 통합 (App 모듈, 핵심)

[Test] → Controller → Service → Repository → TestContainers DB/Redis
  • HTTP 요청 → 응답 전체 흐름을 검증한다
  • @SpringBootTest + MockMvc + TestContainers
  • 실제 Service, 실제 Repository, 실제 DB — mock 없음
  • 요청 직렬화, 인증/인가, 비즈니스 로직, DB 저장, 응답 직렬화까지 한 번에 검증

FE — 컴포넌트 + API 모킹

[Test] → 컴포넌트 렌더 → 유저 인터랙션 → API 호출(MSW) → 상태 변경 → UI 반영
  • React Testing Library로 유저 관점에서 테스트한다
  • API는 MSW(Mock Service Worker)로 네트워크 레벨에서 모킹
  • 구현(state, hook 이름)이 아닌 행동(클릭, 입력, 화면에 보이는 텍스트)을 검증

통합 테스트하지 않는 것

  • 스타일/레이아웃, 스냅샷 테스트 (유지비용 대비 효과 낮음)
  • 라이브러리 내부 동작 (React Router 라우팅, TanStack Query 캐싱)

5. E2E Test — 핵심 유저 플로우만

실제 브라우저에서 FE → BE → DB 전체를 관통하는 테스트. 깨지기 쉬우므로 핵심 경로만 최소로 유지한다.

[Playwright] → 브라우저 → FE(React) → API → BE(Spring) → MySQL/Redis

범위 — 깨지면 서비스가 안 되는 경로만

플로우 검증 내용
인증 플로우 로그인 → 메인 진입, 토큰 만료 → 자동 갱신
핵심 CRUD 생성 → 목록 확인 → 수정 → 삭제 (모듈당 1개)

E2E에서 하지 않는 것

  • 모든 입력 검증 (FE 통합 테스트에서 커버)
  • 에러 케이스 전수 (BE API 통합 테스트에서 커버)
  • 모든 페이지 탐색

실행 환경

docker-compose로 FE + BE + MySQL + Redis 전체 구동 후 실행한다.

6. 경계 요약

┌─────────────────────────────────────────────────────────┐
│ E2E (Playwright)                                        │
│ 브라우저 → FE → BE → DB                                  │
│ "로그인해서 데이터를 만들 수 있는가?"                        │
├─────────────────────────────────────────────────────────┤
│ FE 통합 (RTL + MSW)    │ BE API 통합 (MockMvc + TC)     │
│ 컴포넌트 → 유저 행동     │ HTTP → Service → DB            │
│ API는 MSW로 모킹        │ mock 없이 실제 DB               │
│ "폼 제출하면 결과 보이나?" │ "API 호출하면 DB에 저장되나?"    │
├─────────────────────────────────────────────────────────┤
│ FE 단위 (Vitest)        │ BE 단위 (JUnit)                │
│ 유틸, 상태 전이           │ 복잡한 로직, JWT, 계산           │
│ "이 함수가 올바른가?"      │ "이 알고리즘이 올바른가?"        │
├─────────────────────────────────────────────────────────┤
│ Static: TypeScript + ESLint │ Static: Java 컴파일러        │
└─────────────────────────────────────────────────────────┘

7. 도구

BE FE
단위 테스트 JUnit 5 Vitest
통합 테스트 MockMvc + TestContainers React Testing Library + MSW
E2E - Playwright
DB 테스트 TestContainers (MySQL, Redis) -
Assertion AssertJ Vitest expect + jest-dom

8. 선택 근거

결정 대안 선택 이유
Testing Trophy (통합 중심) Test Pyramid (단위 중심) 모듈 간 연결에서 버그가 나는 경우가 대부분, 1인 개발 시 통합 테스트 ROI가 높음
Classicist 단위 테스트 Mockist (London 스타일) mock 최소화로 리팩토링 내성 확보, 구현 변경 시 테스트가 깨지지 않음
BE API 통합에서 mock 없음 Service 단위 테스트 + mock 실제 DB로 전체 흐름을 검증하는 것이 신뢰도 높음
FE에서 MSW 사용 axios mock, fetch mock 네트워크 레벨 모킹으로 구현 세부사항과 분리
E2E 최소화 전수 E2E 깨지기 쉽고 느림, 핵심 플로우만 유지해야 지속 가능
Playwright Cypress 크로스 브라우저, 빠른 실행, 안정적 API
Vitest Jest Vite 네이티브 통합, 설정 공유, 빠른 실행

Clone this wiki locally