Git 커밋 네이밍 컨벤션

유형(type) 의미 설명 사용 예시
feat 새로운 기능 새로운 기능 개발 feat: 로그인 기능 추가
fix 버그 수정 버그 수정 시 사용 fix: 버튼 클릭 버그 수정
docs 문서 수정 문서 내용 변경 시 사용 docs: 설치 가이드 갱신
style 코드 스타일 공백, 들여쓰기, 세미콜론 등 코드 포맷만 수정했을 때 (기능 변경 X) style: 들여쓰기 수정
refactor 코드 리팩토링 기능 변경 없이 코드 구조 개선 refactor: 로그인 함수 구조 변경
perf 성능 개선 성능 향상을 위한 코드 개선 perf: API 호출 회적화
test 테스트 코드 테스트 코드 추가 또는 수정 test: 회원가입 테스트 추가
chore 잡일 빌드, 패키지 매니저, 설정 등 업무 관련 (기능 변경 X) chore: 패키지 업데이트
rename 이름 변경 파일 또는 디렉토리의 이름을 변경했을 때 rename: robots.txt 이름 변경
remove 삭제 파일 또는 디렉토리 제거했을 때 remove: docs 폴더 제거

<aside>

커밋 메시지

MR

</aside>

Git Branch 컨벤션

<aside>

Git Flow 전략

</aside>

<aside>

네이밍 규칙

<type>-<domain>-<desc>

<aside>

develop의 구조

develop
├─ fe/
├─ be/
├─ ai/
├─ common/
└─ README.md

</aside>

type

Branch 설명 merge 대상 예시
master 배포 가능 브랜치
(직접 접근 및 커밋 금지)
develop 개발 브랜치 (기능 통합)
(직접 접근 및 커밋 금지)
feature 기능 개발 develop feature/be/login
release 배포 준비
(더 이상 새로운 기능 추가 X)
(merge 대상이 아니며, checkout -b를 해야한다. 즉 복사본) master, develop release/1.0
hotfix 출시 버전 버그 수정 master, develop
refactor 구조 개선
(기능 유지 및 코드 스타일만 개선일 때)
(함수 분리, 변수명 변경, 중복 제거 등) develop
test ? 테스트 develop

domain (충돌 방지용)

domain 담당
fe 프론트엔드
be 백엔드
ai AI
common 공통

코딩 컨벤션

공통

들여쓰기 예시) 4칸
주석 예시) Doxygen, JSDoc 등
import 순서 예시) 내부(시스템 및 기본 우선) → 외부 순

프론트-엔드

파일명 (컴포넌트 등) 파스칼
함수명 카멜 케이스 (getSum)

백-엔드