Branch 전략

• Main 사용자에게 배포되는 최종 브랜치
• Develop 다음 버전을 위한 개발 브랜치 (팀원들이 각자 만든 기능 합치는 중심 브랜치)
• Feat 새로운 기능을 개발하는 브랜치 (기능 완료 시 Develop으로 Merge)
  • ex) feat/login, feat/home
• Fix 개발 중 발견된 버그를 고치는 작업을 위한 브랜치
  • ex) fix/ui-overlap-issue
• Refactor 결과의 동작은 변하지 않지만, 코드 구조를 개선하거나 가독성을 높이는 작업을 위한 브랜치
  • ex) refactor/rename-variables
• Chore 코드 수정 없이 빌드 설정, 라이브러리 의존성 추가, .gitignore 수정 등 부수적 작업을 위한 브랜치
• Test 테스트 코드 작성을 위한 브랜치
  • ex) text/login-unit-test
• Release 배포 전 최종 버그 수정 및 QA를 진행하는 브랜치
• Hotfix 배포 이후 치명적인 버그가 생겼을 때 Main에서 바로 따서 수정하는 긴급 브랜치

Issue 컨벤션 & 템플릿

제목 컨벤션

// 이슈 제목 
- 형식: [Type] 이슈 제목
- 예시: [Fix] 무한 스크롤 버그 수정

본문 템플릿 1 (Feat)

## 기능 설명
- 

## 세부 작업 내용 
- [ ] 작업1: 
- [ ] 작업2:

## 마감 기한 
- 2026-XX-XX

## 참고 자료 (선택) 
- 관련 링크 첨부

본문 템플릿 2 (Fix)

// 내용(Fix) 
## 에러 발생 상황
-

## 에러 화면(스크린샷)
-

## 예상 결과 vs 실제 결과 
- 예상: 
- 실제:

## 해결 방안(선택사항) 
-

본문 템플릿 3 (Refactor)

// 내용(Refactor)
## 리팩토링 배경(문제 상황)
- (예시1) 같은 색상 코드를 여러 id에서 사용해서 병합할 때 매번 충돌이 일어남
- (예시2) 특정 뷰에 부적절한 단위(dp, sp)가 섞여 있어 기기별 레이아웃 불일치 가능성 있음

## 수정 내용 
- 기존:
- 이후:

PR 컨벤션 & 템플릿

PR 컨벤션

☝️ PR 올린 후 카톡방에 링크 공유하기
✌️ PR 올린 후 다음날까지 리뷰 달고, 그 이후에는 머지 가능

PR 템플릿

// PR 제목 
- [type] 작업 요약 (#이슈번호) 
- 예시: [feat] 로그인 유효성 검사 로직 추가 (#12) 

// PR 본문 
## 📝 작업 내용 
- 여기다가 작업 내용을 써주세요. 

## 🔗 관련 이슈(선택) 
- #이슈번호 → PR이 머지되도 이슈는 닫히지 않음 
- Close #이슈번호 (일반적인 기능 구현) → PR이 머지되면 이슈도 같이 닫힘
- Fix #이슈번호 (버그 수정) → PR이 머지되면 이슈도 같이 닫힘 
- 예시: Fix #25 (버튼 연타로 빠르게 클릭 시 앱 종료 버그)

## 📸 스크린샷 
- 시각화 가능한 기능 구현 부분이 있으면 스크린샷을 같이 첨부해주세요. 

## 💬 요구사항(선택) 
- 팀원 분들이 리뷰 해주길 바라는 특정 부분이 있으면 작성해주세요. 
- 팀원 분들이 확인 해주길 바라는 특정 부분이 있으면 작성해주세요.

## ✅ 체크리스트 
- [ ] 관련 없는 변경사항 삭제 했는가? (불필요한 주석, 로그 등) 
- [ ] 테스트 여부 (Unit Test 등)
- [ ] 커밋 목적에 맞게 유동적으로 추가하기...

PR 리뷰 템플릿

## 피드백 내용
### 좋은 점 
- 

### 아쉬운 점/개선할 점
- [P1/P2/P3] 제목 요약
- 내용: 
- 이유: 
- (키워드 → P1: 꼭 반영해주세요 / P2: 가급적 반영해주세요 / P3: 반영하면 좋지만 아니어도 괜찮아요) 

### 궁금한 점 
-
 
## 총평 
-

Commit 컨벤션

형식

 type(scope): Subject (제목)
 body (본문 - 무엇을, 왜 수정했는지) → 생략 가능
 footer (바닥글 - 이슈 번호 등) → 생략 가능

예시

feat: 소셜 로그인 기능 구현
- 구글 SDK 연동
- 로그인 화면 UI 개발 및 viewmodel 로직 추가
Close #12

유형	의미
feat	새로운 기능 추가
Fix	버그 수정
Docs	문서 수정
Style	코드 formatting, 세미콜론 누락, 코드 자체의 변경이 없는 경우
Refactor	코드 래픽토링
Test	테스트 코드, 리팩토링 테스트 코드 추가
Chore	패키지 매니저 수정, 그 외 기타 수정 ex) .gitignore
Design	XML 파일, style theme 등 사용자 UI 디자인 변경
Comment	필요한 주석 추가 및 변경
Rename	파일 또는 폴더 명을 수정하거나 옮기는 작업만인 경우
Remove	파일을 삭제하는 작업만 수행한 경우
!HOTFIX	급하게 치명적인 버그를 고쳐야 하는 경우

Android Studio 환경 설정

Android Studio 버전

Android Studio Otter | 2025.2.1 Patch 1

SDK 버전

• targetSDK 36
• minSDK 24

테스트 기기

• 실제 디바이스 (안드로이드 폰 소유자)
• 에뮬레이터 (안드로이드 폰 미소유자)