3 min read

프로젝트 목록 가이드

GIIP 플랫폼 내의 개별 프로젝트를 생성하고 관리하며, 각 프로젝트에 인프라 자산을 할당하는 방법을 안내합니다.

📁 프로젝트 목록 페이지로 이동 →

📋 개요

프로젝트는 GIIP의 가장 기본적인 관리 단위입니다. 서버, 데이터베이스, 네트워크 등 모든 인프라 자산은 특정 프로젝트에 소속되어야 하며, 이를 통해 명확한 권한 격리와 자원 추적이 가능합니다.

각 프로젝트는 고유의 대시보드를 가집니다. 프로젝트 내부의 서버 부하 상태, 이슈 발생 현황, 일일 비용 트렌드 등을 종합적으로 모니터링할 수 있습니다.

페이지 상단 Selected Project: 의 프로젝트명 바로 옆에, 현재 선택된 프로젝트에 곧바로 적용되는 작은 아이콘 버튼 5종이 표시됩니다. 목록에서 해당 프로젝트 행을 찾지 않아도 바로 실행할 수 있습니다.

순서	색상	기능	동작
1	파랑	유저 관리	선택된 프로젝트의 사용자 목록(`userlist`) 화면으로 이동합니다.
2	남색	프로젝트 그룹	선택된 프로젝트의 프로젝트 그룹 목록(`prjgrouplist?csn=`) 화면으로 이동합니다. 목록 행의 [Groups] 버튼과 같은 화면입니다.
3	노랑	수정	프로젝트 코드와 이름을 고치는 [프로젝트 수정] 창을 엽니다.
4	보라	언어 선택	프로젝트 기본 언어를 바꾸는 [프로젝트 언어 변경] 창을 엽니다.
5	빨강	삭제	확인 창을 거친 뒤 프로젝트를 삭제합니다.

프로젝트를 선택하지 않은 상태에서는 5개 버튼이 모두 비활성(회색)으로 표시됩니다.
선택한 프로젝트가 현재 목록에 없으면 [수정]과 [삭제]는 필요한 정보를 얻을 수 없어 비활성이 되고, [유저 관리]·[프로젝트 그룹]·[언어 선택]은 정상 동작합니다.
[삭제]는 해당 프로젝트의 소유자(Owner) 또는 시스템 관리자에게만 보입니다. 목록 행의 [삭제] 버튼과 같은 조건입니다.
기존 목록의 행별 버튼(Enter / Users / Groups / Edit / Language / Delete)은 그대로 유지됩니다.
상단 아이콘 버튼은 목록 행 버튼과 같은 화면으로 이동합니다. 이동 대상·아이콘·색상 모두 행 버튼이 정본입니다.

태그 활용: 프로젝트 생성 시 관련 태그(예: #Production, #Java, #AWS)를 입력하면 나중에 수많은 프로젝트 중 원하는 대상을 찾기 유용합니다.
권한 제어: 프로젝트 단위로 유저의 접근 권한이 제어되므로, 민감한 자산은 별도의 프로젝트로 분리하여 관리하세요.

이 기능의 API 상세 사양은 별도 가이드를 참조하세요.

📘 프로젝트/사용자 관리 API 가이드

증상	원인	해결
[Assets] 탭에서 바인딩할 서버가 목록에 보이지 않음	해당 서버가 이미 다른 프로젝트에 할당되어 있음	목록에는 미할당 서버만 표시되므로, 기존 프로젝트에서 서버를 해제한 뒤 다시 시도합니다.
프로젝트 상세 페이지의 3D 토폴로지가 비어 있음	아직 서버·DB 자산이 바인딩되지 않음	[Assets] 탭에서 서버 및 DB를 할당하면 토폴로지가 표시됩니다.
목록에서 특정 프로젝트가 보이지 않거나 편집되지 않음	프로젝트 상태가 종료(Closed)로 전환됨	상태를 활성(Active)으로 변경한 뒤 다시 관리합니다.
프로젝트가 많아 원하는 대상을 찾기 어려움	생성 시 태그를 입력하지 않음	태그(예: #Production, #Java)를 등록하여 검색·필터에 활용합니다.
상단 헤더의 [수정]/[삭제] 아이콘이 회색이고 클릭되지 않음	프로젝트가 선택되지 않았거나, 선택한 프로젝트가 현재 목록에 없음	[List]로 목록을 다시 불러오거나, 목록에서 프로젝트를 선택하세요.
상단 헤더에 [삭제] 아이콘이 전혀 보이지 않음	프로젝트의 소유자도 시스템 관리자도 아닌 경우	프로젝트 소유자에게 삭제를 요청하세요.

버전: 1.2 최종 업데이트: 2026-09-15 소스 파일: giipv3/public/help/projectlist.ko.md