Repository navigation
Test Strategy
wcorn edited this page Apr 2, 2026
·
1 revision
프로젝트 전체에 적용하는 테스트 방법론과 각 레벨의 범위를 정의한다.
통합 테스트 중심의 Testing Trophy 구조를 따른다.
╱ E2E ╲ ← 핵심 유저 플로우만 (최소)
╱──────────╲
╱ Integration ╲ ← 가장 두텁게 (핵심)
╱────────────────╲
╱ Unit Tests ╲ ← 복잡한 로직만 (선별적)
╱──────────────────────╲
╱ Static Analysis ╲ ← 타입체크 + 린트 (자동)
╱────────────────────────────╲
| 레벨 | 무엇을 검증하나 | mock 범위 | 실행 빈도 |
|---|---|---|---|
| Static | 타입, 문법 | - | 매 빌드 |
| Unit | 복잡한 순수 로직 | 없음 (Classicist) | 매 PR |
| Integration | 모듈 간 연결, API 계약 | FE: API만 MSW / BE: 없음 | 매 PR |
| E2E | 유저 플로우 관통 | 없음 (전체 실행) | 매 머지 or 수동 |
코드 작성 시점에 잡을 수 있는 것은 테스트로 검증하지 않는다.
| BE | FE | |
|---|---|---|
| 타입 체크 | Java 컴파일러 | TypeScript (tsc -b) |
| 린트 | - | ESLint |
외부 의존성 없이 순수 로직을 검증한다. 단순 위임(CRUD 호출)은 단위 테스트하지 않는다.
- mock을 최소화하고 실제 객체를 사용한다
- 테스트가 구현 세부사항에 결합되지 않아 리팩토링에 강하다
- 복잡한 로직 클래스를
new로 직접 생성해서 테스트한다
| 대상 | 예시 | 방법 |
|---|---|---|
| 도메인 로직 | 우선순위 정렬, 블록 배치, 가용시간 계산 |
new로 생성, 입력→출력 검증 |
| 토큰 처리 | JWT 생성, 파싱, 만료 판정 | 실제 키로 생성 후 검증 |
| 유틸/헬퍼 | 날짜 계산, 데드라인 역산 | 순수 함수 입력→출력 |
| 대상 | 예시 |
|---|---|
| 유틸 함수 | 날짜 포맷, 시간 계산, 데이터 변환 |
| 상태 로직 | Zustand 스토어의 복잡한 상태 전이 |
- Service의 단순 위임 (Repository 호출 후 반환)
- Controller의 요청/응답 매핑
- Entity의 getter/setter
- 컴포넌트 렌더링
- API 훅의 호출 여부
실제 인프라를 사용하되, 테스트 범위를 명확히 잘라서 실행한다.
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 저장, 응답 직렬화까지 한 번에 검증
[Test] → 컴포넌트 렌더 → 유저 인터랙션 → API 호출(MSW) → 상태 변경 → UI 반영
- React Testing Library로 유저 관점에서 테스트한다
- API는 MSW(Mock Service Worker)로 네트워크 레벨에서 모킹
- 구현(state, hook 이름)이 아닌 행동(클릭, 입력, 화면에 보이는 텍스트)을 검증
- 스타일/레이아웃, 스냅샷 테스트 (유지비용 대비 효과 낮음)
- 라이브러리 내부 동작 (React Router 라우팅, TanStack Query 캐싱)
실제 브라우저에서 FE → BE → DB 전체를 관통하는 테스트. 깨지기 쉬우므로 핵심 경로만 최소로 유지한다.
[Playwright] → 브라우저 → FE(React) → API → BE(Spring) → MySQL/Redis
| 플로우 | 검증 내용 |
|---|---|
| 인증 플로우 | 로그인 → 메인 진입, 토큰 만료 → 자동 갱신 |
| 핵심 CRUD | 생성 → 목록 확인 → 수정 → 삭제 (모듈당 1개) |
- 모든 입력 검증 (FE 통합 테스트에서 커버)
- 에러 케이스 전수 (BE API 통합 테스트에서 커버)
- 모든 페이지 탐색
docker-compose로 FE + BE + MySQL + Redis 전체 구동 후 실행한다.
┌─────────────────────────────────────────────────────────┐
│ 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 컴파일러 │
└─────────────────────────────────────────────────────────┘
| BE | FE | |
|---|---|---|
| 단위 테스트 | JUnit 5 | Vitest |
| 통합 테스트 | MockMvc + TestContainers | React Testing Library + MSW |
| E2E | - | Playwright |
| DB 테스트 | TestContainers (MySQL, Redis) | - |
| Assertion | AssertJ | Vitest expect + jest-dom |
| 결정 | 대안 | 선택 이유 |
|---|---|---|
| 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 네이티브 통합, 설정 공유, 빠른 실행 |