SAPHY BackEnd

🛠️ 프로젝트 아키텍처

👷 인프라 아키텍쳐

📠 Convention

🤝 Branch Naming Convention

머릿말	설명
main	서비스 브랜치
develop	배포 전 작업 기준
feat	기능 단위 구현
hotfix	서비스 중 긴급 수정 건에 대한 처리

Branch Naming Convention Detail

master(main) ── develop ── feature
└── hotfix

• 깃 플로우를 베이스로 하여 프로젝트 사이즈에 맞게 재정의했습니다.
• 브랜치 이름은 kebab-case를 따릅니다.
• 이슈 번호는 가장 마지막에 적습니다.

master(main)

• 실제 서비스가 이루어지는 브랜치입니다.
• 이 브랜치를 기준으로 develop 브랜치가 분기됩니다.
• 배포 중, 긴급하게 수정할 건이 생길시 hotfix 브랜치를 만들어 수정합니다.

develop

• 개발, 테스트, 릴리즈 등 배포 전 작업의 기준이 되는 브랜치입니다.
• 해당 브랜치를 default로 설정합니다.
• 이 브랜치에서 feature 브랜치가 분기됩니다.

feature

• 개별 개발자가 맡은 작업을 개발하는 브랜치입니다.
• feat/(feat-name) 과 같이 머릿말을 feat, 꼬릿말을 개발하는 기능으로 명명합니다.
• feat-name의 경우 kebab-case를 따릅니다.
• ex) feat/SAPHY-43-Social-Login

hotfix

• 서비스 중 긴급히 수정해야 할 사항이 발생할 때 사용합니다.
• main에서 분기됩니다.

🤝 Commit Convention

머릿말	설명
feat	새로운 기능 추가
fix	버그 수정
design	CSS 등 사용자 UI 디자인 변경
!BREAKING CHANGE	커다란 API 변경의 경우
!HOTFIX	코드 포맷 변경, 세미 콜론 누락, 코드 수정이 없는 경우
refactor	프로덕션 코드 리팩토링업
comment	필요한 주석 추가 및 변경
docs	문서 수정
test	테스트 추가, 테스트 리팩토링(프로덕션 코드 변경 X)
setting	패키지 설치, 개발 설정
chore	빌드 테스트 업데이트, 패키지 매니저를 설정하는 경우(프로덕션 코드 변경 X)
rename	파일 혹은 폴더명을 수정하거나 옮기는 작업만인 경우
remove	파일을 삭제하는 작업만 수행한 경우

Commit Convention Detail

• <타입>: <제목> (<이슈번호>) 의 형식으로 제목을 아래 공백줄에 작성
• 제목은 50자 이내 / 변경사항이 "무엇"인지 명확히 작성 / 끝에 마침표 금지
• 예) SAPHY-43 Feat: 로그인 기능 구현
• 본문(구체적인 내용)을 아랫줄에 작성
• 여러 줄의 메시지를 작성할 땐 "*"로 구분 (한 줄은 72자 이내)
• 제목과 본문은 한 줄 띄워 분리