<aside> 🧪 테스트 피라미드 / 디렉토리 / 도구 + Go 코드 스타일 / 네이밍 / 에러 / 로깅 / 커밋 컨벤션 · 원본: [.claude/rules/05-testing.md + 06-code-style.md](https://github.com/EinSofINTEREST/IssueTracker/blob/main/.claude/rules/05-testing.md + 06-code-style.md)

</aside>

🧪 테스트 철학

• Coverage: 핵심 패키지 70% 이상, critical path (크롤러 / 처리) 90%+, 에러 처리 path 100%
• Test Pyramid: Unit 70% · Integration 25% · E2E 5%
• Isolation: 외부 의존성은 mock/stub, deterministic, parallelizable
• Naming: Test<Function><Scenario><Expected>

테스트 디렉토리 규칙 (test/ 미러링)

소스 파일과 같은 디렉토리에 테스트 두지 않음. test/ 아래에 서비스 아키텍처 동일 경로.

test/                        ← 모든 테스트 파일의 루트
├── internal/                ← internal/ 패키지 테스트
│   ├── classifier/          ← internal/classifier/
│   ├── processor/fetcher/core/   ← internal/processor/fetcher/core/
│   └── storage/             ← internal/storage/
└── pkg/                     ← pkg/ 패키지 테스트
    ├── config/
    └── logger/

// 패키지 선언은 외부 테스트 패키지 형식: package <name>_test

도구 / 기법

• Unit: testing 표준 + testify/assert + testify/mock + httptest
• Integration: testcontainers (Postgres 15-alpine, Kafka 7.5.0) — 실제 컨테이너 띄움
• Mocking: HTTP client · DB (sqlmock) · embedding API mock
• Table-driven 적극 활용 — 단일 함수 다양 시나리오
• Benchmark: 핫 패스 -benchmem · -memprofile 로 메모리 프로파일
• CI: GitHub Actions · 커버리지 70% 미달 시 fail

Smoke / Load

• Smoke: 배포 직후 production 환경 health endpoint 호출
• Load: Locust (HttpUser, between(1,3)s) — major release 전 실행