[G1-Sync] Manual knowledge update

10_Wiki/Topics/Coding/Testing_Test_Pyramid.md

@@ -0,0 +1,114 @@
+---
+id: testing-test-pyramid
+title: Test Pyramid — 어디에 얼마나 투자할까
+category: Coding
+status: draft
+source_trust_level: B
+verification_status: conceptual
+created_at: 2026-05-09
+updated_at: 2026-05-09
+tags: [testing, test-pyramid, vibe-coding]
+tech_stack: { language: "Any", applicable_to: ["Backend", "Web", "Mobile"] }
+applied_in: []
+aliases: [unit, integration, e2e, testing strategy, ice cream cone]
+---
+
+# Test Pyramid
+
+> **Unit (많이) → Integration (중간) → E2E (적게)** 가 표준. 거꾸로 ice-cream cone (E2E 만 잔뜩) 은 느림 + 깨짐 + 디버깅 지옥. 단 modern 환경에서는 integration 비중이 더 큼.
+
+## 📖 핵심 개념
+- Unit: 한 함수 / 한 컴포넌트. ms 단위. 모킹 많음.
+- Integration: DB / API / 다른 모듈 결합. 초 단위. 진짜 의존성.
+- E2E: 브라우저 / 디바이스 전체 시나리오. 분 단위. flaky 가능.
+- Contract: 다른 서비스와의 API 약속.
+
+비율 가이드 (출발점):
+- Unit: 60-70%
+- Integration: 20-30%
+- E2E: 5-10%
+
+## 💻 코드 패턴
+
+### Unit (Jest / Vitest)
+```ts
+import { applyDiscount } from './pricing';
+
+test('10% off above $100', () => {
+  expect(applyDiscount({ total: 150 })).toEqual({ total: 150, discount: 15 });
+  expect(applyDiscount({ total: 50 })).toEqual({ total: 50, discount: 0 });
+});
+```
+
+### Integration — 진짜 DB
+```ts
+import { test, beforeAll } from 'vitest';
+import { Pool } from 'pg';
+
+const pool = new Pool({ connectionString: process.env.TEST_DATABASE_URL });
+
+beforeAll(async () => {
+  await pool.query('CREATE TEMP TABLE users (id SERIAL, email TEXT UNIQUE)');
+});
+
+test('createUser inserts row', async () => {
+  const repo = new UserRepo(pool);
+  const u = await repo.create({ email: 'a@a.com' });
+  const found = await repo.find(u.id);
+  expect(found?.email).toBe('a@a.com');
+});
+```
+testcontainers / Docker compose 로 진짜 Postgres 띄우는 게 표준.
+
+### E2E (Playwright)
+```ts
+import { test, expect } from '@playwright/test';
+
+test('login flow', async ({ page }) => {
+  await page.goto('/login');
+  await page.getByLabel('Email').fill('a@a.com');
+  await page.getByLabel('Password').fill('secret');
+  await page.getByRole('button', { name: 'Sign in' }).click();
+  await expect(page).toHaveURL('/dashboard');
+});
+```
+
+### Component test — 중간 zone
+```ts
+// React Testing Library
+test('counter increments', async () => {
+  render(<Counter />);
+  await userEvent.click(screen.getByRole('button'));
+  expect(screen.getByText('1')).toBeInTheDocument();
+});
+```
+
+## 🤔 의사결정 기준
+| 코드 | 어디서 테스트 |
+|---|---|
+| 순수 함수 (계산, 포매팅) | Unit |
+| Repository / DAO | Integration (testcontainers) |
+| API endpoint | Integration (supertest) |
+| React 컴포넌트 (단일) | Component (RTL + jsdom) |
+| 복잡 form / 인증 / 결제 흐름 | E2E (Playwright) |
+| 다른 서비스 약속 | Contract test (Pact) |
+| Performance | benchmark 별도 |
+
+## ❌ 안티패턴
+- **모든 것 E2E**: 느림 + flaky. 빠른 피드백 못 받음.
+- **unit test 가 모킹 천국**: 모킹된 인터페이스는 실제와 다를 수 있음 → 통합 시 사고. integration 도 필수.
+- **DB 모킹 (Jest mock)**: 실제 SQL 검증 안 됨. testcontainers 권장.
+- **`it.skip` 누적**: dead test. 청소.
+- **flaky test 무시**: 한 번 무시하면 영구 무시. 즉시 fix 또는 quarantine.
+- **테스트가 production 환경 의존**: 다른 dev 가 못 돌림. self-contained.
+- **snapshot test 무지성 update**: 의미 없어짐. diff 검토 후만 update.
+- **coverage 100% 강제**: 의미 없는 테스트 양산. critical path 우선.
+
+## 🤖 LLM 활용 힌트
+- 새 함수: unit test + edge case 같이 생성 요청.
+- API: supertest + testcontainers 패턴.
+- E2E 는 critical journey 만.
+
+## 🔗 관련 문서
+- [[Testing_Contract_Testing]]
+- [[Testing_Mocking_Boundaries]]