2분 읽기

이슈 관리 가이드

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.ko.md