이슈 CatQuest 가이드
프로젝트의 giip 이슈를 귀여운 고양이 캐릭터로 시각화해, 이슈의 진행 상태를 한눈에 즐겁게 파악하는 화면입니다.
📋 개요
이슈 CatQuest는 현재 선택된 프로젝트(csn)에 속한 giip 이슈들을 고양이 캐릭터 카드로 보여주는 화면입니다. 각 이슈는 카드 한 장으로 표현되며, 이슈의 상태(status)에 따라 고양이의 **행동(애니메이션)**이 달라집니다. 딱딱한 목록 대신 재미있게 진행 상황을 훑어볼 수 있도록 만든 뷰이며, 데이터 자체는 기존 이슈 관리(클래식 목록)와 동일합니다.
🐱 상태에 따른 고양이 행동
이슈의 상태 값에 따라 각 카드의 고양이가 다르게 움직입니다.
| 이슈 상태 | 고양이 행동 | 의미 |
|---|---|---|
| PENDING | 놀고 있음 (playing) | 아직 착수 전, 대기 중인 이슈 |
| READY | 사냥 준비 (ready) | 곧 시작할 준비가 된 이슈 |
| IN_PROGRESS | 사냥 중 (hunting) | 현재 처리 중인 이슈 |
| REVIEW | 먹이 물고 대기 (delivering) | 검토 대기 중인 이슈 |
| DONE | 놀고 있음 (playing) | 완료된 이슈 |
- 같은 이슈에는 항상 같은 고양이(8종: mochi·sherlock·nimbus·pixel·cocoa·midnight·luna·leo)가 배정됩니다.
- 배경 색상도 상태별 파스텔 톤으로 구분됩니다.
🔍 화면 구성
1. 상단 헤더
- 📋 클래식 목록: 동일한 이슈를 표 형태의 기본 목록(giip-issues) 화면으로 봅니다.
- Refresh: 이슈 목록을 다시 불러옵니다.
- + New Issue: 새 이슈를 등록하는 화면으로 이동합니다.
2. 요약 배지
현재 프로젝트의 진행 중(Active) 이슈 수와 완료(Done) 이슈 수를 배지로 표시합니다. 진행 중 이슈가 먼저, 완료 이슈가 뒤에 정렬됩니다.
3. 고양이 카드
각 카드는 다음 정보를 담습니다.
- 이슈 제목(말풍선), 상태 배지, 이슈 번호(#isn)
- 대기 배지(⏳ #번호): 다른 이슈 때문에 대기 중이면 표시되며, 클릭하면 그 원인(점유) 이슈 상세로 이동합니다.
- 등록 일시(🐣), 최종 코멘트 일시(💬), 요약
- 카드를 클릭하면 해당 이슈 상세 화면으로 이동합니다.
4. 페이지네이션
한 페이지에 30개씩 표시하며, 이슈가 많으면 하단의 페이지 이동 버튼(« ‹ 1 2 3 › »)으로 넘겨봅니다.
💡 유의 사항
- 이 페이지는 관리자 화면입니다. 접근 권한(메뉴 설정
tMenuConfig의 최소 레벨)에 따라 노출됩니다. - 프로젝트가 선택되지 않으면 "No Project Selected" 안내가 표시됩니다. 상단 내비게이션에서 프로젝트를 선택하세요.
- 이슈 목록 조회에는 로그인(인증 토큰, AK)이 필요합니다. 세션이 만료되면 다시 로그인하세요.
- 접근성: 시스템에서 "동작 줄이기(prefers-reduced-motion)"를 켠 경우, 점프 같은 큰 움직임 대신 은은한 숨쉬기 애니메이션으로 대체됩니다.
🔌 API로 데이터 다루기
CatQuest는 giip 이슈 목록 API(giipIssues)를 읽어 화면을 그립니다. 이슈를 프로그램으로 조회·등록·상태변경하는 방법은 아래 문서를 참조하세요.
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| "No Project Selected"만 표시됨 | 프로젝트(csn)가 지정되지 않음 | 상단에서 프로젝트를 선택합니다. |
| 고양이가 한 마리도 없음(😿) | 해당 프로젝트에 이슈가 없음 | 새 이슈를 등록하거나 다른 프로젝트를 선택합니다. |
| "Unauthorized" / 401 오류 | 세션 만료 또는 미로그인 | 다시 로그인 후 Refresh를 누릅니다. |
| 상단 가이드 버튼(📖)이 안 보임 | 가이드 매핑 누락(구버전) | 이 가이드 반영 후 정상 노출됩니다. |
버전: 1.0
최종 업데이트: 2026-07-24
소스 파일: giipv3/public/help/catquest.ko.md