요청함

팀이 올린 예산 증액·키 발급·모델 접근 요청을 승인하거나 반려한다. 노드 추가 요청은 여기에 오지 않는다(Super Admin 전담).

언제 쓰나

• 팀이 예산 증액을 요청했을 때
• 팀이 서버리스 키 발급을 요청했을 때
• 팀이 기존 키에 모델 접근 추가를 요청했을 때

노드 추가 요청은 Super Admin에게 직접 가므로 이 요청함에는 나타나지 않는다(D-027).

화면

요청함 빈 상태

요소	설명
대기 / 전체 탭	우상단. 대기 중만 볼지 처리된 것까지 볼지 전환한다
요청 카드	유형 배지, 팀 이름, 요청 코드(REQ-…), 경과 시간, 요청 메시지
반려 / 승인 버튼	대기 요청에만 표시된다. 승인 버튼 문구는 유형별로 다르다
빈 상태	대기 중인 요청이 없습니다

유형 배지와 승인 버튼 문구는 다음과 같다.

유형	배지	승인 버튼
예산 증액(budget_increase)	예산 증액	증액 승인 (팀이 잠겨 있으면 증액 후 잠금 해제)
키 발급(key_issue)	키 발급	키 발급
모델 접근(model_access)	모델 접근	접근 허용

절차

승인

1. 요청 카드에서 승인 버튼을 누른다. 유형에 따라 처리가 갈린다.
2. 예산 증액: 미할당 풀에서 팀으로 요청액을 이동한다(allocate). 요청 페이로드에 금액이 없으면 기본 5,000 C로 승인된다. 팀이 잠겨 있었다면 함께 잠금이 풀린다.
3. 키 발급: 팀에 새 서버리스 키를 수령 대기 상태로 만든다. 발급 즉시 예산만큼 팀 크레딧에서 선불 차감된다(D-028). 요청에 예산값이 없으면 기본 3,000 C다. 팀에 서버리스 API 키가 준비되었습니다 알림이 간다. 비밀 키는 팀이 수령할 때 생성되며 관리자에게는 표시되지 않는다.
4. 모델 접근: 지정된 키(없으면 팀의 최신 활성 키)에 요청 모델을 추가한다. 팀에 활성 키가 없으면 no_active_key로 거부되니 먼저 키를 발급해야 한다.
5. 처리되면 요청 상태가 approved로 바뀌고 요청자에게 알림이 발송된다.

반려

1. 요청 카드의 반려를 누른다.
2. 반려 사유를 입력한다(요청자에게 그대로 전달된다). 사유 없이는 반려 버튼이 활성화되지 않는다.
3. 반려하면 상태가 rejected가 되고, 요청자에게 사유와 함께 같은 요청을 다시 제출할 수 있습니다 안내가 간다.

이렇게 되면 정상

• 예산 증액 승인: 팀 예산이 오르고 미할당 풀이 준다. 크레딧·정산의 크레딧 기록에 예산 할당이 남는다.
• 키 발급 승인: 서버리스 키 목록에 수령 대기(pending_claim) 키가 생기고, 원장에 서버리스 키 구매 (선불) 차감이 남는다.
• 모델 접근 승인: 대상 키의 모델 수가 늘고 팀에 모델 접근이 허용되었습니다 알림이 간다.
• 어느 경우든 처리 결과가 사용 로그에 request.approve.* 또는 request.reject로 기록된다.

막히는 경우

증상	원인	조치
already_decided	이미 승인/반려된 요청	목록을 새로고침한다. 처리는 한 번만 된다
insufficient_credit	키 발급 승인 시 팀 크레딧 부족	팀 예산을 먼저 증액하거나 요청 예산을 줄여 재승인
no_active_key	모델 접근 승인인데 팀에 활성 키 없음	먼저 키를 발급한 뒤 승인
노드 추가 요청이 안 보임	노드 추가는 Super Admin 전담	Super Admin에게 문의. 요청함에는 원래 뜨지 않는다
승인 응답이 유실됐다	네트워크 문제로 응답만 사라짐	재승인해도 이중 차감되지 않는다. 요청 행 잠금과 멱등키가 막는다

알아둘 것

• 키 발급 승인은 선불 차감이라 승인 즉시 팀 크레딧이 빠진다. 반려나 미승인 상태에서는 차감이 없다.
• 예산 증액 요청은 승인 시 금액을 조정할 수 있다(요청값이 없을 때 기본값 적용).
• 요청 승인 처리는 요청 행을 잠근 채(with_for_update) 진행되고 멱등키가 붙는다. 승인 응답이 유실돼 재시도해도 크레딧이 두 번 빠지지 않는다.
• 대기가 비어 있어도 전체 탭에서 지난 승인·반려 이력을 확인할 수 있다.