Aller au contenu
Logo Aurabase
aurabase

Architecture

Comment une demande transite de votre client vers Postgres, comment les organisations et les projets sont isolés et comment les services évoluent.

Explication7 min de lectureNiveau intermédiaireRévisé le 4 nov. 2026

Cette page a été traduite automatiquement. La version anglaise fait foi.

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.

ServiceDomaineResponsabilités
aura-gatewayPasserelle APIProxy, middleware d'authentification, limitation de débit, disjoncteur
aura-authAuthentificationInscription, connexion, OAuth 2.1, TOTP MFA et WebAuthn, sessions, JWKS
aura-dbBase de donnéesCRUD sur PostgREST, migrations versionnées, génération de types, gestion de schémas
aura-realtimeTemps réelWebSocket, SSE, relais d'événements, présence, capture de données modifiées Postgres
aura-storageStockageStockage d'objets compatible S3, téléchargement partitionné, URL signées, transformations d'images
aura-functionsEdge FunctionsRuntimes WASM et Deno, cron, file d'attente des tâches asynchrones, file d'attente de lettres mortes
aura-notificationsNotificationsE-mail transactionnel (SMTP), SMS, push mobile, webhooks signés HMAC
aura-aiPasserelle IAInfé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émaPropriétaireContenu
project_{uuid}vousVos tableaux d'application
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformplateformefunctions, 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.
Schéma partagé

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 :

chemin de la demandetext
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#