· 7분 읽기
왜 불변 원장인가
크레딧은 잔액 필드를 직접 수정하는 대신 HOLD → CAPTURE/RELEASE로 이어지는 트랜잭션 원장으로 관리합니다. 중복 과금과 실패 환불을 감사 가능하게 만들기 위한 ADR 결정이며, 구독 크레딧 지급과 Stripe 결제 충전, 환불까지 모두 같은 원장을 지나갑니다.
승인 게이트가 끼어드는 지점
워크스페이스 빌링 정책은 건당 한도, 일간·월간 한도, 승인 임계값을 가집니다. 예상 비용이 임계값을 넘는 생성은 자동 실행되지 않고 승인 대기 상태로 멈추며, 승인된 최대 비용 안에서만 예약이 잡힙니다.
한도는 USER·PROJECT·MODEL 스코프로도 세분화할 수 있어, 특정 고비용 모델이나 특정 프로젝트에만 좁은 예산을 걸 수 있습니다.
- 예약(HOLD)은 정책 검사를 통과해야만 생성
- 작업 실패 시 RELEASE로 자동 반환, 부분 성공은 ADJUST로 정산
- 모든 엔트리는 CSV/JSON으로 내보내 감사에 사용