Files
2nd/10_Wiki/Topics/Architecture/Test Pyramid (테스트 피라미드).md
T

95 lines
6.0 KiB
Markdown

---
id: wiki-2026-0508-test-pyramid-테스트-피라미드
title: Test Pyramid (테스트 피라미드)
category: 10_Wiki/Topics
status: needs_review
canonical_id: self
aliases: []
duplicate_of: none
source_trust_level: A
confidence_score: 0.92
tags: [uncategorized]
raw_sources: []
last_reinforced: 2026-05-08
github_commit: pending
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
tech_stack:
language: unspecified
framework: unspecified
---
# [[Test Pyramid (테스트 피라미드)]]
## 📌 한 줄 통찰 (The Karpathy Summary)
테스트 피라미드(Test Pyramid)는 마이크 콘(Mike Cohn)이 고안한 개념으로, 소프트웨어 테스트를 다양한 세분화 수준(granularity)의 계층으로 분류하고 각 계층에서 수행해야 할 테스트의 적정 비율을 나타내는 시각적 메타포입니다 [1]. 하단에는 빠르고 작은 단위 테스트를 많이 배치하고, 상단으로 갈수록 범위가 넓고 느린 엔드투엔드(End-to-End) 테스트를 적게 배치해야 한다는 핵심 원칙을 제시합니다 [2]. 이를 통해 개발 팀은 빠르고 신뢰할 수 있으며 유지보수가 용이한 자동화된 테스트 제품군을 구축하여 소프트웨어 제공 속도와 품질을 높일 수 있습니다 [2, 3].
## 📖 구조화된 지식 (Synthesized Content)
* **기본 원칙:** 테스트 피라미드는 두 가지 핵심 규칙을 따릅니다. 첫째, 다양한 세분화 수준을 가진 테스트를 작성해야 하며, 둘째, 상위 수준으로 올라갈수록 테스트의 수를 줄여야 합니다 [2].
* **단위 테스트 (Unit Tests):** 피라미드의 가장 아래층인 기반을 이루며 전체 자동화 테스트의 약 70%를 차지하는 것이 이상적입니다 [4]. 개별 컴포넌트나 함수가 의도한 대로 작동하는지 독립적으로 검증하며, 밀리초 단위로 실행될 만큼 빠르고 작성 및 유지보수 비용이 저렴합니다 [4, 5].
* **통합 테스트 (Integration Tests):** 피라미드의 중간 계층에 위치하며 약 20%의 비중을 갖습니다 [6]. 데이터베이스, 파일 시스템, 외부 API 등 애플리케이션 외부 요소와의 연동이 올바르게 이루어지는지 검증합니다 [7]. 단위 테스트보다는 느리지만, 개별 컴포넌트가 상호작용할 때 발생하는, 단위 테스트에서 잡을 수 없는 결함을 찾아내는 역할을 합니다 [6, 8].
* **엔드투엔드 테스트 (End-to-End Tests):** 피라미드의 최상단에 위치하며 약 10%의 비중을 차지해야 합니다 [9]. 실제 사용자의 여정을 시뮬레이션하여 사용자 인터페이스부터 백엔드 서비스까지 전체 시스템이 제대로 기능하는지 검증합니다 [9].
* **테스트 중복 방지와 하향 배치:** 상위 수준의 테스트가 오류를 발견했는데 하위 수준 테스트가 실패하지 않았다면 하위 수준의 테스트를 추가로 작성해야 합니다 [10]. 가능한 한 테스트를 피라미드의 가장 아래쪽으로 밀어내어 테스트 제품군의 실행 속도를 빠르고 간결하게 유지하는 것이 중요합니다 [10].
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
* **역방향 테스트 피라미드 (Inverted Test Pyramid) 안티패턴:** 하향식(UI 도구 중심)으로 자동화 전략을 구축하면 피라미드가 역전되어 단위 테스트는 거의 없고 느리고 깨지기 쉬운 엔드투엔드 테스트만 수백 개 쌓이는 현상이 발생합니다 [9]. 이 안티패턴은 테스트 실행에 수 시간이 걸리게 만들어 빌드 빈도를 떨어뜨리고, 간헐적 실패(Flaky Tests)를 유발하여 결국 팀이 테스트 결과를 무시하게 만드는 부작용을 초래합니다 [9, 11].
* **상위 계층 테스트의 한계:** 엔드투엔드 및 UI 테스트는 구축 비용이 가장 비싸고, 실행 속도가 가장 느리며, 유지보수 측면에서 가장 깨지기 쉽습니다(brittle) [9, 12]. 따라서 하위 계층에서 이미 검증된 예외 케이스(edge cases)를 상위 계층에서 중복으로 테스트하는 것은 높은 유지보수 비용과 오탐(false positives)을 발생시키므로 피해야 합니다 [10, 12].
* **용어의 모호성과 오해:** 원래의 피라미드 모델에서 사용된 '서비스 테스트(Service Test)'나 'UI 테스트' 같은 용어는 현대의 소프트웨어 아키텍처(예: SPA 프레임워크) 환경에서 혼란을 줄 수 있습니다 [2]. 용어 자체에 얽매이기보다는 일관된 테스트 분류 체계를 팀 내에서 공유하고, 각 계층의 역할을 명확히 인지하는 것이 훨씬 중요합니다 [2, 13].
---
*Last updated: 2026-05-03*
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
**언제 이 지식을 쓰는가:**
- *(TODO)*
**언제 쓰면 안 되는가:**
- *(TODO)*
## 🧪 검증 상태 (Validation)
- **정보 상태:** needs_review
- **출처 신뢰도:** A
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
## 🧬 중복 검사 (Duplicate Check)
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
- **처리 방식:** UPDATE (자동 정규화)
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
## 🔗 지식 연결 (Graph)
- **Parent:** [[10_Wiki/Topics]]
- **Related:** *(TODO: 최소 2개)*
- **Opposite / Trade-off:** *(TODO)*
- **Raw Source:** 직접 입력
## 🕓 변경 이력 (Changelog)
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|------|-----------|-----------|--------|
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
## 💻 코드 패턴 (Code Patterns)
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
```text
# TODO
```
## 🤔 의사결정 기준 (Decision Criteria)
**선택 A를 써야 할 때:**
- *(TODO)*
**선택 B를 써야 할 때:**
- *(TODO)*
**기본값:**
> *(TODO)*
## ❌ 안티패턴 (Anti-Patterns)
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*