Documentation Système
SaaS Boilerplate documentation
Tout ce que vous devez savoir pour déployer une infrastructure SaaS robuste, sécurisée et multi-tenant.
Premiers pas
Nouveau sur le Boilerplate Django ou sur les environnements de production ? C'est ici qu'il faut commencer.
- De zéro : Aperçu de l'architecture | Variables d'environnement | Installation locale
- Tutoriels : 1. Configuration PostgreSQL | 2. Custom User & Auth JWT | 3. Multi-tenant Enterprise | 4. Tâches asynchrones Celery | 5. Déploiement Docker | 6. Sécurisation CI/CD
- Guides avancés : Implémenter le RBAC | Rôles temporaires (expires_at) | Webhooks Stripe
Architecture du projet
Le boilerplate suit une structure Django modulaire avec séparation claire des responsabilités :
django-boilerplate/
├── authentication/ # Custom User, JWT, Workspaces, DeviceSession
├── apps/
│ ├── enterprise/ # Multi-tenant, exercices comptables
│ ├── catalog/ # Produits, catégories, TVA, unités
│ ├── inventory/ # Stock, alertes, dépréciations
│ ├── partners/ # Partenaires B2B, rôles
│ ├── orders/ # Panier, commandes
│ └── payments/ # Stripe, PayPal
├── support/ # Tickets, feedback
├── pages/ # Interface HTML + Design System
├── core/ # Utilitaires partagés
└── config/ # Settings, URLs, WSGI, Swagger
Obtenir de l'aide
- Consultez la FAQ — réponses aux questions de déploiement fréquentes.
- Besoin d'un module précis ? Consultez l'index des Modules.
- Explorez les endpoints via Swagger UI ou ReDoc.
- Signalez les bugs sur le Ticket Tracker (GitHub).
Organisation de la documentation
- Tutoriels étape par étape — du
git clonejusqu'au premier déploiement réussi. - Guides de conception — pourquoi JWT cookie-only, pourquoi drf-spectacular, comment fonctionne l'isolation multi-tenant.
- Référence API — documentation complète de tous les endpoints via OpenAPI 3.0.
- Changelog — historique des versions et mises à jour.
Navigation
Assistance
FAQ Déploiement
Erreurs 502, variables d'environnement, migrations.
Discord Communauté
Échangez avec d'autres développeurs SaaS.
GitHub Issues
Signalez des bugs ou proposez des évolutions.
Django 5.0+
Python 3.12
DRF 3.15+
Version v2.0