Files

jungwoo choi cc547372c0 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>

2026-01-26 11:39:38 +09:00

1.8 KiB

Raw Permalink Blame History

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	모니터링

1.8 KiB Raw Permalink Blame History Unescape Escape