イシュー CatQuest ガイド

プロジェクトの giip イシューを可愛い猫キャラクターで可視化し、各イシューの進捗をひと目で楽しく把握できる画面です。

🐾 CatQuest ページへ移動 →

📋 概要

イシュー CatQuest は、現在選択中のプロジェクト(csn)に属する giip イシューを 猫キャラクターのカード で表示する画面です。各イシューは1枚のカードで表現され、イシューの状態(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. ページネーション

1ページに30件ずつ表示し、イシューが多い場合は下部のページ移動ボタン(« ‹ 1 2 3 › »)でめくります。

💡 注意事項

• このページは 管理者画面 です。アクセス権限（メニュー設定 tMenuConfig の最小レベル）に応じて表示されます。
• プロジェクトが選択されていない場合は "No Project Selected" と表示されます。上部ナビゲーションからプロジェクトを選択してください。
• イシュー一覧の取得にはログイン（認証トークン、AK）が必要です。セッションが切れたら再ログインしてください。
• アクセシビリティ: システムで「視差効果を減らす(prefers-reduced-motion)」が有効な場合、ジャンプのような大きな動きは、穏やかな呼吸アニメーションに置き換えられます。

🔌 API でデータを扱う

CatQuest は giip イシュー一覧 API(giipIssues)を読み取って画面を描画します。イシューをプログラムで取得・登録・状態変更する方法は下記のドキュメントを参照してください。

📘 CatQuest データ API リファレンス →

トラブルシューティング

症状	原因	解決
"No Project Selected" のみ表示	プロジェクト(csn)が未指定	上部からプロジェクトを選択します。
猫が1匹もいない(😿)	そのプロジェクトにイシューが無い	新規イシューを登録するか別のプロジェクトを選択します。
"Unauthorized" / 401 エラー	セッション切れ、または未ログイン	再ログイン後 Refresh を押します。
上部ガイドボタン(📖)が見えない	ガイドマッピングの欠落（旧バージョン）	本ガイドの反映後に正常表示されます。

---

バージョン: 1.0 最終更新: 2026-07-24 ソースファイル: giipv3/public/help/catquest.ja.md