AI 크레딧·원가 계량 백엔드 계약

Prototype은 useAiCredits로 상품·예산·경고 UX를 검증한다. 운영 청구 원장은 반드시 서버 권위 데이터로 교체한다.

원칙

• 로컬 규칙·Docs·기능 찾기: 0크레딧
• 외부 AI 호출: Company 공유 크레딧 차감
• 저장·발송·확정: AI 응답과 분리하고 사용자 승인 필요
• 요청 ID를 멱등키로 사용해 재시도 중복 과금 방지
• 공급자 실패·타임아웃은 환불 이벤트를 append-only로 기록

서버 원장 필드

company_id, office_id, actor_id, request_id, feature, provider, model, input_tokens, output_tokens, provider_cost, credits, status, refund_for, created_at

클라이언트가 보낸 토큰·비용·크레딧은 신뢰하지 않는다. Edge Function이 공급자 응답의 usage를 정규화해 원장에 기록한 뒤 잔여량을 반환한다.

상품

• Free: 월 100크레딧
• 기본 상품: 월 300크레딧
• AI Standard: 월 2,000크레딧
• AI Pro: 월 8,000크레딧

요금과 크레딧 환산율은 운영 사용량 1~2개월을 수집한 뒤 조정한다. 외부 공급자 원가는 Leyve 상품료와 분리해 내부 손익에서 추적한다.

UI Select 정합 2026-07-19 KST

Company 계정의 상품 선택기를 EDS native Select 공식 anatomy로 정리했다. planKey 값, 변경 이벤트, 상품·원장 API 계약에는 변화가 없다.