cc547372c0
- FastAPI 백엔드 (audio-studio-api) - Next.js 프론트엔드 (audio-studio-ui) - Qwen3-TTS 엔진 (audio-studio-tts) - MusicGen 서비스 (audio-studio-musicgen) - Docker Compose 개발/운영 환경 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
# 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 | 모니터링 |
|