first/BRANCH_GUIDE.md

🌿 Git 브랜치 전략 및 문제별 해답 가이드 매뉴얼

본 문서는 프로젝트의 문제별(기능별) 해답 브랜치 구성, 의존 관계 흐름 및 단계별 Git 작업 절차를 안내하는 매뉴얼입니다.

---

1. 브랜치 아키텍처 개요

• master 브랜치: 00번부터 07번까지 모든 기능이 구현 및 검증 완료된 최종 완성형(Final Release) 브랜치입니다.
• feature/* 브랜치: 초기 환경(feature/00-init)부터 시작하여 각 기능이 하나씩 누적되어 추가되는 **단계별 해답 브랜치(Step-by-Step Solutions)**입니다.

[feature/00-init]           : 초기 베이스 및 기본 공통 환경
        │
        ▼
[feature/01-search]          : 00 + 01. 목록 검색 기능
        │
        ▼
[feature/02-prev-next]       : 01 + 02. 상세글 이전글/다음글 탐색
        │
        ▼
[feature/03-preview-popup]    : 02 + 03. 목록에서 미리보기 팝업
        │
        ▼
[feature/04-multi-delete]     : 03 + 04. 목록에서 다중 삭제
        │
        ▼
[feature/05-login]           : 04 + 05. 로그인 기능
        │
        ▼
[feature/06-user-management] : 05 + 06. 회원 관리 기능
        │
        ▼
[feature/07-message]         : 06 + 07. 쪽지 기능 (완성 단계)
        │
        ▼
     [master]                : 최종 병합 및 완결 상태

---

2. 각 브랜치별 상세 정의

브랜치명	Base 브랜치	주요 구현 내용
feature/00-init	master	프로젝트 초기 설정, 공통 DAO, 기본 게시판 뼈대
feature/01-search	feature/00-init	01. 검색 조건(제목/내용 등) 선택 및 키워드 목록 검색
feature/02-prev-next	feature/01-search	02. 게시글 상세 조회 시 이전글/다음글 번호 및 제목 이동
feature/03-preview-popup	feature/02-prev-next	03. 목록에서 레이어 팝업/모달을 통한 본문 내용 미리보기
feature/04-multi-delete	feature/03-preview-popup	04. 목록 체크박스를 활용한 게시글 다중(일괄) 삭제
feature/05-login	feature/04-multi-delete	05. 사용자 로그인, 인터셉터 기반 세션 인증 처리
feature/06-user-management	feature/05-login	06. 회원가입, 회원 목록 조회, 권한 및 계정 관리
feature/07-message	feature/06-user-management	07. 회원 간 쪽지 발송, 수신함/발신함 조회

---

3. 단계별 브랜치 작업 명령어 가이드

3.1. 베이스 브랜치 생성 및 다음 단계 작업

이전 단계 브랜치에서 다음 단계 브랜치를 생성하여 연속적인 누적 개발을 진행합니다.

# 예시: 00-init 환경에서 01-search 브랜치 파생
git checkout feature/00-init
git checkout -b feature/01-search

# 작업 및 테스트 진행 후 커밋
git add .
git commit -m "01. 목록 검색 기능 구현"

# 원격 저장소 푸시
git push -u origin feature/01-search

3.2. 다음 기능 브랜치로 계속 체인 작업 시

# 예시: 01-search 브랜치에서 02-prev-next 브랜치 파생
git checkout feature/01-search
git checkout -b feature/02-prev-next

# 작업 및 커밋
git add .
git commit -m "02. 상세글 이전글/다음글 탐색 기능 구현"

# 원격 푸시
git push -u origin feature/02-prev-next

---

4. 커밋 메시지 규칙

• 모든 Git 커밋 메시지는 한국어로 작성합니다.
• 예시:
  • 01. 목록 검색 기능 구현
  • 02. 상세글 이전글 다음글 SQL 쿼리 및 UI 추가
  • 05. 로그인 인터셉터 및 세션 처리 추가