Initial deployment setup

apps/docs/docs/01-user-guide/05-issue-management.md

@@ -0,0 +1,314 @@
+---
+title: 이슈
+description: ABC User Feedback에서 이슈를 생성, 관리하고 칸반/리스트 뷰로 효율적으로 추적하는 방법을 설명합니다.
+sidebar_position: 5
+---
+
+# 이슈
+
+**이슈(Issue)** 는 피드백에서 발견된 문제점이나 개선사항을 체계적으로 관리하기 위한 핵심 기능입니다. 이슈 생성부터 카테고리 관리, 다양한 뷰 모드 활용까지 이슈 관리의 모든 기능을 다룹니다.
+
+![issue](/img/issue/1.png)
+
+---
+
+## 이슈 개요
+
+### 이슈의 역할
+
+이슈는 다음 목적으로 사용됩니다:
+
+- **문제 추적**: 버그, 오류, 성능 문제 등을 체계적으로 관리
+- **기능 요청 관리**: 사용자 요청사항을 구조화하여 개발 계획에 반영
+- **개선사항 도출**: 피드백 분석을 통한 개선 포인트 식별
+
+### 이슈 상태
+
+각 이슈는 다음 상태를 가집니다:
+
+| 상태            | 설명        | 사용 시점                |
+| --------------- | ----------- | ------------------------ |
+| **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](/img/issue/2.png)
+
+### 칸반뷰 접근
+
+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. 원하는 카테고리를 선택합니다
+
+---
+
+## 관련 문서
+
+- [피드백 관리](./04-feedback-management.md) - 피드백에서 이슈 생성 및 연결 방법
+- [이슈 트래커 연동](/docs/01-user-guide/07-settings/03-issue-tracker-management.md) - 외부 도구와의 연동 설정
+- [프로젝트 관리](./02-project-management.md) - 팀 구성 및 권한 관리