# CLAUDE.md

## 1. 프로젝트 개요
- 서비스 목적과 핵심 가치
- 타겟 사용자
- 현재 개발 단계 (MVP / 베타 / 프로덕션)

## 2. 기술 스택
- **Frontend**: Next.js 14 (App Router), TypeScript, Tailwind CSS, shadcn/ui
- **Backend**: Node.js, Express / Fastify
- **Database**: PostgreSQL + Prisma ORM
- **Auth**: NextAuth.js
- **Infra**: Vercel, AWS S3
- **패키지 매니저**: pnpm

## 3. 프로젝트 구조
\`\`\`
src/
├── app/          # Next.js App Router 페이지
├── components/   # 공통 컴포넌트
│   ├── ui/       # 기본 UI (shadcn)
│   └── features/ # 기능별 컴포넌트
├── lib/          # 유틸리티, 헬퍼
├── hooks/        # 커스텀 훅
├── types/        # TypeScript 타입 정의
└── server/       # 서버 액션, API
\`\`\`

## 4. 코딩 컨벤션
- 언어: TypeScript strict mode 사용
- 컴포넌트: 함수형 컴포넌트만 사용, default export
- 스타일: Tailwind utility class 우선, 인라인 스타일 금지
- 상태관리: useState/useReducer 우선, 전역은 Zustand
- 네이밍: 컴포넌트 PascalCase, 함수/변수 camelCase, 상수 UPPER_SNAKE_CASE
- 파일명: kebab-case.tsx
- 주석: 한국어로 작성

## 5. 핵심 요구사항 / 비즈니스 규칙
- 로그인하지 않은 사용자는 /dashboard 접근 불가
- 결제는 항상 서버 사이드에서 검증
- 사용자 데이터 삭제는 soft delete 방식 사용
- API 응답은 항상 { data, error, message } 형태 통일

## 6. 금지사항 (NEVER DO)
- any 타입 사용 금지
- console.log를 프로덕션 코드에 남기지 않기
- 클라이언트 컴포넌트에서 직접 DB 접근 금지
- 하드코딩된 API URL 금지 (환경변수 사용)

## 7. 선호하는 패턴
- 데이터 페칭: Server Component에서 직접 fetch 우선
- 에러 처리: try-catch + 커스텀 에러 클래스
- 폼: react-hook-form + zod 검증
- API 라우트보다 Server Actions 선호

## 8. 환경변수
- .env.example 파일 참고
- 절대 .env 파일을 코드에 하드코딩하지 말 것

## 9. 현재 TODO / 작업 컨텍스트
- [ ] 현재 작업 중인 기능: 유저 프로필 편집
- [ ] 다음 작업 예정: 알림 시스템
- 최근 변경사항: Prisma → Drizzle ORM 마이그레이션 완료

## 10. 자주 쓰는 명령어
\`\`\`bash
pnpm dev          # 개발 서버
pnpm build        # 빌드
pnpm db:migrate   # DB 마이그레이션
pnpm db:studio    # Prisma Studio
\`\`\`