🔹 1. 이슈(Ticket) 생성 및 관리 방법

이제 프로젝트에서 해야 할 일을 정리해보자!

프로젝트 안에서 [이슈 생성] 클릭
이슈 유형 선택
- Task(작업): 일반적인 할 일
- Bug(버그): 문제점 기록
- Story(스토리): 기능 개발 관련
이슈 제목 & 설명 작성 (예: "API 개발", "회의 일정")
우선순위(Priority) 설정
담당자(Assignee) 설정 (개인 프로젝트라면 본인 선택)
저장 후 보드에서 진행 상태 변경 가능

🔹 2. 일정 관리 기능

일정이 많다면 달력(Calendar) 플러그인 추가
Due Date(마감일) 설정해서 일정 관리
반복되는 일정은 에픽(Epic) + 서브태스크(Sub-task) 사용

✅ 요약 정리

✔ 팀 프로젝트 → 여러 명이 함께 진행, Kanban or Scrum 선택

✔ 이슈 관리 → Task 생성, 우선순위 & 담당자 설정

✔ 일정 관리 → 마감일(Due Date) + 달력 플러그인 활용

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

📌 이슈 구조

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

✅ 설계 방식

에픽(Epic) → 팀원별 기능 (예: "회원 관리 기능 개발")
스토리(Story) → 각 도메인 기능 (예: "회원 가입")
작업(Task) → 해당 기능에서 필요한 작업 (예: "회원 정보 저장")
하위 작업(Sub-task) → 세부 내용 (예: "DB 스키마 설계")

🔹 예시 (회원 관리 도메인)

arduino
복사편집
📌 에픽: "회원 관리 기능 개발" (담당: 홍길동)
    ├─ 📌 스토리: "회원 가입" (담당: 홍길동)
    │    ├─ 📌 작업: "회원 정보 저장 기능 개발" (담당: 홍길동)
    │    │    ├─ 📌 하위 작업: "DB 스키마 설계"
    │    │    ├─ 📌 하위 작업: "API 개발"
    │    │    ├─ 📌 하위 작업: "테스트 코드 작성"
    ├─ 📌 스토리: "회원 탈퇴" (담당: 홍길동)

💡 이렇게 하면 팀원들이 각 도메인 기능을 독립적으로 작업하면서도, 큰 흐름(에픽)에서 작업을 추적하기 쉬워져!

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

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

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

🔹 예시

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

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

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

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

GitHub Actions 또는 Webhook을 사용하면,

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

🔹 GitHub Actions 설정 방법

GitHub에서 .github/workflows/jira.yml 파일 생성
아래 코드를 추가하고 저장

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"

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

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

📌 (1) 워크플로란?

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

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

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

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

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

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

✅ JIRA에서 워크플로 설정 방법

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

📌 (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 활용

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

🔹 1**. 이슈(Ticket) 생성 및 관리 방법**

🔹 2**. 일정 관리 기능**