크레딧·정산

조직 잔여·팀 할당·미할당 풀을 한눈에 보고, 모든 크레딧 변동을 원장 기록으로 추적한다.

언제 쓰나

크레딧·정산

상단 카드 3개.

가운데 구매·정산 이력은 크레딧 판매(credit_sales) 기록이다. 일자 내역 크레딧 금액(₩)이 나온다. 크레딧 판매는 Super Admin이 반영한다.

아래 크레딧 기록이 원장 엔트리 그대로다. 헤더에 전체 내역: 예약 확정 차감·서버리스 구매/환원·세션 정산·할당·조정이 필터 안내로 붙는다.

열	설명
`일시`	엔트리 발생 시각
`대상`	계정 이름(`조직` 또는 팀 이름)
`유형`	아래 14종 라벨
`금액`	양수는 초록(적립), 음수는 빨강(차감). 선점 전용 엔트리는 `선점 ±N C`로 회색 표시
`내용`	사유 또는 참조(`팀 삭제: …` 등)

유형 열에 뜨는 라벨과 각각이 언제 생기는지다. 금액은 차감이 음수, 적립이 양수다.

원장 타입	화면 라벨	언제 생기나
`purchase`	`크레딧 구매`	Super Admin이 조직에 크레딧을 판매·반영할 때(유입)
`allocate_out`	`예산 할당 (조직 −)`	팀 생성·증액 시 조직 계정에서 나가는 쪽
`allocate_in`	`예산 할당 (팀 +)`	같은 이동의 팀 계정으로 들어오는 쪽
`reclaim_out`	`예산 회수 (팀 −)`	팀 감액·삭제 시 팀 계정에서 나가는 쪽
`reclaim_in`	`예산 회수 (조직 +)`	같은 회수의 조직 계정으로 들어오는 쪽
`hold`	`선점`	즉시 실행 세션 시작 시 크레딧을 미리 잡을 때. `금액`은 0이고 선점만 움직인다
`hold_extend`	`선점 연장`	실행이 길어져 선점을 늘릴 때
`release`	`선점 해제`	세션 종료로 잡아둔 선점을 되돌릴 때
`capture`	`세션 사용 확정`	세션 실경과분을 확정 차감할 때
`usage_reservation`	`예약 확정 차감 (선불)`	서버급 예약 승인 즉시 전액 차감(D-028)
`serverless_purchase`	`서버리스 키 구매 (선불)`	서버리스 키 발급·증액 시 선불 차감
`serverless_refund`	`서버리스 키 환원`	키 감액·폐기 시 잔여 환원
`usage_llm`	`서버리스 사용`	옛 호출당 차감 방식(레거시). 신규로는 생기지 않는다
`adjust`	`운영 조정`	운영자가 수동으로 크레딧을 넣거나 뺄 때(사유 필수)

화면 헤더의 필터 문구가 이 라벨들과 대응한다.

필터 문구	해당 유형
`예약 확정 차감`	`usage_reservation`
`서버리스 구매/환원`	`serverless_purchase` · `serverless_refund`
`세션 정산`	`capture`(그리고 선점 `hold`/`hold_extend`/`release`)
`할당`	`allocate_` · `reclaim_`
`조정`	`adjust`

증상	원인	조치
`조직 잔여 ≠ 미할당 풀 + 팀 잔여`	삭제된 팀 계정 등 집계 누락 의심	원장 기록에서 최근 할당/회수 쌍이 맞는지 확인
`금액`이 `선점 ±N C`로만 뜬다	`hold`/`hold_extend`/`release`는 잔액을 옮기지 않고 선점만 이동	정상이다. 실제 차감은 `세션 사용 확정`에서 일어난다
구매 이력이 비어 있다	아직 크레딧 판매가 없음	크레딧 판매는 Super Admin이 반영한다
예약 차감이 안 보인다	승인 전이거나 반려됨	차감은 승인 시점에만 생긴다. 신청·반려 단계에는 없다