이슈 CatQuest 가이드

프로젝트의 giip 이슈를 귀여운 고양이 캐릭터로 시각화해, 이슈의 진행 상태를 한눈에 즐겁게 파악하는 화면입니다.

🐾 CatQuest 페이지로 이동 →

📋 개요

이슈 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)를 읽어 화면을 그립니다. 이슈를 프로그램으로 조회·등록·상태변경하는 방법은 아래 문서를 참조하세요.

📘 CatQuest 데이터 API 레퍼런스 →

문제 해결

증상	원인	해결
"No Project Selected"만 표시됨	프로젝트(csn)가 지정되지 않음	상단에서 프로젝트를 선택합니다.
고양이가 한 마리도 없음(😿)	해당 프로젝트에 이슈가 없음	새 이슈를 등록하거나 다른 프로젝트를 선택합니다.
"Unauthorized" / 401 오류	세션 만료 또는 미로그인	다시 로그인 후 Refresh를 누릅니다.
상단 가이드 버튼(📖)이 안 보임	가이드 매핑 누락(구버전)	이 가이드 반영 후 정상 노출됩니다.

---

버전: 1.0 최종 업데이트: 2026-07-24 소스 파일: giipv3/public/help/catquest.ko.md