SaaS
Architecture d'un SaaS : les fondations à poser avant le premier client
Authentification, isolation des données, facturation pilotée par webhooks, tâches en arrière-plan, journalisation, sauvegardes testées, environnements séparés : les fondations invisibles qui distinguent un SaaS prêt à encaisser d'un prototype.
Avant d'accueillir un premier client payant, un SaaS doit reposer sur sept fondations : une authentification solide, l'isolation des données entre clients, une facturation dont l'état vient des webhooks du prestataire de paiement, des tâches en arrière-plan, une journalisation des erreurs, des sauvegardes dont la restauration a été testée, et des environnements séparés. Aucune ne se voit dans une démonstration ; toutes coûtent beaucoup plus cher à ajouter après coup.
1. L'authentification
Ne la développez pas vous-même de zéro : utilisez une solution éprouvée (Better Auth, Supabase Auth, Firebase Auth, ou un service dédié). Elle doit couvrir la réinitialisation de mot de passe, la connexion par fournisseur tiers, la gestion des sessions et, pour le B2B, la double authentification. Les rôles et permissions se vérifient côté serveur, jamais seulement dans l'interface.
2. L'isolation des données
Chaque donnée appartient à un utilisateur ou, en B2B, à une organisation, et chaque requête est filtrée en conséquence. Avec PostgreSQL, les politiques de sécurité au niveau des lignes permettent à la base elle-même de refuser l'accès aux données d'un autre client. Le choix entre un produit mono-utilisateur et une architecture par organisations se fait dès le départ : il structure tout le modèle de données.
3. Une facturation pilotée par les webhooks
L'erreur classique : considérer qu'un client a payé parce qu'il est revenu de la page de paiement. La source de vérité est le prestataire de paiement. Avec Stripe, ce sont les webhooks — abonnement créé, renouvelé, paiement échoué, abonnement annulé — qui mettent à jour les droits dans votre base. Sans cela, les échecs de paiement et les annulations ne sont jamais répercutés.
4. Les tâches en arrière-plan
Envoi d'e-mails, génération de documents, imports, appels à un modèle d'IA : tout ce qui prend plus d'une seconde ou peut échouer temporairement doit sortir de la requête de l'utilisateur et passer par une file de tâches, avec nouvelles tentatives automatiques. Sinon, l'interface se bloque et les échecs se perdent.
5. La journalisation et le suivi des erreurs
Le jour où un client signale un problème, il faut pouvoir retrouver ce qui s'est passé. Un outil de suivi des erreurs, des journaux structurés côté serveur et un historique des actions sensibles (qui a modifié quoi, quand) sont indispensables dès la mise en production — et l'historique des actions est souvent demandé par les clients B2B.
6. Des sauvegardes réellement restaurables
Les services managés sauvegardent les bases de données, mais une sauvegarde dont on n'a jamais testé la restauration n'est qu'une hypothèse. Testez la procédure au moins une fois avant le lancement, et sachez combien de temps elle prend. Pensez aussi aux fichiers téléversés par les utilisateurs.
7. Des environnements séparés
Une préproduction distincte de la production, avec ses propres clés (Stripe en mode test, fournisseurs d'e-mails en mode bac à sable), permet de vérifier chaque évolution avant qu'elle n'atteigne les clients. Les secrets ne sont jamais dans le code, et les clés des services payants ne sont jamais envoyées au navigateur.
Les obligations RGPD qui ont un impact technique
- Permettre l'export des données d'un utilisateur.
- Permettre la suppression d'un compte et des données associées.
- Tenir la liste des sous-traitants qui reçoivent des données (hébergement, e-mails, paiement, IA).
- Limiter la conservation des données à ce qui est nécessaire.
Ces fondations font partie du socle de chaque SaaS que nous développons. Pour les technologies elles-mêmes, voir notre article sur la stack technique d'un SaaS.