Apprendre le Code Informatique & la Programmation Gratuitement | PROJET CARTHAGE

STUDIO D'ARCHITECTURE CARTHAGE MAX • NIVEAU ENTREPRISE

Supervision Lead Architecte

Bienvenue dans le Studio d'Architecture de Production. Tu conçois l'infrastructure de « Moteur SaaS B2B Multi-Tenant & Facturation Stripe ». Examine la topologie système interactive ci-dessous, arbitre les choix d'ingénierie (ADR), implémente chaque couche critique et certifie ton architecture avec le banc d'audit de niveau entreprise.

Reprendre l'Étape Active

1. Choisissez Votre Architecture

4 Systèmes de Production

Moteur SaaS B2B Multi-Tenant & Facturation Stripe

Développez l'ossature d'un SaaS prêt pour la production avec isolation des tenants, webhooks Stripe sécurisés et RBAC.

Ce projet vous guide pas à pas dans la création d'un moteur SaaS multi-tenant complet. Vous apprendrez à implémenter l'isolation de données au niveau base de données (PostgreSQL/SQLite via middleware Prisma), l'authentification basée sur JWT avec refresh tokens sécurisés, la gestion des rôles d'équipe (Owner, Admin, Member), et un cycle complet d'abonnement Stripe (Checkout, Webhooks idempotents, portail client et suspensions).

Next.js 14 / Node.jsTypeScriptPrisma / SQLiteStripe APIJWT & Argon2Zod Validation

Architecture logicielle multi-tenant avec isolation stricte des données d'entreprise

Sécurisation des webhooks Stripe avec vérification de signature cryptographique et idempotence

Système d'autorisation à contrôle d'accès basé sur les rôles (RBAC) avec middlewares

Packaging Docker et déploiement de production sur serveur cloud Linux avec Nginx

TOPOLOGIE SYSTÈME & AUDIT SLA DE PRODUCTION

Plan Directeur d'Infrastructure de Production

Orchestration en temps réel des microservices. Cliquez sur un nœud pour inspecter SLA, sécurité et coût cloud.

Santé Cluster :0/4 Opérationnels

SLA Cible :99.99%

ATTENTE

NŒUD 01•1.2 ms

Edge Reverse Proxy & SSL

Terminaison SSL Let's Encrypt, compression gzip, HTTP/2 & En-têtes HSTS

Nginx AlpineTLSv1.3Rate-limit 100 req/s

ATTENTE

NŒUD 02•2.4 ms

Passerelle RBAC & Sécurité JWT

Vérification HMAC-SHA256, hiérarchie de rôles (Owner/Admin/Member) & protection CSRF

Argon2id HashingRole Hierarchy GuardCookie HttpOnly

EN COURS

NŒUD 03•3.8 ms

Persistence & Isolation Multi-Tenant

Schéma relationnel Prisma, clé tenantId obligatoire sur chaque requête, Zero Leakage

Prisma ClientCascade DeletionMulti-Tenant Indexing

ATTENTE

NŒUD 04•14.2 ms

Moteur de Facturation & Webhooks Stripe

Signature cryptographique HMAC Stripe, traitement idempotent & synchronisation d'abonnements

Stripe SDK v14Event Idempotency TableCustomer Portal

Métriques de Réseau & Garantie d'IsolationSeuil de latence P99 < 15ms · 0.00% de fuite de données cross-tenant certifiée par assertions

P99: ~3.8msZero-Leak: 100%

2. Feuille de Route & Jalons Guidés

Avancez jalon par jalon. Cochez les actions et lancez le test de validation.

0 / 4 Jalons Terminés (0%)

Jalon 1 sur 4

Étape 1 : Modélisation Base de Données & Isolation Multi-Tenant

Définition du schéma relationnel Prisma : Tenants, Utilisateurs, Adhésions (Memberships) et Abonnements.

Actions & Étapes d'Implémentation :

1Définir le schéma Prisma avec clé étrangère tenantId obligatoire sur chaque ressource
2Mettre en place un middleware Prisma interceptant chaque requête findMany/findFirst pour injecter tenantId
3Écrire un script de seed créant deux organisations distinctes avec utilisateurs tests

ADR-01Dossier de Décision d'Architecture (ADR)

Stratégie d'Isolation des Données Multi-Tenant

Problématique d'Ingénierie :L'application doit héberger des centaines d'entreprises clientes avec garantie d'étanchéité absolue des données tout en maintenant les coûts d'infrastructure bas.

Option A (Classique)DÉCONSEILLÉ

Base de Données Dédiée par Entreprise (Database-per-Tenant)

+ Isolation physique absolue

+ Sauvegardes et migrations indépendantes par client

- Coût d'infrastructure prohibitif à l'échelle

- Complexité extrême des migrations Prisma

Option B (Standard Entreprise)RECOMMANDÉ

Schéma Partagé avec Filtrage par tenantId & Middleware Prisma (Recommandé)

✓ Coût minimal & scalabilité instantanée

✓ Filtrage automatique injecté au niveau middleware

✓ Support natif du multi-stage SQLite/PostgreSQL

⚠ Nécessite des tests d'étanchéité rigoureux (0 fuite cross-tenant)

Pourquoi les leaders tech choisissent ceci : 95% des SaaS B2B modernes (Stripe, Notion, Linear) adoptent cette approche pour maximiser la marge brute tout en protégeant les données via des middlewares stricts.

datasource db {
  provider = "sqlite"
  url      = env("DATABASE_URL")
}

generator client {
  provider = "prisma-client-js"
}

model Organization {
  id           String       @id @default(cuid())
  slug         String       @unique
  name         String
  stripeCustId String?      @unique
  planTier     String       @default("free") // free, pro, enterprise
  memberships  Membership[]
  projects     Project[]
  createdAt    DateTime     @default(now())
}

model User {
  id           String       @id @default(cuid())
  email        String       @unique
  passwordHash String
  memberships  Membership[]
  createdAt    DateTime     @default(now())
}

// TODO 1: Définir le modèle Membership avec rôle (owner, admin, member)
// et contrainte d'unicité @@unique([userId, organizationId])
model Membership {
  id             String       @id @default(cuid())
  role           String       @default("member")
  userId         String
  organizationId String
  user           User         @relation(fields: [userId], references: [id], onDelete: Cascade)
  // TODO: Définir la relation Organization
}

// TODO 2: Définir le modèle Project avec isolation multi-tenant obligatoire (organizationId)
model Project {
  id             String       @id @default(cuid())
  title          String
  // TODO: Ajouter la clé étrangère organizationId et la relation Organization
}

main•UTF-8•TypeScript 5.x•Tab: 2

Banc de Test ConnectéLn 45, Col 1366

Suite d'audit automatisée :npx prisma migrate dev && npm test tests/tenancy.test.ts

Prêt à enchaîner sur le composant suivant ?

Chargement...

1. Choisissez Votre Architecture

Moteur SaaS B2B Multi-Tenant & Facturation Stripe

Arène de Code Multijoueur Temps Réel (WebSockets & Redis)

Bot de Trading Algorithmique & Moteur de Carnet d'Ordres

Moteur RAG d'Entreprise & Recherche Sémantique Vectorielle

Moteur SaaS B2B Multi-Tenant & Facturation Stripe

Plan Directeur d'Infrastructure de Production

Edge Reverse Proxy & SSL

Passerelle RBAC & Sécurité JWT

Persistence & Isolation Multi-Tenant

Moteur de Facturation & Webhooks Stripe

2. Feuille de Route & Jalons Guidés

Étape 1 : Modélisation Base de Données & Isolation Multi-Tenant

Stratégie d'Isolation des Données Multi-Tenant

Base de Données Dédiée par Entreprise (Database-per-Tenant)

Schéma Partagé avec Filtrage par tenantId & Middleware Prisma (Recommandé)

1. Choisissez Votre Architecture

Moteur SaaS B2B Multi-Tenant & Facturation Stripe

Arène de Code Multijoueur Temps Réel (WebSockets & Redis)

Bot de Trading Algorithmique & Moteur de Carnet d'Ordres

Moteur RAG d'Entreprise & Recherche Sémantique Vectorielle

Moteur SaaS B2B Multi-Tenant & Facturation Stripe

Plan Directeur d'Infrastructure de Production

Edge Reverse Proxy & SSL

Passerelle RBAC & Sécurité JWT

Persistence & Isolation Multi-Tenant

Moteur de Facturation & Webhooks Stripe

2. Feuille de Route & Jalons Guidés

Étape 1 : Modélisation Base de Données & Isolation Multi-Tenant

Stratégie d'Isolation des Données Multi-Tenant

Base de Données Dédiée par Entreprise (Database-per-Tenant)

Schéma Partagé avec Filtrage par tenantId & Middleware Prisma (Recommandé)