노드 추가 요청 처리

유저가 즉시 유형 노드 증설을 신청하면 Super Admin이 노드를 등록하고 요청을 마감한다.

언제 쓰나

풀에 즉시 유형 노드가 모자라면 유저가 GPU 예약 화면의 + 노드 추가 요청 으로 유형·수량·사유를 적어 신청한다. 이 요청은 Super Admin에게 직접 온다 — Org Admin 요청함에는 뜨지 않는다(D-027). 서버급 유형의 증설은 요청이 아니라 예약 승인으로 처리한다.

화면

노드 추가 요청은 노드 풀 관리 화면 상단의 대기 요청 카드로 나타난다. 등록은 같은 화면의 인벤토리에서 한다.

노드 풀

대기 요청 카드에는 아래 정보가 담긴다.

항목	의미
요청 코드	REQ-…
조직 / 팀	요청한 조직과 팀
유형 · 수량	요청한 노드 유형(node_type_name)과 대수(count)
진행	이 요청으로 등록된 노드 수(registered) / 요청 대수
메시지	신청자가 적은 사유

절차

노드를 실제로 등록해야 요청이 이행된다. 등록 자체는 노드 풀 관리의 수동 절차 그대로다. 처리 방법은 두 가지다.

방법 A — 등록하며 자동 이행 (권장)

1. 대기 요청을 보고 인벤토리에서 노드를 등록한다. 이때 등록에 그 요청을 연결한다.
2. 등록될 때마다 요청의 registered가 1씩 오른다.
3. 요청 대수를 채우면 요청이 자동 완료되고(status approved) 팀에 알림이 간다. 별도로 완료 버튼을 누를 필요가 없다.

방법 B — 처리 완료·반려 수동 표시

1. 노드풀에 필요한 등록을 마친다.
2. 요청을 처리 완료(done) 또는 반려(rejected)로 표시한다.
   • 처리 완료는 노드풀에 실제 등록을 마친 뒤 누른다. 팀에 노드가 풀에 등록되었습니다 알림이 간다.
   • 반려는 사유(comment)를 함께 보낸다. 사유가 팀에 전달된다.

이렇게 되면 정상

• 자동 완료: 요청 대수만큼 등록하면 요청이 approved가 되고, 팀에 노드 추가 요청(REQ-…)이 처리되었습니다 · 요청하신 노드 N대가 풀에 등록되었습니다 알림이 간다. 감사 로그에 node_request.done이 남는다.
• 수동 완료: 팀에 처리 알림이 가고 감사 로그에 node_request.done이 남는다.
• 반려: 팀에 반려 사유가 담긴 알림이 가고 감사 로그에 node_request.rejected가 남는다.
• 어느 경우든 처리 완료 시 팀 콘솔의 조직 노드 풀에 새 노드가 보인다.

막히는 경우

증상	원인	조치
already_decided	이미 처리(완료·반려)된 요청	처리된 요청은 다시 결정할 수 없다
등록 연결 시 org_mismatch	요청 조직과 등록 조직이 다름	요청한 조직으로 노드를 등록
요청을 못 찾음	node_add 타입이 아니거나 삭제됨	요청 목록에서 상태·코드 확인

알아둘 것

• 노드 추가 요청은 Super Admin 전용이다(D-027). Org Admin의 요청함은 키 발급·모델 접근·예산 증액 요청만 받고, 노드 추가는 받지 않는다.
• 등록이 곧 이행이다. 요청을 승인한다고 노드가 생기지 않는다. Super Admin이 조직 계정의 인스턴스를 실제로 등록해야 풀이 늘어난다.
• 서버급과 즉시 유형의 증설 경로가 다르다. 서버급은 예약 신청 자체가 증설 요청이라 승인 큐로 가고, 즉시 유형은 노드 추가 요청으로 온다.
• 진행 상태가 누적된다. 방법 A로 부분 등록하면 다음에 남은 대수만 채우면 된다. 요청을 다시 만들 필요가 없다.