Updo Backend — Documentation

Updo Backend est une plateforme multi-tenant Django de niveau production. Elle combine l’isolation des tenants (schema PostgreSQL, Row-Level Security, FK partagée), un moteur d’autorisation ABAC complet, des workflows d’approbation, l’authentification JWT avec OTP/2FA, et un bus d’événements domaine double-mode (synchrone + Celery).

Architecture Globale

• Architecture Globale
  • Vue d’ensemble
  • Structure des répertoires
  • Les 3 Bounded Contexts
  • Flux d’une requête HTTP
  • Bus d’événements domaine
• Guide de Démarrage Rapide
  • Installation
  • Configuration minimale
  • Migration et démarrage
  • Créer un tenant
  • Utiliser le contexte tenant

Shared Kernel

• Shared Kernel — Couche Domaine
  • Entités de base
  • Agrégats (Aggregate Root)
  • Value Objects
  • Événements Domaine
  • Exceptions
  • Interfaces (ABC)
  • Enums et Value Objects Multi-tenant
• Shared Kernel — Couche Infrastructure
  • Modèles abstraits Django
  • Managers avec Soft Delete
  • Repository Django
  • Event Dispatcher
  • Données de référence (Master Data)
  • Utilitaires partagés
• Backends d’Isolation Tenant
  • Factory
  • Schema Backend (schema)
  • RLS Backend (rls)
  • Shared FK Backend (shared_fk)
  • Comparaison des backends
• Bus d’Événements Domaine
  • EventBus
  • Fonctions de commodité
  • Dispatch asynchrone
  • Exemple complet
• Gestion du Contexte Tenant
  • Variables de contexte
  • Accesseurs
  • Context Manager : tenant_context
  • Context Manager : async_tenant_context
  • Context Manager : cross_tenant_context
  • Diagramme de flux
• Cache Tenant-Aware
  • Fonctions
  • Isolation des clés
• Logging et Observabilité
  • Logging Structuré
  • Observabilité (OpenTelemetry)
  • Métriques simples
• Stockage Tenant-Aware
  • TenantFileSystemStorage
  • TenantAzureBlobStorage
• Utilitaires Celery
  • Détection de disponibilité
  • Tâche Celery Tenant-Aware
  • Dispatch d’événements
  • Exécution avec fallback
  • Configuration Celery
  • Tâches Celery de l’infrastructure

Tenant Context

• Tenant — Modèles
  • Tenant
  • TenantMembership
  • Role
  • Department
  • Invitation
• Tenant — Middleware
  • TenantMiddleware
  • Compatibilité ASGI
• Tenant — Managers
  • TenantManager
  • MembershipManager
  • TenantSpecificManager
  • Base Models
• Tenant — Services Domaine
  • provision_tenant
  • resolve_tenant_from_identifier
  • validate_membership
  • Événements domaine
  • Value Objects
• Tenant — Schema Manager
  • Fonctions principales
  • Introspection
  • Backup et Restauration
  • Database Router
• Tenant — Commandes de Gestion
  • create_tenant_schema
  • migrate_tenant_schemas
  • list_tenant_schemas
  • check_tenant_schemas
  • clone_tenant_schema
  • backup_tenant_schema
  • restore_tenant_schema
  • drop_tenant_schema
  • create_tenant_superuser
  • tenant_command
• Tenant — Invitations
  • send_invitation
  • accept_invitation_by_token
  • Flux d’invitation
  • Configuration
• SMTP par Tenant
  • Modèle TenantSMTPConfig
  • Backend email tenant-aware
  • Fonctions utilitaires
  • Configuration via l’admin
  • Flux de résolution

Identity Context

• Identity — Modèles
  • User
  • UserManager
  • EmailVerification
  • OTPDevice
  • OTPChallenge
• Identity — Authentification JWT
  • CustomTokenObtainPairSerializer
  • CustomJWTAuthentication
  • Endpoints d’authentification
  • Flux d’authentification
• Identity — OTP / 2FA
  • OTP par Email
  • TOTP (Time-based One-Time Password)
  • Codes de récupération statiques
  • Fonction unifiée
  • Endpoints API
  • Configuration
• Identity — Vues API
  • Gestion des utilisateurs
  • Vérification d’email
  • Événements domaine
  • Sérialiseurs

Authorization Context

• Authorization — ABAC (Vue d’ensemble)
  • Architecture ABAC
  • Flux d’évaluation détaillé
  • Exemple de politique ABAC
• Authorization — Politiques (PAP/PDP)
  • Modèle Policy (PAP)
  • PDP — Policy Decision Point
  • Politiques statiques
  • API REST (PAP)
• Authorization — Moteurs de Conditions
  • Factory
  • JSON Engine (défaut)
  • Cedar Engine
  • Casbin Engine
• Authorization — PIP (Information Point)
  • Attributs résolus
  • Sources de données
  • Fournisseurs personnalisés
  • Utilisation manuelle du PIP
• Authorization — Workflows d’Approbation
  • Modèles
  • ApprovalOrchestrationService
  • Flux d’approbation
  • Tâches Celery
  • API REST
  • Configuration
• Authorization — PEP et Décorateurs
  • Permissions DRF
  • Fonctions d’évaluation
  • Décorateur @abac_required
  • Value Objects d’évaluation

Testing

• Utilitaires de Test
  • Fixtures pytest — Cycle de vie du tenant
  • Fixtures pytest — Schéma réutilisable
  • Helpers
  • Factories

Internationalisation

• Internationalisation (django-parler)
  • Configuration
  • Modèles de base traduisibles
  • Modèles traduits — Données de référence
  • Modèles traduits — Tenant Context
  • Modèles traduits — Authorization Context
  • Utilisation dans le code
  • Architecture des tables

Stack Production

• Stack Production — Intégrations
  • CORS (django-cors-headers)
  • OpenAPI / Swagger (drf-spectacular)
  • Throttling / Rate Limiting
  • Audit Trail (django-auditlog)
  • Import/Export de données (django-import-export)
  • Sentry (Error Tracking)
  • Pre-commit Hooks
• Déploiement (Docker & CI/CD)
  • Docker
  • CI/CD — GitHub Actions
  • Health Check

Configuration

• Configuration (Settings)
  • get_setting()
  • Référence complète
  • Internationalisation (django-parler)
• Routes URL (API)
  • Identity Context
  • Tenant Context
  • Authorization Context

Index et tables

• Index

• Module Index

• Search Page