feat: Drama Studio 프로젝트 초기 구조 설정

- 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>
This commit is contained in:
jungwoo choi
2026-01-26 11:39:38 +09:00
commit cc547372c0
70 changed files with 18399 additions and 0 deletions

58
CLAUDE.md Normal file
View File

@ -0,0 +1,58 @@
# 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 | 모니터링 |