Architecture
Comment une demande transite de votre client vers Postgres, comment les organisations et les projets sont isolés et comment les services évoluent.
Un backend, huit services#
Aurabase est un monorepo Rust qui construit huit services Axum. Chaque service possède son propre port et ses propres routes /v1/<service>/…, et les services communiquent entre eux via la demande/réponse NATS. Tout le trafic de vos applications passe par une seule passerelle.
Un service peut redémarrer, planter ou être déployé tout seul. La passerelle suit l'état de santé de chaque service avec un disjoncteur : après 5 échecs en 60 secondes, elle répond 503 pour ce service pendant 30 secondes, puis réessaye.
Services et responsabilités#
Chaque service possède un domaine, ses propres migrations SQL et ses propres données. Vos applications leur parviennent uniquement via la passerelle.
| Service | Domaine | Responsabilités |
|---|---|---|
aura-gateway | Passerelle API | Proxy, middleware d'authentification, limitation de débit, disjoncteur |
aura-auth | Authentification | Inscription, connexion, OAuth 2.1, TOTP MFA et WebAuthn, sessions, JWKS |
aura-db | Base de données | CRUD sur PostgREST, migrations versionnées, génération de types, gestion de schémas |
aura-realtime | Temps réel | WebSocket, SSE, relais d'événements, présence, capture de données modifiées Postgres |
aura-storage | Stockage | Stockage d'objets compatible S3, téléchargement partitionné, URL signées, transformations d'images |
aura-functions | Edge Functions | Runtimes WASM et Deno, cron, file d'attente des tâches asynchrones, file d'attente de lettres mortes |
aura-notifications | Notifications | E-mail transactionnel (SMTP), SMS, push mobile, webhooks signés HMAC |
aura-ai | Passerelle IA | Inférence LLM via un point de terminaison, intégrations, RAG avec pgvector |
Isolement par organisation et projet#
Chaque organisation dispose de son propre cluster PostgreSQL, provisionné avec CloudNativePG (CNPG) dans un espace de noms Kubernetes qui lui est réservé. Aucun cluster, espace de noms ou pool de connexions n'est partagé entre deux organisations. La capacité du cluster (vCPU, mémoire, réplicas) suit le plan de l'organisation.
Au sein de ce cluster, chaque projet dispose de sa propre base de données Postgres, divisée en quatre schémas. Chaque projet possède son propre rôle de connexion, qui est membre uniquement de ses propres rôles. Les droits sur les schémas d'un projet sont accordés à ces rôles et jamais à PUBLIC. La passerelle définit la connexion search_path du projet dans le JWT du client et les tables d'application sont protégées par une sécurité au niveau des lignes (RLS).
Sur l'offre entreprise, un projet peut également bénéficier d'un cluster CNPG dédié dans son propre espace de noms. L'isolement vient alors de la séparation physique des clusters, en plus des autorisations.
| Schéma | Propriétaire | Contenu |
|---|---|---|
project_{uuid} | vous | Vos tableaux d'application |
project_{uuid}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, objects, rls_policies |
project_{uuid}_platform | plateforme | functions, jobs, cron, api_keys, webhooks |
Trois conséquences s’ensuivent :
- Aucun accès entre locataires. Deux organisations ne partagent jamais un cluster, un espace de noms ou un pool de connexions.
- Migrations indépendantes. Chaque projet migre et revient seul.
- Exportation simple.
pg_dump --schema='project_*'sauvegarde les données, les extensions et les politiques d'un projet.
Le schéma aura_console est partagé. Il contient la table projects et les sessions Studio. Aucune donnée applicative ne le traverse.
De la boucle à Postgres#
La passerelle vérifie chaque demande avant de la router. Voici le chemin de GET /v1/db/{projectId}/devices depuis un client REST :
1. TLS termination client → aura-gateway
2. Request ID and tracing request_id and trace_id are attached to the request
3. Rate limit token bucket, answers 429 when the limit is reached
4. Authentication JWT decoded and claims checked: sub, project_id, role
5. Circuit breaker the target service is HEALTHY, so the request goes through
6. Execution search_path set to the project's schemas, then the query runs under RLS
Chaque étape écrit des journaux structurés avec tracing, corrélés par request_id.
Mise à l'échelle#
Les services sont apatrides. Pour ajouter de la capacité, démarrez une autre réplique du binaire et connectez-la à NATS. Il rejoint le cluster et répond aux requêtes lorsqu'il est prêt. Il n’y a pas d’élection de leader ni de coordination distribuée.
Pour aller plus loin#
- Base de données
Postgres, schémas, migrations, génération de type RLS, TypeScript
- Authentification
OAuth, MFA, cycle de vie de session, RBAC
- Temps réel
WebSocket, SSE, présence, modifications Postgres
- Stockage
Compartiments, transformations et URL signés compatibles S3
- Edge Functions
Runtimes WASM et Deno, cron, file d'attente de lettres mortes
- Congrès
Dénomination des schémas, des colonnes et des politiques RLS