Genova AI - AX AgriEdu Platform

AI 기반 동영상 분석 플랫폼

프로젝트 개요

Genova AI는 동영상을 분석하여 자동으로 요약, 구간 분할, 스크립트 생성 등을 제공하는 플랫폼입니다.

• Frontend: Vite + React 19 + TypeScript
• Backend: FastAPI + Python 3.12
• Infrastructure: Google Cloud Platform (Cloud Run, Cloud SQL, Vertex AI)

---

프로젝트 구조

genova-ai/
├── cmd/               # 개발환경 실행/종료 스크립트
├── frontend/          # Vite + React 19 프론트엔드
├── backend/           # FastAPI 백엔드
├── docs/              # 문서
│   ├── agent/         # Claude Code 작업 흐름과 역할
│   ├── reference/     # 아키텍처, 기술스택, API, 인프라 가이드
│   └── workflow/      # 작업 계획/진행/완료 (로컬 전용)
├── docker-compose.yml # 로컬 개발용 (PostgreSQL, Redis)
├── setup-local-env.sh # 로컬 인프라 설정
└── CLAUDE.md          # Claude Code 공통 규칙

---

빠른 시작

원클릭 개발환경 실행

./cmd/dev_start.sh

PostgreSQL, Redis, 백엔드(8000), 프론트엔드(3000)가 모두 실행됩니다.

종료

./cmd/dev_stop.sh

개별 실행

# 1. 로컬 인프라 (PostgreSQL, Redis)
./setup-local-env.sh

# 2. 백엔드 (새 터미널)
cd backend && ./deploy-local.sh

# 3. 프론트엔드 (새 터미널)
cd frontend && ./deploy-local.sh

• Frontend: http://localhost:3000
• Backend API Docs: http://localhost:8000/docs

---

배포

Dev 환경 (Cloud Run)

# 프론트엔드
cd frontend && ./deploy-dev.sh

# 백엔드
cd backend && ./deploy-dev.sh

Cloud Build를 통해 Docker 빌드 → GCR 푸시 → Cloud Run 배포가 자동 진행됩니다.

---

기술 스택

Frontend

• Build: Vite 6
• UI: React 19 + TypeScript
• Routing: react-router-dom v7
• Styling: Emotion (CSS-in-JS)
• State: Zustand + TanStack React Query
• Auth: Firebase Auth

Backend

• Framework: FastAPI + Python 3.12
• DB: PostgreSQL 15 (Cloud SQL) + SQLAlchemy Async
• Cache: Redis 7
• AI: Vertex AI (Gemini), Cloud Translation API
• Media: FFmpeg, yt-dlp

Infrastructure

• Platform: Google Cloud Platform (asia-northeast3)
• Compute: Cloud Run (Serverless)
• Storage: Cloud Storage (GCS)
• CI/CD: Cloud Build
• Secrets: Secret Manager

---

GCP 환경

• Project ID: genova-ai-project
• Region: asia-northeast3 (Seoul)
• Frontend: nginx 정적 서빙 (0.5 vCPU / 256MB)
• Backend: FastAPI (4 vCPU / 8GB)

---

문서

• 코딩 컨벤션
• 로컬 환경 설정
• 아키텍처
• 기술스택 상세
• 프론트엔드 가이드
• 백엔드 가이드
• 인프라 가이드

---

라이선스

Proprietary - Golden Planet Co., Ltd.