이 문서는 Otvoo 프로젝트에서 Jira, GitHub, Wiki를 활용한 협업 흐름을 정리한 실전 가이드입니다.

모든 작업은 Jira 티켓 중심으로 흐르고, 브랜치/커밋/PR에는 Jira 티켓 키(KAN-XXX)를 명확히 포함해야 합니다.

🧱 1. Jira 이슈 생성 및 흐름 이해

Jira는 다음과 같은 계층 구조를 따릅니다:

• Epic: 큰 기능 단위 (도메인 이름, 예: 사용자 관리)
• Story: PR 단위의 기능 개발 (예: 로그인 기능 개발)
• Task: 커밋 단위의 세부 작업 (예: 검증 로직, JWT 파싱 등)

⚠️ PR은 보통 Story 티켓 단위로 생성하고, 커밋은 Task 단위로 관리합니다.

🌿 2. 브랜치 전략

2.1 브랜치 네이밍

• 형식: feature/KAN-000-작업요약, bugfix/KAN-000-작업요약 등

  Jira 키(KAN-000)와 작업 요약을 kebab-case로 작성합니다.

2.2 브랜치 생성 기준

2.3 브랜치 생성 명령어 예시

🔹 Story 브랜치 생성 (Epic 하위 기능 작업 시)

git checkout feature/KAN-100-사용자-관리
git pull origin feature/KAN-100-사용자-관리
git checkout -b feature/KAN-111-로그인-기능-개발

✅ Epic 브랜치는 따로 만들지 않고, Story 브랜치는 Dev 브랜치로부터 파생 → Dev 브랜치로 merge