3分で読了

이슈管理ガイド

GIIP内部エージェントワーカー（GIIP CSN 47など）が処理するインシデントの作成・閲覧・状態管理のための運用者向けガイドです。

🔧 이슈管理ページへ →

📋 概要

이슈 관리 메뉴는 GIIP 플랫폼 내부 에이전트 워커가 처리할 작업을 등록하고 진행 상황을 추적하는 운영 도구입니다. CSN(고객/서비스 번호)별로 이슈를 분리하여 관리하며, 각 이슈는 PENDING → READY → IN_PROGRESS → REVIEW → DONE 상태 전이를 거칩니다.

🎯 ページ별 역할

ページ	パス	主要操作
一覧	`/admin/giip-issues`	이슈 목록 조회, 필터링(Active/Done), 프로젝트 전환
詳細	`/admin/giip-issues/[isn]`	이슈 내용 확인, 상태 업데이트, 코멘트 작성, Dispatch
作成	`/admin/giip-issues/new`	새 이슈 등록 (제목, 내용, 상태, 대상 서버 선택)
編集	`/admin/giip-issues/[isn]/edit`	기존 이슈의 제목·내용·상태 수정

🛠️ 主要ワークフロー

1. 新規 이슈 등록

プロジェクト(CSN) 선택 — 상단 네비게이션에서 CSN을 먼저 선택합니다.
새 이슈 버튼 클릭
제목, 내용, 초기 상태(PENDING/READY), 필요 시 대상 서버(lssn) 입력
Agent Readinessが必要이면 체크리스트 확인 후 제출

2. 이슈 상태 관리

READY: 에이전트 처리를 기다리는 상태. MinAgeMinutes=60 이상 경과 후 IN_PROGRESS로 전이 가능
IN_PROGRESS: 에이전트가 작업 중인 상태
REVIEW: 에이전트 처리를 완료하고 검증 대기 상태
DONE: 처리 완료

3. コメント作成

詳細ページ下部에서 이슈 진행 상황, 판단 근거, 작업 결과를 코멘트로 기록할 수 있습니다.

🔗 関連ガイド

이슈 管理のAPI連携 및エンドユーザー使用法については、次を参照:

📘 이슈 관리 API リファレンス → 👤 이슈 관리 エンドユーザーガイド →

💡 注意事項

CSN을 먼저 선택하지 않으면 이슈 목록이 표시되지 않습니다.
쓰기 페이지(new/edit)는 최소 레벨 70(관리자) 이상만 접근 가능합니다.
상태 전이는 올바른 순서(PENDING → READY → IN_PROGRESS → REVIEW → DONE)를 따라야 합니다.

トラブルシューティング

증상	원인	해결
이슈 목록이 비어 있음	CSN이 선택되지 않음	상단 네비게이션에서 프로젝트를 먼저 선택합니다.
상태 전이가 안 됨	유효하지 않은 상태 전이	PENDING→READY, READY→IN_PROGRESS, IN_PROGRESS→REVIEW, REVIEW→DONE 순서를 확인합니다.
Agent Readiness 체크 실패	대상 서버에 적합한 에이전트 없음	대상 서버(lssn)를 확인하거나, PENDING/READY 상태에서 Agent Readiness 요건을 임시로 비활성화합니다.

役割: product機能（ログイン後内部運用者用 — 外部非公開） バージョン: 1.0 最終更新: 2026-08-17 ソース: giipv3/public/help/giip-issue.ja.md