Architecture · Documentation

Starter ProArchitecture

Architecture adaptées à la productionLien vers la section

Starter Pro est conçu autour d'un principe :

se déplacer rapidement sans détruire la maintenabilité à long terme.

L'architecture sépare clairement les préoccupations du produit:

Routage
Authentification
facturation
backend frontières
structure du tableau de bord
caractéristiques du produit
primitives d'interface utilisateur partagées

Cela aide les équipes à faire évoluer la complexité du produit sans transformer la base de code en un monolithe de pages couplées et de logique dupliquée.

Principe de base

Starter Pro est structuré pour soutenir la croissance réelle du SaaS, pas seulement les démos locales.

Architecture de haut niveauLien vers la section

starter-pro-architecture.txt

app
  ↓
route groups
  ↓
feature modules
  ↓
server boundaries
  ↓
database + billing + auth
  ↓
shared UI system

Couche d'route

The route layer defines URLs, layouts, navigation structure, protected areas, and page orchestration.

App RouterProtected routesLayoutsNavigation

Systèmes de baseLien vers la section

Authentification

Sessions réelles, OAuth, flux de vérification, routes protégées et comportement applicatif conscient du compte.

Facturation

Stripe Checkout, abonnements, synchronisation client, portail de facturation et accès aux produits Webhook-Aware.

Base de données

Persistance alimentée par Prisma avec des limites de propriété évolutives et des modèles d'accès aux données prêts à la production.

Tableau de bord shell

Navigation SaaS partagée, mises en page, structure des paramètres et surfaces d'application réutilisables.

Pourquoi cette structure existeLien vers la section

La plupart des bases de code SaaS deviennent difficiles à évoluer parce que :

Auth Logic Fuites partout
L'état de facturation devient incohérent
pages dupliquer logique
Les primitives de l'interface utilisateur s'éloignent
Les frontières disparaissent
Les responsabilités du serveur et du client se mélangent

Starter Pro est conçu pour réduire cette entropie dès le début.

Règle de production

L'architecture est conçue pour maintenir la vitesse du produit élevée après le lancement, et pas seulement avant le lancement.

Flux de produitsLien vers la section

Configurer l'infrastructureLien vers la section

Connectez la base de données, les fournisseurs d'authentification, la livraison de courrier électronique et l'infrastructure de facturation Stripe.

Gardez la fondationLien vers la section

Préservez l'authentification, la facturation, les mises en page, les paramètres, l'interpréteur de tableau de bord et la structure de routage protégée.

Remplacer les surfaces des produitsLien vers la section

Remplacez le contenu de démarrage, les étiquettes de navigation, les tableaux de bord et les flux spécifiques à un domaine par votre véritable logique produit.

Extension des modules de fonctionnalitésLien vers la section

Ajoutez vos propres flux de travail métier tout en gardant les limites du serveur et les primitives d'interface utilisateur partagées stables.

Lancement incrémentalLien vers la section

Expédiez plus vite parce que la couche d'infrastructure est déjà adaptées à la production.

Modèle d'application protégéLien vers la section

Starter Pro traite l'application comme plusieurs couches de confiance.

Surface publique

Marketing et acquisition

Les routes publiques se concentrent sur le positionnement, l’intégration, la tarification et la conversion avant l’authentification.

landing pages
tarification
routes de commercialisation
flux de mise à niveau
Surfaces SEO

Surface protégée

Zone de produits authentifiés

Les routes protégées nécessitent des sessions authentifiées et prennent en charge un comportement de produit adapté à l’offre.

tableau de bord
paramètres
facturation
workflows d'équipe
Accès par abonnement

Philosophie de l'interface utilisateur partagéeLien vers la section

Starter Pro est livré avec un système de conception partagé déjà intégré.

Cela comprend :

@pycolors/ui
@pycolors/tokens
Tailwind CSS v4
tokens de couleur sémantiques
primitives SaaS réutilisables
accessibilité-premiers modèles

L’objectif est la cohérence entre :

pages marketing
App UI
flux de facturation
pages de paramètres
dialogues et superpositions
Surfaces de tableau de bord

La cohérence de l'IU est importante

Les produits SaaS se sentent plus premium lorsque la navigation, les superpositions, les formulaires, les paramètres et les surfaces de facturation se comportent de manière cohérente sur l'ensemble du produit.

Ce que vous devez personnaliserLien vers la section

Starter Pro est conçu pour être étendu, pas réécrit.

Vous remplacez généralement :

branding
copie
étiquettes de navigation
entités de domaine
workflows produits
contenu du tableau de bord
stratégie de prix

Vous conservez généralement :

auth fondations
infrastructure de facturation
protection de route
tableau de bord shell
paramètres architecture
primitives d'interface utilisateur partagées
structure du produit

Modèle mentalLien vers la section

Starter Pro n’est pas le produit final.

C'est le système adaptées à la production que votre produit développe à l'intérieur.

AuthentificationComprendre les sessions, OAuth, les routes protégées et les limites d'authentification.FacturationExplorez l'intégration Stripe, les abonnements, la synchronisation de facturation et l'accès aux forfaits.BackendDécouvrez comment Starter Pro structure l'accès aux données, Prisma et les limites côté serveur.Liste de contrôle de productionValidez l'infrastructure, l'authentification, la facturation et la préparation au lancement avant l'expédition.