Développement d'une Plateforme SaaS de Production de Plus de 20 000 Lignes avec Claude Code : Leçons Tirées de l'Ingénierie Agentique à Grande Échelle

Aperçu du projet

LastSaaS est un boilerplate SaaS de production dont chaque ligne a été écrite via des conversations avec Claude Code. Ce n'est pas une démo ou un jouet—il alimente une plateforme en direct appelée Flipbook. La stack comprend Go 1.25, React 19, TypeScript, MongoDB et Tailwind, publiée sous licence MIT.

Ce que le projet inclut

• Fondation SaaS complète avec authentification multi-tenant (OAuth, MFA, liens magiques, rotation JWT)
• Facturation Stripe (abonnements, par siège, crédits)
• Capacités de white-labeling
• 19 types d'événements webhook
• Tableau de bord d'administration et surveillance de santé
• Serveur MCP intégré avec 26 outils en lecture seule permettant aux assistants IA d'interroger les tableaux de bord, utilisateurs, facturation et données de santé

Ce qui a fonctionné

L'explicite de Go est un atout pour les agents : Pas de magie de framework signifie que Claude Code n'a pas à deviner ce que fait le middleware en arrière-plan. La gestion explicite des erreurs, le routage clair et les modèles prévisibles aident l'agent à rester sur la bonne voie.

Les modèles cohérents se cumulent : Établir tôt des modèles pour la structure des gestionnaires, services et accès aux données a permis à Claude de les répliquer sur des dizaines de points de terminaison avec une grande cohérence, réduisant considérablement la charge pour chaque nouvelle fonctionnalité.

Le serveur MCP a été construit par Claude pour Claude : Les 26 outils en lecture seule créent une interface méta où l'IA a construit sa propre façon d'interroger le système.

Le modèle document de MongoDB a simplifié le multi-tenant : Claude n'a eu aucun problème à maintenir l'isolation des tenants car le modèle de données rend les limites explicites, évitant la confusion des tables de jointure et les abstractions fuyantes.

Ce qui a nécessité de la discipline

Vous avez toujours besoin d'une vision architecturale : Claude Code est un exécutant brillant mais ne conçoit pas de systèmes. L'humain doit fournir l'architecture—savoir à quoi devrait ressembler le RBAC multi-tenant, comment les nouvelles tentatives de livraison webhook devraient fonctionner, et quel doit être le flux d'intégration Stripe.

Tout revoir : Surtout le code sensible à la sécurité comme la rotation JWT, la signature HMAC, la limitation de débit et la protection contre les injections. Claude réussit la plupart du temps, mais "la plupart du temps" ne suffit pas pour les flux d'authentification—chaque ligne liée à la sécurité nécessite une revue humaine.

Combattre la dérive des modèles : Sur de longues sessions, Claude peut dériver subtilement des modèles établis. Réancrer périodiquement la conversation aide : "Regardez comment nous avons implémenté le gestionnaire d'utilisateurs. Suivez le même modèle pour les webhooks."

Le concept "Construit pour les agents"

La base de code est intentionnellement structurée pour que, lorsque quelqu'un la fork et dirige son propre agent IA dessus, l'agent puisse l'étendre couramment. Cela inclut une structure de fichiers prévisible, une nomenclature cohérente et des modèles explicites—une fondation conçue pour être étendue via la conversation.

Le dépôt est disponible à l'adresse https://github.com/jonradoff/lastsaas.