1.5 KiB
1.5 KiB
✅ [완료] probilling-impl
결론 — Pro 하이브리드(committed base + metered overage)를 Stripe Billing Meters로 구현한다 — licensed 기본료 price와 meter 연결 metered price를 한 subscription의 두 item으로 묶고, 사용량은 결정론적 identifier를 붙인 Meter Event로 멱등 전송해 Stripe가 집계·티어링·정산하게 한다.
결정 필요 — — 아니오 확신도 — Med (E3 근거)
repo: company-haness · 2026-07-07 18:17 · -
⚠️ 리스크
- 멱등성/중복계량 - at-least-once 전송·재시도 시 identifier가 없거나 24h 롤링 윈도를 넘겨 재전송되면 이중 계량 → 결정론적 identifier(EVENT_NAME:customer:unit_key) 필수, 윈도 밖 재처리 금지.
- 정산 오차 - timestamp가 과거 35일/미래 5분 밖이면 이벤트가 거부되어 미청구 누락 발생, 클록 스큐·지연배치 주의. 앱측 추정치는 UX 전용이며 Stripe 집계가 원장.
- 파라미터 미확정 - value-metric(호출/크레딧/완료건수), 무료 allotment, 단위마진 하한 배수(overage 단가)가 CPO/CFO 미승인 상태라 price 재발행 시 마이그레이션 비용 발생 가능.
📎 근거
| # | 출처 | 등급 |
|---|---|---|
| 1 | _sandbox/evidence/probilling/stripe-usage-billing.md | E3 |
| 2 | _sandbox/evidence/probilling/metering_sample.py | E3 |
📂 상세 (에이전트용 YAML)
- 원천 보고서:
_sandbox/completion-records/probilling/probilling-impl.report.yaml