Vue d’ensemble

Architecture Globale

Wagoo SaaS est construite avec une architecture client-serveur moderne optimisée pour la scalabilité.

Stack Multi-layer


┌─────────────────────────────────────┐
│        Layer Présentation           │
│   Next.js App Router + React        │
├─────────────────────────────────────┤
│        Layer Métier                 │
│   Prisma ORM + Services             │
├─────────────────────────────────────┤
│        Layer Données                │
│   PostgreSQL                        │
└─────────────────────────────────────┘

Points clés

🚀 Frontend

Next.js 15+ avec App Router (SSR/SSG)
React 19 pour les composants
TypeScript pour la sécurité des types
Tailwind CSS pour le styling
shadcn/ui pour les composants UI

🔐 Authentification

better-auth (6 plugins)
- Sessions & Cookies
- 2FA (TOTP)
- Passkeys
- Magic Links
- OAuth (GitHub, Google)
- Email verification

📊 Base de Données

Prisma ORM pour l’accès aux données
PostgreSQL pour la persistence
Migrations versionnées
Relations complexes

💰 Intégrations

Stripe pour les paiements
Webhooks pour les événements
SMTP/Resend pour l’email

Flux de requête


1. User interagit avec l'UI
           ↓
2. Requête envoyée à Next.js API
           ↓
3. Middleware d'auth vérifie la session
           ↓
4. Prisma récupère les données
           ↓
5. Réponse JSON retournée
           ↓
6. UI met à jour l'état

Sécurité intégrée

✅ CSRF protection (Next.js intégré) ✅ SQL injection prevention (Prisma) ✅ XSS protection (React + ESLint) ✅ Authentification HTTPS locale ✅ Rate limiting ✅ Validation côté serveur et client

Performance

⚡ Server Components pour le SSR ⚡ Image Optimization avec Next.js ⚡ Code Splitting automatique ⚡ Caching des requêtes API ⚡ CDN ready (Vercel)

Scalabilité

📈 Prisma gère les connexions DB 📈 Next.js peut scale horizontalement 📈 Vercel fournit l’infrastructure 📈 PostgreSQL supporte les hauts débits

Deployment

La plateforme est prête pour Vercel, Docker, ou auto-hébergée.

Voir Deployment pour plus de détails.