conventions Git Workflow

Git 워크플로우

목차

• 1. Git Commit 컨벤션
• 2. Git Branch 컨벤션
• 3. Issue 컨벤션
• 4. PR 컨벤션

1. Git Commit 컨벤션

커밋 유형	의미
feat	새로운 기능 추가
fix	버그 수정
docs	문서 수정
style	코드 formatting, 세미콜론 누락, 코드 자체의 변경이 없는 경우
refactor	코드 리팩토링
test	테스트 코드, 리팩토링 테스트 코드 추가
chore	패키지 매니저 수정, 그 외 기타 수정 ex) .gitignore
rename	파일 또는 폴더 명을 수정하거나 옮기는 작업만인 경우
remove	파일을 삭제하는 작업만 수행한 경우
!HOTFIX	급하게 치명적인 버그를 고쳐야 하는 경우

feat (domain): 새로운 기능 추가
fix (domain): 버그 수정
refactor (domain): 코드 리팩토링
style (domain): 코드 포맷팅, 세미콜론 누락 등
docs: 문서 수정
test: 테스트 코드 추가/수정
chore: 빌드 업무, 패키지 매니저 수정

예시: feat (User): 로그인 기능 추가

2. Git Branch 컨벤션

<이슈번호>-<커밋 유형>/내용

Git Flow

main(배포 버전 코드)
develop(개발 단계 코드)

// 영어로 쓰기
15-feature/implement-user-login

3. Issue 컨벤션

[Title] - [Issue Tag: {담당자}{도메인}{우선순위}]

[Issue Type]

Issue Type

Issue Type	의미
Feature	새로운 기능 개발
Enhancement	기존 기능 개선, 리팩토링, 성능 개선
Task	Feature/Enhancement의 하위 작업 (Sub Issue)
Chore	환경 세팅, CI/CD, 의존성 업데이트 등 비기능 작업
Bug	버그 수정

Issue Tag

우선순위	의미
p0	즉시 대응 필요, 서비스 장애 또는 핵심 기능 불가
p1	현재 스프린트 내 처리, 주요 기능 개발 및 중요 버그
p2	일정 여유 시 처리, 개선 사항 및 minor 버그
p3	백로그, 당장 급하지 않은 아이디어 및 기술 부채

3. PR 컨벤션

해당하는 Issue Type 명시

예시:
[Feature] 일정 생성 API 구현
[Enhancement] 결제 모듈 응답 처리 리팩토링
[Bug] 토큰 만료 시 500 에러 수정
[Chore] Redis 설정 추가