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

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

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

브랜치/커밋/PR WorkFlow

Overview

• Epic : 프로젝트의 상위 목표
  • 예: [Epic] 기사 데이터 크롤링 자동화
• Task/Story : Epic을 달성하기 위한 구체적 업무
  • 예: ON-43 기사 본문 크롤링 기능 구현
• 이슈 키(Jira Issue Key)
  • Jira에서 자동 생성 (ON-xx)
  • 브랜치 / 커밋 / PR 모두 이 키를 포함해서 추적 가능하게 해요
• 상태 흐름
  • To Do → In Progress → Code Review → Done
  • PR 머지 시 상태가 자동으로 업데이트돼요

예시

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

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

주의사항

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