Issue Management Guide
An operator guide for creating, viewing, and managing GIIP internal agent worker issues (GIIP CSN 47 and others).
📋 Overview
The Issue Management menu is an operational tool for registering work for GIIP platform's internal agent workers and tracking their progress. Issues are organized by CSN (Customer/Service Number), and each issue follows the status transition: PENDING → READY → IN_PROGRESS → REVIEW → DONE.
🎯 Page Roles
| Page | Path | Key Operations |
|---|---|---|
| List | /admin/giip-issues | View issue list, filter (Active/Done), switch project |
| Detail | /admin/giip-issues/[isn] | View issue details, update status, add comments, Dispatch |
| Create | /admin/giip-issues/new | Register new issue (title, content, status, target server) |
| Edit | /admin/giip-issues/[isn]/edit | Edit title, content, status of existing issue |
🛠️ Key Workflows
1. Register New Issue
- Select Project (CSN) — First select the CSN from the top navigation.
- Click the New Issue button.
- Enter title, content, initial status (PENDING/READY), and optionally target server (lssn).
- If Agent Readiness is required, verify the checklist before submitting.
2. Manage Issue Status
- READY: Waiting for agent to process. Can transition to IN_PROGRESS after MinAgeMinutes ≥ 60.
- IN_PROGRESS: Agent is actively working on the issue.
- REVIEW: Agent has completed work and is awaiting verification.
- DONE: Processing complete.
3. Add Comments
Use the comment section at the bottom of the detail page to record progress notes, decision rationale, and results.
🔗 Related Guides
For API integration and end-user usage of issue management, refer to:
📘 Issue Management API Reference → 👤 Issue Management End-User Guide →
💡 Important Notes
- If CSN is not selected first, the issue list will not display.
- Write pages (new/edit) require minimum level 70 (admin) access.
- Status transitions must follow the correct order (PENDING → READY → IN_PROGRESS → REVIEW → DONE).
Troubleshooting
| Symptom | Cause | Solution |
|---|---|---|
| Issue list is empty | CSN not selected | Select a project from the top navigation first. |
| Status transition fails | Invalid status transition | Verify the order: PENDING→READY, READY→IN_PROGRESS, IN_PROGRESS→REVIEW, REVIEW→DONE. |
| Agent Readiness check fails | No eligible agent on target server | Verify the target server (lssn) or temporarily disable Agent Readiness requirement for PENDING/READY issues. |
Role: product feature (internal operator — not publicly exposed, requires login)
Version: 1.0
Last Updated: 2026-08-17
Source: giipv3/public/help/giip-issue.en.md