Home

dnd-15th-3-backend Wiki

DND 15기 3조 백엔드 팀의 개발 문서입니다.

📖 문서 목록

문서	설명
Git Flow	브랜치 전략과 PR / 머지 규칙
Commit Convention	커밋 메시지 작성 규칙
Code Convention	코드 스타일 및 네이밍 규칙
Folder Structure	NestJS 폴더 구조와 모듈 설계 규칙
Environment Variables	환경 변수 설정과 zod 검증, mise 역할 분리
Deployment	OCI k3s + ArgoCD GitOps 배포와 환경별 운영 규칙
Storage API	OCI Object Storage pre-signed URL 사용법

🚀 Quick Start

# 최초 환경 세팅 (툴체인 + 의존성 설치 + 로컬 DB 초기화)
mise run setup

# 환경 변수 파일 준비 (최초 1회, 값 채우기)
cp .env.example .env.development

# 로컬 DB 시작
pnpm db:start

# DB role과 앱 DB 생성 (최초 1회, .env.example 기준값)
createuser -h /tmp postgres
createdb -h /tmp -O postgres momo

# 개발 서버 실행 (watch 모드)
pnpm start:dev

createuser / createdb는 mise가 설치한 PostgreSQL 17의 커맨드이므로 mise 셸 활성화 상태에서 실행해야 합니다. initdb는 OS 사용자명의 superuser만 만들기 때문에, 이 단계를 건너뛰면 role "postgres" does not exist / database "momo" does not exist 에러로 부팅에 실패합니다. OCI_REGION이 비어 있어도 S3Client 초기화 에러로 부팅에 실패하므로 .env.development에 최소한 리전은 채워야 합니다. 자세한 내용은 Environment Variables를 참고하세요.