Issue CatQuest Guide
Visualize your project's giip issues as cute cat characters, so you can grasp each issue's progress at a glance — and have a bit of fun doing it.
📋 Overview
Issue CatQuest displays the giip issues that belong to the currently selected project (csn) as cat character cards. Each issue is shown as a single card, and the cat's behavior (animation) changes according to the issue's status. It's a playful view for skimming progress instead of a plain table — the underlying data is identical to the classic issue list.
🐱 Cat behavior by status
Each card's cat moves differently depending on the issue's status value.
| Issue status | Cat behavior | Meaning |
|---|---|---|
| PENDING | playing | Not started yet, waiting |
| READY | ready (crouched to pounce) | Ready to begin soon |
| IN_PROGRESS | hunting | Currently being worked on |
| REVIEW | delivering (prey in mouth) | Waiting for review |
| DONE | playing | Completed |
- The same issue always gets the same cat (8 types: mochi, sherlock, nimbus, pixel, cocoa, midnight, luna, leo).
- The scene background color is also pastel-coded by status.
🔍 Screen layout
1. Top header
- 📋 Classic list: View the same issues in the standard table list (giip-issues).
- Refresh: Reload the issue list.
- + New Issue: Go to the new-issue registration screen.
2. Summary badges
Shows the count of Active issues and Done issues in the current project. Active issues are sorted first, done issues last.
3. Cat cards
Each card contains:
- Issue title (speech bubble), status badge, issue number (#isn)
- Blocked-by badge (⏳ #number): Shown when the issue is waiting on another issue; click it to jump to the blocking issue's detail.
- Registered date (🐣), last comment date (💬), summary
- Click a card to open the issue detail screen.
4. Pagination
30 items per page; when there are many issues, use the bottom navigation buttons (« ‹ 1 2 3 › ») to page through them.
💡 Notes
- This is an admin screen. Visibility depends on access level (the minimum level in
tMenuConfig). - If no project is selected, a "No Project Selected" message appears. Select a project from the top navigation.
- Loading the issue list requires login (an auth token, AK). If the session expires, log in again.
- Accessibility: If your system has "reduce motion" (prefers-reduced-motion) enabled, large movements like the pounce are replaced by a gentle breathing animation.
🔌 Working with the data via API
CatQuest renders by reading the giip issue-list API (giipIssues). For how to query, create, and change the status of issues programmatically, see the document below.
Troubleshooting
| Symptom | Cause | Resolution |
|---|---|---|
| Only "No Project Selected" shows | No project (csn) selected | Select a project from the top. |
| No cats at all (😿) | The project has no issues | Register a new issue or pick another project. |
| "Unauthorized" / 401 error | Session expired or not logged in | Log in again and press Refresh. |
| Top guide button (📖) not visible | Guide mapping missing (older version) | It appears once this guide is deployed. |
Version: 1.0
Last updated: 2026-07-24
Source file: giipv3/public/help/catquest.en.md