사용량 및 청구

Kisenon은 실제 사용량을 측정하고 이를 조직별로 집계합니다. 콘솔은 사용량을 보여주며, 매월 무료 사용량을 넘는 사용은 요금 계약에 따라 청구됩니다 — 아래 청구 상태를 참조하세요.

측정 대상

컨트롤 플레인은 프로젝트별로 세 가지 차원을 샘플링하고 이를 조직별로 집계합니다:

움직이는 것은 컴퓨트입니다: 유휴 시 일시 중지되는 엔드포인트는 멈추는 순간 CU-시간 누적을 멈추므로, 하루 대부분을 잠들어 있는 프로젝트는 쉴 새 없이 돌아가는 프로젝트의 일부분만큼만 비용이 듭니다. 스토리지와 브랜치 수는 샘플링 창 안에서 안정적이므로 더 성긴 주기로도 충분합니다.

샘플은 현재 청구 주기에 대한 컴퓨트, 스토리지, 브랜치 사용량을 조직별 단일 뷰로 집계합니다 — 청구 페이지가 렌더링하는 숫자입니다.

무료 등급

모든 조직은 매월 무료 사용량으로 시작합니다. 조직별로 프로젝트 수 상한도 적용될 수 있습니다: 상한이 활성화되면, 등록된 결제 수단이 없는 조직은 고정된 수의 프로젝트로 제한됩니다; 한계에 도달하면 또 다른 프로젝트를 생성할 때 free_allowance_exhausted(HTTP 403)가 반환됩니다. 등록된 결제 수단이 있는 조직은 상한이 없습니다. 정확한 상한은 하드코딩된 숫자가 아니라 배포 설정이므로, 시간이 지남에 따라 조정할 수 있습니다.

한 주기의 측정 사용량이 올라감에 따라, 콘솔은 세 가지 임계값에서 본문 위에 점차 강해지는 배너를 표시합니다 — 컨트롤 플레인이 주기별 알림 로그에 기록하는 것과 동일한 80 / 95 / 100 퍼센트입니다:

• 80% — 노란색 알림: "이번 기간에 무료 등급의 80% 이상을 사용했습니다."
• 95% — 서비스가 중단되기 전에 결제 수단을 추가하라는 황색 경고.
• 100% — 빨간색 소진 상태: 결제 수단이 추가될 때까지 컴퓨트가 일시 중지될 수 있습니다.

각 배너는 세션 동안 닫을 수 있으며 결제 수단 추가로 연결됩니다.

조직 청구 페이지

모든 조직에는 /orgs/{id}/billing에 청구 페이지가 있으며, 조직 내비게이션에서 접근할 수 있습니다. 사용량 데이터가 있으면 차원별로 사용량 / 허용량 바(80% 미만은 녹색, 80–95%는 황색, 95% 이상은 빨간색)와 선택적인 기간 말 예상 마커, 예상 인보이스 항목, 그리고 현재 플랜 및 결제 수단을 렌더링합니다.

청구 관리

셀프서비스 청구가 라이브 상태입니다. 결제 수단이 등록되면, 조직 청구 페이지(설정 → 청구)에 Stripe 호스팅 고객 포털을 여는 청구 관리 버튼이 표시됩니다. 포털에서 다음을 할 수 있습니다:

• 결제 수단 업데이트 또는 교체.
• 인보이스와 영수증 보기.
• 청구 주소와 세금 ID 편집.
• 해지.

카드가 추가되기 전에는 페이지에 대신 결제(Checkout) 버튼이 표시됩니다(결제 수단 추가); 둘은 상호 배타적입니다.

할 수 있는 사람: 조직 소유자 또는 billing 역할만 — admin, member, viewer는 안 됩니다.

참고로, 컨트롤 플레인은 다음을 노출합니다:

POST /v1/billing/portal-session → { url }

이는 고객 포털로 가는 URL을 반환하며; 포털은 이후 항상 조직 청구 페이지로 당신을 되돌려 보냅니다.

프로젝트별 비용 (쇼백)

청구 페이지에는 사용량을 프로젝트별로 세분화하는 프로젝트별 비용 카드가 포함되어 있습니다. 프로젝트별로 네 가지 측정 차원을 보고합니다:

크레딧 및 할인 포함 토글은 뷰를 총액과 순액 사이에서 전환합니다 — 순액 뷰는 무료 허용량과 볼륨 할인을 비례 배분하여 적용합니다. 이것은 표시 렌즈입니다: 푸터는 항상 총 소계, 무료 허용량, 볼륨 할인, 그리고 순 합계를 보여줍니다.

데이터는 일 단위입니다: 기간은 전체 시작 날짜(YYYY-MM-DD)로 키가 지정됩니다. 사용량은 전역 측정 저장소에서 가져오므로, 프로젝트가 삭제된 후에도 프로젝트의 비용은 계속 보입니다.

청구 상태

측정 사용량은 프로젝트별로 수집되고, 조직별로 집계되며, 요금 계약에 따라 Stripe를 통해 청구됩니다:

• 매월 무료 사용량 안의 사용은 청구되지 않습니다; 이를 넘는 사용은 유닛 단위로 측정되며, 대량 사용에는 볼륨 할인이 자동 적용됩니다.
• 컨트롤 플레인의 청구 엔드포인트(/v1/billing/customer)가 사용량 배너와 조직 청구 페이지를 뒷받침합니다 — 둘은 동일한 소스에서 읽으므로, 모두 현재 주기의 실제 숫자를 반영합니다.
• 무료 등급 프로젝트 상한을 해제하고 무료 사용량을 넘어 계속하려면, 조직 청구 페이지에서 결제 수단을 추가하세요.

관련 문서

• 조직 — 사용량이 집계되는 단위.
• 엔드포인트 — 유휴 시 일시 중지가 CU-시간을 낮게 유지하는 비결입니다.
• 요금 — 무료 허용량, 유닛 단가, 그리고 볼륨 할인.