Files
egbim_qa_platform/apps/docs/docs/01-user-guide/05-issue-management.md
T
root 33453ecc55
Deploy staging / deploy (push) Failing after 6s
Initial deployment setup
2026-08-31 16:45:24 +09:00

12 KiB

title, description, sidebar_position
title description sidebar_position
이슈 ABC User Feedback에서 이슈를 생성, 관리하고 칸반/리스트 뷰로 효율적으로 추적하는 방법을 설명합니다. 5

이슈

이슈(Issue) 는 피드백에서 발견된 문제점이나 개선사항을 체계적으로 관리하기 위한 핵심 기능입니다. 이슈 생성부터 카테고리 관리, 다양한 뷰 모드 활용까지 이슈 관리의 모든 기능을 다룹니다.

issue


이슈 개요

이슈의 역할

이슈는 다음 목적으로 사용됩니다:

  • 문제 추적: 버그, 오류, 성능 문제 등을 체계적으로 관리
  • 기능 요청 관리: 사용자 요청사항을 구조화하여 개발 계획에 반영
  • 개선사항 도출: 피드백 분석을 통한 개선 포인트 식별

이슈 상태

각 이슈는 다음 상태를 가집니다:

상태 설명 사용 시점
New 새로 등록됨 이슈 최초 생성
On Review 검토 중 담당자가 검토 시작
In Progress 처리 중 실제 작업 진행 중
Resolved 해결 완료 문제 해결 및 완료
On Hold 일시 보류 추가 정보 대기 또는 연기

이슈 생성/수정/삭제

이슈 생성 방법

이슈는 두 가지 방법으로 생성할 수 있습니다.

1. 피드백에서 이슈 생성 (권장)

가장 일반적인 방법으로, 특정 피드백을 기반으로 이슈를 생성합니다.

  1. Feedback 탭에서 피드백을 클릭하여 상세 보기를 엽니다
  2. 우측 상세 패널의 Issue 섹션에서 + 버튼을 클릭합니다
  3. 이슈 이름을 입력하고 Enter 키를 누르거나 Create 옵션을 클릭합니다

2. 이슈 목록에서 직접 생성

  1. 상단 메뉴에서 Issue 탭을 클릭합니다
  2. 좌측 상단의 + Create Issue 버튼을 클릭합니다
  3. 이슈 생성 대화상자에서 정보를 입력합니다:
항목 설명 필수 여부 예시
Title 이슈 제목 필수 로그인 버튼 오작동
Description 상세 설명 선택 특정 브라우저에서 발생
Category 이슈 분류 선택 버그
Status 초기 상태 (기본값: New) 선택 New

이슈 수정

생성된 이슈의 정보를 수정할 수 있습니다.

수정 방법

  1. 이슈 목록에서 수정하려는 이슈를 클릭합니다
  2. 우측에 열리는 Issue Details 패널에서 Edit 버튼을 클릭합니다
  3. 편집 모드에서 다음 항목들을 수정할 수 있습니다:

수정 가능한 항목

항목 수정 가능 여부 설명
Title 가능 이슈 제목
Description 가능 상세 설명
Category 가능 이슈 분류 (드롭다운에서 선택)
Status 가능 현재 진행 상태
Ticket 가능 외부 이슈 트래커 티켓 번호
ID 불가능 시스템 자동 생성
Created 불가능 생성 일시

저장 및 취소

  • Save 버튼: 변경사항을 저장하고 수정 모드를 종료합니다
  • Cancel 버튼: 변경사항을 취소하고 원래 상태로 되돌립니다

외부 이슈 트래커 연동

외부 이슈 트래커(Jira 등)와 연동이 설정되어 있는 경우, 이슈에 외부 티켓을 연결할 수 있습니다.

티켓 연결 방법

  1. 이슈 상세 패널에서 Ticket 필드에 외부 티켓 번호를 입력합니다
  2. 입력된 번호는 자동으로 외부 시스템 링크로 변환됩니다

참고: 외부 이슈 트래커 연동은 Settings > Issue Tracker Management에서 사전 설정이 필요합니다.

이슈 삭제

더 이상 필요하지 않은 이슈를 삭제할 수 있습니다.

삭제 방법

  1. 이슈 상세 패널에서 Delete 버튼을 클릭합니다

  2. 확인 대화상자에서 삭제를 승인합니다

삭제 시 주의사항

  • 복구 불가능: 삭제된 이슈는 되돌릴 수 없습니다
  • 피드백 연결 해제: 연결된 피드백들의 이슈 링크가 제거됩니다
  • 통계 영향: 대시보드 이슈 통계에서 해당 데이터가 제외됩니다

칸반뷰

칸반뷰는 이슈들을 상태별 열로 구분하여 시각적으로 관리할 수 있는 보기 방식입니다.

issue-kanban

칸반뷰 접근

  1. 상단 메뉴에서 Issue 탭을 클릭합니다
  2. 우측 상단에서 Kanban 뷰를 선택합니다

칸반 보드 구성

각 상태별로 열이 구성되어 있으며, 이슈들이 카드 형태로 표시됩니다.

칸반 열 구성

표시 정보 카드 개수 표시
New 새로 등록된 이슈들 상단에 숫자
On Review 검토 중인 이슈들 상단에 숫자
In Progress 진행 중인 이슈들 상단에 숫자
Resolved 해결 완료된 이슈들 상단에 숫자
On Hold 보류된 이슈들 상단에 숫자

이슈 카드 정보

각 이슈 카드에는 다음 정보가 표시됩니다:

  • 이슈 제목: 클릭 시 상세 보기로 이동
  • 피드백 수: 연결된 피드백 개수 (📝 아이콘과 함께)
  • 카테고리: 설정된 경우 하단에 표시
  • 외부 티켓: 연결된 경우 티켓 번호 표시

드래그 앤 드롭 상태 변경

칸반뷰의 핵심 기능으로, 이슈 카드를 드래그하여 다른 열로 이동시켜 상태를 변경할 수 있습니다.

사용 방법

  1. 이슈 카드를 마우스로 클릭하고 드래그합니다
  2. 원하는 상태 열 위로 이동시킵니다
  3. 마우스를 놓으면 상태가 자동으로 변경됩니다

칸반뷰 필터링

상단의 필터 기능을 사용하여 특정 조건의 이슈만 표시할 수 있습니다.

사용 가능한 필터

  1. Date 필터: 특정 기간에 생성된 이슈만 표시
  2. Filter 버튼: 고급 필터 조건 설정

필터 조건 예시

필터 유형 조건 예시 사용 사례
Category Category = "버그" 버그 이슈만 확인
Title Title contains "로그인" 로그인 관련 이슈 찾기
Created Created >= 2024-03-01 특정 날짜 이후 생성된 이슈
Status Status != "Resolved" 미해결 이슈만 표시

칸반뷰 정렬

각 열 내에서 이슈 카드의 정렬 순서를 변경할 수 있습니다.

정렬 옵션

  • Created Date ↓: 최신 생성 순
  • Created Date ↑: 오래된 순
  • Feedback Count ↓: 연결된 피드백 수 많은 순

리스트뷰

리스트뷰는 이슈들을 카테고리별로 그룹화하여 테이블 형태로 표시하는 보기 방식입니다.

리스트뷰 접근

  1. 상단 메뉴에서 Issue 탭을 클릭합니다
  2. 우측 상단에서 List 뷰를 선택합니다

리스트뷰 구성

카테고리별로 그룹화된 이슈들이 계층적으로 표시됩니다.

카테고리 그룹

각 카테고리는 접힘/펼침이 가능한 그룹으로 표시됩니다:

  • 그룹 헤더: 카테고리 이름과 포함된 이슈 수
  • 접힘/펼침 화살표: 그룹 내용 표시/숨김 토글
  • "No Category": 카테고리가 지정되지 않은 이슈들

리스트뷰 필터링

칸반뷰와 동일한 필터 기능을 제공합니다.

필터 적용 방법

  1. 상단의 Date 또는 Filter 버튼을 클릭합니다
  2. 원하는 조건을 설정합니다
  3. 필터링된 결과가 카테고리별로 그룹화되어 표시됩니다

빈 카테고리 처리

필터링 결과 이슈가 없는 카테고리는 자동으로 숨겨집니다.

리스트뷰 정렬

각 컬럼 헤더를 클릭하여 정렬할 수 있습니다.

정렬 동작

  • 첫 번째 클릭: 오름차순 정렬 ↑
  • 두 번째 클릭: 내림차순 정렬 ↓

각 정렬 내용

정렬 기준 사용 사례
Created ↓ 최신 이슈부터 확인
Feedback Count ↓ 영향도가 큰 이슈 우선 처리
Status 상태별로 그룹화하여 확인

이슈 카테고리

이슈 카테고리는 이슈를 분류하여 체계적으로 관리할 수 있게 해주는 기능입니다.

카테고리의 목적

  • 이슈 분류: 버그, 기능 요청, 개선 사항 등으로 구분
  • 분석 용이성: 카테고리별 이슈 발생 패턴 분석

기본 카테고리 예시

일반적으로 사용되는 카테고리 분류:

카테고리 설명 우선순위 담당팀 예시
버그 기능 오작동, 오류 높음 개발팀
기능 요청 새로운 기능 추가 요청 중간 기획팀
개선 사항 기존 기능 향상 중간 UX팀
성능 속도, 안정성 문제 높음 인프라팀
UI/UX 사용자 인터페이스 문제 낮음 디자인팀
문서 도움말, 가이드 관련 낮음 기술문서팀

카테고리 관리

카테고리 추가

이슈 상세 패널에서 새로운 카테고리를 추가할 수 있습니다:

  1. 이슈 상세 패널의 Category 필드에서 Add 버튼을 클릭합니다
  2. 새 카테고리 이름을 입력합니다
  3. Enter 키를 누르거나 확인 버튼을 클릭합니다

카테고리 할당

기존 이슈에 카테고리를 할당하거나 변경할 수 있습니다:

  1. 이슈 상세 패널에서 Edit 버튼을 클릭합니다
  2. Category 드롭다운에서 원하는 카테고리를 선택합니다
  3. Save 버튼으로 변경사항을 저장합니다

카테고리별 이슈 관리

리스트뷰에서 카테고리별 확인

리스트뷰에서는 카테고리별로 그룹화된 이슈들을 한눈에 확인할 수 있습니다:

  • 카테고리별 이슈 수: 각 그룹 헤더에 포함된 이슈 개수 표시
  • 그룹 접힘/펼침: 필요한 카테고리만 선택적으로 확인
  • "No Category" 그룹: 미분류 이슈들의 별도 관리

카테고리별 필터링

특정 카테고리의 이슈만 확인하고 싶을 때:

  1. Filter 버튼을 클릭합니다
  2. Category 조건을 추가합니다
  3. 원하는 카테고리를 선택합니다

관련 문서