# CLAUDE.md

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

## 프로젝트 개요

**Flume** - K8s 기반 범용 파이프라인 시스템

**기술 스택:**
- Frontend: Next.js 16 + React 19 + TypeScript + Tailwind CSS 4 + shadcn/ui
- Backend: FastAPI + Python 3.11 + Pydantic v2
- Database: MongoDB 7.0 (motor async) + Redis 7
- AI: Claude API + OpenAI API + 로컬 LLM (vLLM)
- GPU: V100 16GB×8, V100 32GB×4, RTX 3090 24GB×2 (총 304GB VRAM)
- Container: Docker + Kubernetes
- Repository: Gitea (http://gitea.yakenator.io/yakenator/)

## 개발 컨벤션

### 언어
- Docstring, 주석, 로그: 한국어 + 영문 혼용
- 변수/함수: Python은 snake_case, TypeScript는 camelCase
- 파일 인코딩: UTF-8 (`ensure_ascii=False`)

### 커밋 메시지
```
<type>: <description>

- <detail>

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
```
타입: feat, fix, chore, refactor, docs

## 네이밍 규칙

- 컨테이너: `{프로젝트}-{서비스명}`
- 볼륨: `{프로젝트}_{데이터유형}_data`
- 네트워크: `{프로젝트}-network`

## 상세 가이드

프로젝트 표준 및 패턴은 `.claude/skills/` 디렉토리 참조:

| 우선순위 | 스킬 | 설명 |
|---------|------|------|
| 1 | deployment-standards | Docker 배포 규칙 |
| 1 | project-stack | 기술 스택 및 구조 |
| 1 | korean-dev-conventions | 한국어 컨벤션 |
| 1 | gpu-local-models | GPU 인프라 및 로컬 LLM |
| 1 | flume-architecture | Flume 파이프라인 시스템 |
| 2 | ai-api-integration | Claude/OpenAI 통합 |
| 2 | api-design-standards | RESTful API 설계 |
| 2 | frontend-component-patterns | React 컴포넌트 |
| 2 | database-patterns | MongoDB 패턴 |
| 3 | gitea-workflow | Git 워크플로우 |
| 3 | testing-standards | 테스트 작성 |
| 3 | monitoring-logging | 모니터링 |