Budgets
Ne plus découvrir la facture d'une plateforme en fin de mois : un budget mensuel par projet, par plateforme ou pour tout l'espace, des seuils d'alerte et une projection calculée sur les coûts réels. Formules Équipe et Entreprise.
Un budget, une devise
Dans l'écran Coûts, Nouveau budget demande un montant mensuel, une devise et un périmètre :
| Périmètre | Ce qui compte |
|---|---|
| Tout l'espace | tous les coûts de tous les projets |
| Un projet | les coûts de ce projet, toutes plateformes |
| Une plateforme | les coûts de cette plateforme (Vercel, GitHub, un serveur…), dans tous les projets ou dans un seul |
Les coûts sont ceux de l'écran Coûts : lus par l'agent dans l'API de facturation de la plateforme (Vercel, GitHub), ou saisis comme coût mensuel fixe. Les mois sont comptés en temps universel (UTC).
Seuils et alertes
Chaque budget a ses seuils, en pourcentage du montant : 50, 80 et 100 % par défaut, de un à cinq seuils, réglables. Le premier passage d'un seuil dans le mois ouvre une alerte :
- notification sur les téléphones liés et webhook de l'espace, comme toute alerte ;
- un seul avis par seuil et par mois : un nouveau relevé ne le répète pas ; l'alerte du seuil précédent se ferme ;
- au-delà de 100 %, la gravité reste « alerte », sauf si vous cochez Au dépassement, gravité « panne » pour ce budget : les membres qui ont choisi les alertes par SMS reçoivent alors un SMS, au texte fixe.
L'alerte se ferme d'elle-même au seuil suivant, à la fin du mois, ou quand le budget change. Un budget relevé rejuge le mois : un seuil de nouveau franchi avertit de nouveau.
La projection de fin de mois
Pour le mois en cours, chaque budget affiche une projection, présentée comme telle, avec sa méthode (bouton Méthode) :
| Coût | Compté dans la projection |
|---|---|
| Lu par l'API de facturation | prolongé au rythme constaté depuis le début du mois : montant relevé × durée du mois ÷ temps écoulé au moment du relevé |
| Saisi (montant mensuel fixe) | son montant |
Exemple : 30 $ relevés après 10 jours d'un mois de 30 jours, plus un serveur à 12,50 $ : 30 × 30 ÷ 10 + 12,50 = 102,50 $. Avant qu'un relevé couvre un jour entier du mois, aucune projection n'est affichée plutôt qu'un chiffre au hasard. La projection n'ouvre pas d'alerte : seuls les coûts constatés en ouvrent.
Avertir, jamais bloquer
Un budget n'ordonne rien et ne bloque rien : ni la préparation, ni la signature, ni l'exécution d'un ordre. Quand un budget est dépassé, le tiroir de signature d'une action qui peut coûter (prévisualiser une branche, redéployer ou promouvoir sur Vercel, lancer ou relancer un workflow GitHub) le rappelle ; vous décidez.
Les gestes de secours (revenir à la version précédente, redémarrer un service, retirer une prévisualisation, sauvegarder) ne sont jamais concernés.
Économies à signer
Dès qu'un seuil est franchi, le budget propose des économies, chacune à préparer puis à signer comme tout ordre ; rien ne part seul :
- retirer une prévisualisation en ligne ;
- mettre un projet en pause : plus aucun déploiement tant qu'il l'est. Ce qui tourne déjà continue, et continue de coûter.
Anomalies
Kantama garde chaque jour le dernier montant lu par l'API de facturation. Le lendemain, il compare la hausse du jour à la moyenne des jours précédents : au-delà d'un facteur (×3 par défaut, sur 7 jours), une alerte dit les chiffres, par exemple « +18,00 $ en un jour, contre 2,00 $ par jour en moyenne ».
- seulement des relevés réels : un jour sans relevé n'est pas deviné, et il faut au moins trois jours de comparaison ;
- une seule fois par coût et par jour ;
- le facteur et le nombre de jours se règlent dans l'écran Coûts.
Rapport du mois
Pour chaque mois : tous les coûts avec leur source, les totaux par devise, chaque budget (consommé, seuils franchis, projection du mois en cours, coûts non comptés) et les anomalies. En CSV pour un tableur, ou en page imprimable. L'historique des six derniers mois s'affiche sous chaque budget, et la vue d'ensemble montre la jauge du budget de chaque projet.
Les montants lus par API d'un mois peuvent encore changer après sa fin, le temps que la plateforme les arrête.
Formule
| Solo | Équipe | Entreprise | |
|---|---|---|---|
| Coûts par projet, plateforme et mois | oui | oui | oui |
| Budgets, seuils, projection, anomalies | oui | oui | |
| Rapport du mois (CSV, page imprimable) | oui | oui | oui |
Si l'espace revient à Solo, les budgets existants continuent d'avertir ; ils se retirent, mais ne se modifient plus.
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.