Skip to main content

사전 요구사항

  • Docker (Docker Compose v2 포함)
  • Git
  • (선택사항) 로컬 린팅 및 타입 체크를 위한 uv

클론 및 시작

핫리로드와 함께 개발 환경을 시작합니다:
개발은 프로덕션과 동일한 Docker 컨테이너에서 실행됩니다. 소스 변경 사항은 docker compose watch를 통해 자동으로 컨테이너에 동기화됩니다 — 수동 재빌드가 필요 없습니다.

Make 타겟

프로젝트 구조

핫 리로드

make devdocker compose watch를 사용하여 소스 파일을 모니터링합니다. 코드를 편집하면:
  1. 변경 사항이 실행 중인 컨테이너에 자동으로 동기화됩니다
  2. 영향을 받는 서비스가 새 코드로 재시작됩니다
  3. 수동 docker compose build나 재시작이 필요 없습니다
프로덕션과 정확히 동일한 Docker 환경을 유지하면서 가장 빠른 개발 루프를 제공합니다.

테스트 실행

기여 가이드

기여 워크플로우를 알아보세요 — 브랜칭, 커밋, 풀 리퀘스트.