Monorepo와 Shared Types 기반의 Full Stack 표준 아키텍처 설계

Context

프론트엔드와 백엔드 간의 타입 불일치로 인한 Runtime Error 발생 가능성 상존. 프로젝트 규모 확장 시 개별 레포지토리 운영에 따른 CI/CD 관리 비용 증가 및 Refactoring 난이도 상승 문제 발생.

Technical Solution

• Turbo 기반 Monorepo 구조를 통한 web, api, shared 패키지 분리로 빌드 최적화 및 의존성 관리 효율화
• shared 패키지에 TypeScript 타입 및 Validator를 정의하여 프론트엔드와 백엔드 간의 Single Source of Truth 확보
• Docker Compose를 통한 Local Infrastructure 추상화로 개발 환경과 운영 환경의 Parity 유지
• 환경 변수 검증 로직을 shared 패키지에 통합하여 Application 기동 시점에 설정 누락을 조기 발견하는 Fail-fast 전략 적용
• GitHub Actions 내에 서비스 컨테이너를 포함한 CI 파이프라인을 구축하여 Unit 및 Integration Test의 자동화 구현