🚦협업 규칙 및 참고사항
1️⃣ Git 브랜치 전략
main
: 운영 배포용 브랜치
develop
: 개발 통합 브랜치
feature/{아이디}/{기능명}
: 기능 개발 브랜치
2️⃣ 커밋 메시지 규칙
🏷️ 커밋 타입
Tag Name |
Description |
Feat |
새로운 기능/주요 파일을 추가할 때 |
Fix |
버그 수정 |
Design |
CSS 등 사용자 UI 디자인 변경 |
!BREAKING CHANGE |
커다란 API 변경의 경우 |
!HOTFIX |
급하게 치명적인 버그를 고쳐야 하는 경우 |
Style |
코드 포맷 변경, 세미콜론 누락 등(로직 변경 없음) |
Refactor |
프로덕션 코드 리팩토링 |
Comment |
필요한 주석 추가 및 변경 |
Docs |
문서 수정 |
Test |
테스트 코드, 리팩토링 테스트 코드 추가 |
Chore |
빌드 업무, 패키지 매니저 등 업데이트 |
Rename |
파일/폴더명 수정, 이동만 수행한 경우 |
Remove |
파일 삭제 작업만 수행한 경우 |
📝 커밋 메시지 작성 형식
makefile
복사편집
타입: 간단한 설명
상세 설명 (선택사항, 한 줄 띄우고 작성)
🌟 커밋 메시지 예시
makefile
복사편집
Feat: 사용자 선호도 기반 경로 추천 기능 추가
사용자가 맛집/관광지/쇼핑 등의 선호도를 설정할 수 있고,
이를 바탕으로 개인화된 여행 경로를 생성합니다.
Fix: 경로 계산 시 거리 계산 오류 수정
Google Maps API 응답에서 duration과 distance 필드를
잘못 파싱하던 문제를 수정했습니다.
Refactor: 경로 알고리즘 성능 최적화
O(n²) 알고리즘을 O(n log n)으로 개선하여
응답 시간을 5초에서 1초로 단축했습니다.
💡 커밋 작성 가이드
- 간단한 코드 수정
- 버그 수정 →
Fix
- 코드 개선 →
Refactor
- 포맷팅만 →
Style
- 주석 추가 →
Comment
- 커밋 메시지는 현재형으로 작성
- 제목은 50자 이내로 간결하게
- 본문이 필요한 경우 한 줄 띄우고 상세 설명 작성