Ledger & idempotence
Autorité interne des crédits Studio, réserves, règlements et replays.
Le ledger Studio reste l’autorité de consommation provider.
Modèle actuel
Le moteur représente l’argent en micro-dollars entiers et évite les calculs flottants pour les montants facturables.
Le repository ledger expose conceptuellement :
- allocate ;
- reserve ;
- settle ;
- release ;
- refund ;
- historique et vue de solde.
runMetered encadre le cycle réserve → appel → règlement ou remboursement.
Idempotence
Une génération rejouée avec le même idempotency key et le même scope retourne la ligne existante sans relancer le provider.
Une réutilisation incompatible de la clé est refusée.
Concurrence
Les opérations sensibles s’appuient sur des verrous de ligne côté membre afin d’éviter que deux réserves simultanées dépassent silencieusement le budget.
Funding
Le ledger reste commun aux modes futurs :
ORBIT_MANAGED
BYOK
La différence porte sur la source de financement du provider, pas sur le besoin d’attribution, quota, audit et observabilité.
Voir aussi Funding Studio & BYOK.