Technical Overview
Architecture du Système
NeoSaaS suit une architecture modulaire qui sépare clairement le frontend, le backend et la base de données. Découvrez comment les composants interagissent ensemble.
Diagramme du Système
Vue d'ensemble de l'architecture technique de NeoSaaS
Prérequis
NeoSaaS nécessite Next.js 16+ et Tailwind CSS pour fonctionner correctement.
Composants Principaux
Couche Client
Interface utilisateur construite avec React et Next.js 16
- • Pages et composants React
- • Gestion de l'état client
- • Routing Next.js App Router
- • UI avec Tailwind CSS
Backend / API
Logique métier et routes API Next.js
- • API Routes Next.js
- • Server Actions
- • Middleware d'authentification
- • Validation des données
Base de Données
PostgreSQL avec Prisma ORM
- • Prisma ORM intégré
- • Migrations automatiques
- • Support Neon ou local
- • Type-safe queries
Configuration de la Base de Données
Base de données PostgreSQL requise
NeoSaaS utilise Prisma ORM pour interagir avec PostgreSQL. Vous devez configurer une base de données externe (Neon) ou locale.
Option 1: Utiliser Neon
Service PostgreSQL cloud (recommandé)
- 1. Créer un compte
Allez sur neon.tech et créez un compte gratuit
- 2. Créer une base de données
Suivez les instructions pour créer un nouveau projet PostgreSQL
- 3. Récupérer l'URL de connexion
Copiez la connection string fournie par Neon
- 4. Configurer l'environnement
DATABASE_URL="postgresql://user:password@host:port/database"
Option 2: PostgreSQL Local
Installation locale sur votre machine
- 1. Installer PostgreSQL
Téléchargez et installez PostgreSQL depuis postgresql.org
- 2. Créer une base de données
createdb neosaas - 3. Configurer l'URL de connexion
DATABASE_URL="postgresql://user:password@localhost:5432/neosaas" - 4. Lancer les migrations
Voir la section suivante pour les commandes Prisma
Configuration Prisma
Prisma ORM est intégré dans NeoSaaS. Il suffit de lancer les commandes nécessaires.
Étapes d'installation
- 1. Installer les dépendances
npm install - 2. Générer le client Prisma
npx prisma generate - 3. Lancer les migrations
npx prisma migrate deploy - 4. (Optionnel) Seed la base de données
npx prisma db seed
Astuce
Utilisez
npx prisma studio pour visualiser et gérer vos données via une interface web.Architecture de Déploiement
Déploiement sur Vercel
NeoSaaS est optimisé pour Vercel
L'architecture de NeoSaaS est conçue pour être déployée facilement sur Vercel avec les fonctionnalités suivantes:
- • Déploiement automatique depuis GitHub
- • Variables d'environnement sécurisées
- • Edge Functions pour les performances
- • CDN global pour les assets statiques
- • Preview deployments pour chaque commit
Prochaines Étapes
Maintenant que vous comprenez l'architecture, voici ce que vous pouvez faire: