2. 🚀 스프린트 진행

3. 🛠️ 작업 진행 시 (Code)

git commit -m "FP-64 feat:user - crud 구현"

4. 🔔 실시간 알림 (Slack 연동)

5. ✅ 기타 체크사항

1. 이슈 구조 설계 (에픽, 스토리, 작업, 하위 작업 이슈)

📌 이슈 구조

scss
복사편집
📌 에픽(Epic) → 📌 스토리(Story) → 📌 작업(Task) → 📌 하위 작업(Sub-task)

설계 방식


✅ 2**. 이슈와 커밋 연결하는 방법 & 자동화**

📌 (1) 기본적인 연결 방법

커밋 메시지 또는 PR(풀 리퀘스트) 제목에 JIRA 이슈 키를 넣으면 자동 연결됨.

🔹 예시

bash
복사편집
git commit -m "[PROJECT-123] 회원 가입 API 구현"

→ JIRA의 PROJECT-123 이슈에 자동으로 연결됨!

PR 제목에도 이슈 키를 넣으면 자동으로 링크됨.


📌 (2) 자동화 (커밋 & PR 자동 업데이트)

GitHub Actions 또는 Webhook을 사용하면,

JIRA 이슈 상태를 자동으로 변경할 수 있어!

🔹 GitHub Actions 설정 방법

  1. GitHub에서 .github/workflows/jira.yml 파일 생성
  2. 아래 코드를 추가하고 저장
yaml
복사편집
name: Update Jira Issue

on:
  pull_request:
    types: [opened, closed]

jobs:
  update-jira:
    runs-on: ubuntu-latest
    steps:
      - name: Update Jira issue status
        run: |
          curl -X POST -H "Authorization: Bearer ${{ secrets.JIRA_API_TOKEN }}" \\
               -H "Content-Type: application/json" \\
               --data '{"transition": {"id": "31"}}' \\
               "<https://your-jira-instance.atlassian.net/rest/api/2/issue/$>{{ github.event.pull_request.title }}/transitions"

  1. JIRA API 토큰을 GitHub Secrets에 추가
  2. PR이 열리거나 닫힐 때 JIRA 이슈 상태가 자동으로 변경됨!

✅ 3**. 워크플로 (Workflow) 이해하기 & 시각적 구성**

📌 (1) 워크플로란?

워크플로(Workflow) 는 이슈가 진행되는 단계를 설정하는 기능이야.

예를 들어, "해야 할 일 → 진행 중 → 코드 리뷰 → 배포 완료" 이런 식으로 설정 가능!


📌 (2) 좋은 워크플로 예시 (시각적 표현)

🛠️ JIRA에서 커스텀 워크플로 구성 가능!

🔽 아래처럼 설정하면 개발 프로세스를 명확하게 관리할 수 있어!

scss
복사편집
📌 해야 할 일 (To Do) → 📌 진행 중 (In Progress) → 📌 코드 리뷰 (Code Review)
→ 📌 QA 테스트 (QA Testing) → 📌 배포 준비 (Ready for Deploy) → 📌 완료 (Done)

JIRA에서 워크플로 설정 방법

  1. 설정(⚙) → 이슈 워크플로(Workflows) 이동
  2. 기본 워크플로 수정 or 새로운 워크플로 추가
  3. 각 상태(예: 코드 리뷰, QA 테스트)를 추가
  4. 상태 간 전환(Transition) 설정
  5. 저장 후 적용

📌 (3) 실제 워크플로 다이어그램 (시각적 구성)

아래와 같이 JIRA에서 직접 설정할 수 있음!

plaintext
복사편집
[To Do] --> [In Progress] --> [Code Review] --> [QA Testing] --> [Ready for Deploy] --> [Done]

JIRA에서도 이런 식으로 다이어그램을 보여주고, 이슈 상태를 클릭해서 변경 가능!


🎯 최종 요약

GitHub 연동 → JIRA 앱 설치 후 저장소 연결

관리자 권한 → 팀원에게 Admin 역할 부여

이슈 구조 → 에픽(팀원) → 스토리(도메인) → 작업(기능) → 하위 작업(세부 내용)

커밋 자동 연결"[PROJECT-123] 회원 가입 API" 이렇게 작성하면 자동 연결

자동화 → GitHub Actions & Webhook 활용

워크플로 → 진행 상태를 단계별로 설정해서 시각적으로 관리