# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Language Preference

**IMPORTANT**: Always communicate with the user in Korean (한국어) unless explicitly asked otherwise.

## 기술 스택
- **JAVA**: 17
- **SpringBoot**: 3.0
- Gradle

## 개발 규칙

### 1. 코드 작성 규칙
- **절대 모킹하지 않기**: 실제 동작하는 코드만 작성
- **타입 안정성**: TypeScript 엄격 모드 준수
- **테스트 우선**: 테스트 커버리지 90% 이상 유지
- **컴포넌트 네이밍**: PascalCase, 기능을 명확히 나타내는 이름 사용

### 2. 패키지 버전 호환성
- 새 패키지 추가 시 기존 의존성과 충돌 확인

### 3. 파일 구조 규칙
- `index.js`로 export 모듈화
- `.unit.spec.tsx` 확장자로 단위 테스트 작성
- `.types.ts`, `.constants.ts`, `.utils.ts` 분리

### 4. 스크립트 명령어

## 특별 주의사항
### 1. 절대 하지 말 것
- Mock 데이터나 가짜 구현 사용
- 타입 any 사용
- 직접적인 DOM 조작
- console.log 프로덕션 코드에 남기기

### 2. 권장사항
- 실제 API 호출하는 코드 작성
- 재사용 가능한 컴포넌트 설계
- 접근성 고려
- 성능 최적화 적용

### 3. 문제 해결 우선순위
1. 실제 동작하는 해결책 찾기
2. 기존 코드 패턴 분석 후 일관성 유지
3. 타입 안정성 보장
4. 테스트 가능한 구조로 설계