Facturation
La facturation de ton workspace pour Freelance OS lui-même. Le plan sur lequel il tourne, ce que ce plan débloque, les sièges facturés par membre, la carte enregistrée, les factures d'abonnement et le détail de l'usage IA et services. À ne pas confondre avec la vente de tes produits ou l'abonnement de tes end-users.
Vue d'ensemble
Chaque workspace a un abonnement à Freelance OS. Il porte un plan courant (free, pro, agence, enterprise ou un palier créé par la plateforme), un statut Stripe, une période en cours et des drapeaux comme comped (offert) ou past_due (paiement en retard). Cet abonnement décide de deux choses: ce à quoi tu as droit, et combien tu paies.
Les droits se résolvent par plan. Chaque module, chaque feature et chaque limite a une clé typée dans un catalogue partagé. Le plan porte une matrice d'entitlements, et le workspace peut recevoir des surcharges individuelles qui priment sur le plan et peuvent expirer. Une feature au-dessus de ton plan déclenche un UpgradePrompt qui nomme le palier requis, pas une erreur muette.
Le prix combine un abonnement de base et des sièges. Le workspace paie son plan, plus un prix par membre au-delà des sièges inclus: le premier siège va au propriétaire, les setters, closers et gestionnaires de contenu ajoutés consomment des sièges payants. Par-dessus, l'usage IA et services est mesuré par événement, avec un coût estimé et un tableau de bord d'usage détaillé.
Ce que le module fait
Plan, statut et sièges
La page facturation des réglages montre l'abonnement du workspace: son plan, le statut de l'abonnement Stripe, la carte enregistrée, l'état des sièges et les factures. L'accès est réservé au droit BILLING_READ, donc au propriétaire et aux admins, pas au super-admin plateforme uniquement.
- Plan courant et prix de base
- Sièges occupés: membres actifs et invitations en attente comptent, membres révoqués non
- Prix par siège au-delà des sièges inclus du plan
- Carte de paiement et commission de reversement appliquée
Entitlements et clés de feature
Le catalogue de clés est typé: modules (module.studio, module.voice, module.ads…), features (feature.emails.sequences, feature.linkedin.extension, feature.agents.copilot…) et limites (limit.contacts, limit.workspace_members, limit.webinars…). Le plan porte la matrice, les surcharges workspace priment dessus. Chaque clé a un plan minimum et un label français pour la copy d'upgrade.
Quotas et limite dure
Un quota compare l'usage de la période en cours à l'inclus du plan, pour un couple service et métrique. Un plan en limite dure coupe l'action quand le quota est épuisé: l'appel lève une QuotaExceededError et le call site renvoie un 402 lisible, pas un 500. Le même garde-fou protège les surfaces payantes du Kernel et le copilote mobile, à l'identique.
Usage mesuré et refacturable
Chaque appel à un service externe pose un événement d'usage: le service, la métrique, la quantité et un coût estimé en centimes. La page usage agrège par service et par période (ce mois, le mois dernier, 30 jours), sépare le coût refacturable du coût en clé propre (BYO), et filtre par famille core ou voice.
- Core: Claude, Apify, Fathom, WhatsApp, Resend
- Voice: Twilio, Groq, Deepgram, Vapi, Dropcontact
- Une clé posée par le workspace bascule l'événement en BYO, non refacturé
Bannières, grâce et compensation
L'état de la bannière se résout par priorité: paiement en retard, carte manquante, alerte de quota à 80 pour cent, plan non choisi après 14 jours. Un workspace offert (comped) ne voit aucune bannière. Un free resté sans plan au-delà de la période de grâce est repassé en free par un cron, avec un log de transition.
Comment on l'utilise
- 01
Ouvre ta facturation
Dans /settings/billing, tu vois le plan du workspace, son statut Stripe, la carte enregistrée, les sièges et les factures d'abonnement.
- 02
Ajoute ta carte
Sans carte, les features mesurées sont coupées et une bannière carte manquante s'affiche. Tu enregistres une carte pour débloquer l'usage payant.
- 03
Suis ton usage
La page /settings/billing/usage détaille l'usage par service et par période, sépare le coût refacturable du BYO, et filtre par famille core ou voice.
- 04
Débloque une feature
Une feature au-dessus de ton plan ouvre un UpgradePrompt qui nomme le palier requis. Tu passes par /settings/billing/upgrade pour changer de plan.
- 05
Ajoute un membre
Chaque membre au-delà des sièges inclus ajoute un siège payant à l'abonnement. Une invitation en attente réserve déjà son siège.