Branch Convention

<aside> 📌 Git 컨벤션

</aside>

<aside> 📌 Git 브랜치 전략

1️⃣ GitHub능 형식으로 판다.

2️⃣ 브랜치 역할/#이슈번호-기능 형식으로 판다.

예)Feat/{#issue-number}-{기능}
예) Feat/#1-Login, Feat/#2-Profile

3️⃣ 프로젝트에서 새로운 브랜치에서 작업을 한다.

4️⃣ 해당 이슈 다 작업했다면 Pull Request 날린다

</aside>

<aside> 📌 Git Merge 전략

1️⃣ 코드 리뷰 반영 후 커밋한다.

2️⃣ origin/dev → 기능개발브랜치 로 pull 받는다.

Conflict 난다면 해당 관련자들과 함께 해결 후 [Conflict] 해결 커밋한다.
이때 다른 사람이 이슈를 올린 경우, 그 이슈 해결 이전에는 pr을 하지 않는다.

3️⃣ origin/기능개발브랜치 로 push 한다.

이때 코드 충돌 발생시, 메인 담당자와 협의 후 수정 이후 Merge 한다.

4️⃣ origin/기능개발브랜치 코드 문제가 없는 경우 origin/기능개발브랜치 → origin/dev으로 Merge 한다.

</aside>

<aside> 📌 Git 브랜치

항시 유지되는 메인 브랜치
- main, dev
merge 되면 사라지는 보조 브랜치
- feature, release, hotfix
- 보조 브랜치는 새로 변경될 개발 코드를 분리하고 각각 보존하는 역할
- 기능을 다 완성할 때까지 유지하고, 다 완성되면 develop 브랜치로 merge하고 결과가 좋지 못한 기능의 경우 버리는 방향으로 취한다.
- 보조 브랜치는 보통 개발자 저장소에만 있는 브랜치이고, origin에는 push하고 머지 후에 해당 브랜치는 삭제한다.
Main(master) : 출시, 배포 되는 브랜치→ 배포 가능한 상태만 관리
Dev : 배포 버전을 대비하여 개발하는 브랜치 → 배포할 것을 개발
Feat : 각 기능 개발을 위한 브랜치, develop에서 source 따옴
Release : 다음 버전 배포를 준비하는 브랜치
- develop 브랜치를 release 브랜치로 옮긴 후 QA, 테스트를 진행하고 main으로 합침
- 배포를 위한 최종적인 버그 수정 등의 개발을 수행하는 브랜치
- 배포 가능한 상태가 되면 main 브랜치로 병합, 배포된 main 브랜치에 버전 태그(ex, v1.0)를 추가한다.
- 배포 완료 후 develop 브랜치에도 merge 작업 수행
Bug : 버그 발생 시 일반적으로 사용하는 브랜치
Hotfix : 발생한 버그를 급하게 수정하는 브랜치
- 배포한 버전에서 긴급하게 수정할 필요가 있을 때 main 브랜치에서 분리하는 브랜치
Backup : 백업 </aside>

Pull Request Template

# 작업 내용

- 변경한 기능 요약

# 추가 요청사항

- 리뷰어에게 요청사항이 있다면 작성

# 체크리스트

- [ ] 커밋 컨벤션 준수
- [ ] 로컬 환경에서 동작 확인 완료

# 연관된 이슈

- 예: Closes #1, Fixes #2

Feature Request Template

---
name: Feature Request
about: Suggest a new feature
title: '[Feature] 제목'
labels: enhancement
assignees: ''
---

## 설명

어떤 기능을 추가하고 싶은지 간략히 설명해주세요.

## 작업 내용

- [ ] 작업 1
- [ ] 작업 2

Bug template

---
name: 버그 리포트
about: 오류나 예기치 않은 동작을 보고합니다.
title: "[BUG] "
labels: bug
assignees: ''

---

## 버그 설명
어떤 문제가 발생했는지 명확하고 간결하게 설명해주세요.

## 재현 절차
버그가 어떻게 발생했는지 단계별로 상세히 작성해주세요:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. 오류 발생

## 스크린샷
가능하다면 스크린샷을 첨부해주세요. (이미지 첨부 또는 드래그)

## 실행 환경
- OS: [예: Windows 11, macOS Ventura]
- 브라우저: [예: Chrome 114, Safari 16.5]
- 개발환경: [예: VSCode, IntelliJ, Postman 등]

## 추가 정보
관련 로그, 콘솔 에러, 참고자료 등 추가로 공유할 내용이 있다면 작성해주세요.