저희 프로젝트에서는 Epic → Story/Task 구조를 중심으로 이슈를 관리해요

Epic은 프로젝트의 큰 목표를, Task는 그 목표를 이루기 위한 구체적인 업무 단위를 뜻해요 ✨

모든 개발 흐름은 Jira 이슈를 출발점으로 하고, GitHub 브랜치/커밋/PR은 이를 그대로 따라갑니다.

브랜치 → 커밋/PR WorkFlow

Overview

• Epic : 프로젝트의 상위 목표
  • 예: [Epic] IPA 기반 영어 발음 분석 및 시각화 서비스 구현
• Story : 사용자 중심 ("무엇을, 왜?") / 비즈니스적인 목표, 기능의 단위
  • 예: S14P21B101-01 사용자는 다른 사용자에게 이체할 수 있다.
• Task: 개발자 중심 ("어떻게?") / 기술적인 작업, 구현의 단계
  • 예: S14P11B104-02 [BE] 이체 API 구현
• 이슈 키(Jira Issue Key)
  • Jira에서 자동 생성 (S14P11B104-xx)
  • 브랜치 / 커밋 / PR 모두 이 키를 포함해서 추적 가능하게 해요
• 상태 흐름
  • To Do → In Progress → Code Review → Done
  • PR 머지 시 상태가 자동으로 업데이트돼요

예시

• Epic: [Epic] 이미지 처리 파이프라인 구축
  • Task: S14P11B104-01 이미지 업로드 기능 추가
  • Task: S14P11B104-02 업로드 이미지 리사이즈 기능 구현

→ 각 Task는 GitHub 브랜치/커밋/PR에 S14P11B104-01, S14P11B104-02 키를 포함시켜 추적해요.

주의사항

• Epic 없이 Task를 생성하지 않아요 (모든 Task는 반드시 Epic에 귀속).
• Task 제목은 동사 + 목적으로 작성해요.
  • 예: 데이터베이스 연결 설정, 로그인 API 구현
• 진행 중인 Task는 담당자(Assignee)를 반드시 지정해요.
• Epic 종료는 모든 Task가 Done일 때만 가능해요.