🛠️ Tech Stack

🧩 Backend

🗄️ Database

🔔 Notification

☁️ Infrastructure / DevOps

🧪 Testing

📊 Monitoring

⚙️ Initial settings

1. 저장소 클론

   git clone
   

2. 패키지 설치

   npm install
   

3. .env 파일 생성 및 환경 변수 설정
4. 개발 서버 실행

   npm run start:dev
   

💻 Coding Convention

🔀 Git Flow

1. Issue 생성
2. Issue 기준으로 Branch 생성
3. 개발 진행 → add → commit → push
4. Pull Request 생성
5. 팀원 Code Review 진행
6. Review 완료 후 Merge

🏷 Type & Emoji Convention

✨ feat: 새로운 기능 추가 (API, 비즈니스 로직, UI 기능)
🐛 fix: 버그 수정
📝 docs: 문서 추가 / 수정 / 삭제
♻️ refactor: 코드 리팩토링 (기능 변화 없음)
🎨 style: 코드 스타일 수정 (포맷, 세미콜론 등 / 로직 변경 없음)
🔧 chore: 빌드 설정, 패키지 매니저 등 기타 작업
🔥 remove: 파일 또는 코드 삭제
🚀 deploy: 운영 서버 배포 설정 변경

🌿 Branch Naming Convention

형식
{type}/#{이슈번호}-기능설명

feat/#123-user-login-api

💬 Commit Message Convention

형식 {깃모지} {type}: 기능설명

✨ feat: 로그인 api 구현
🐛 fix: 토큰 만료 오류 수정

📝 Issue Title Convention

형식
{깃모지} {Type}: 기능설명

🎉 Init: Prisma 모델 정의
🐛 Fix: 로그인 시 토큰 오류

🔃 Pull Request Title Convention

형식
{깃모지} {Type}: #{이슈번호} 기능 설명

🎉 Init: #1 Prisma 모델 정의
✨ Feat: #5 OpenAPI 통해 공연 데이터 수집

🚀 Deploy

브랜치 전략

브랜치	설명	서버	API 버전	포트
main	운영 서버 배포	prod EC2	v5	4000
develop	개발 서버 배포	dev EC2	v5	4000
legacy	구버전 운영 유지	prod EC2	v4	3000

Nginx 라우팅

/api/v4/  →  port 3000 (legacy)
/api/v5/  →  port 4000 (main)
/auth/    →  port 4000 (main)

버전 전환 패턴

v6 완성 시: main → legacy 머지, develop → main 머지