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

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

---

## 1. 브랜치 아키텍처 개요

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

```text
[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. 베이스 브랜치 생성 및 다음 단계 작업
이전 단계 브랜치에서 다음 단계 브랜치를 생성하여 연속적인 누적 개발을 진행합니다.

```bash
# 예시: 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. 다음 기능 브랜치로 계속 체인 작업 시
```bash
# 예시: 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. 로그인 인터셉터 및 세션 처리 추가`