Naar de inhoud springen
Aurabase-logo
aurabasis

Architectuur

Hoe een verzoek van uw klant naar Postgres reist, hoe organisaties en projecten geïsoleerd zijn en hoe services worden geschaald.

Uitleg7 min lezenNiveau tussenproductHerzien op 4 nov 2026

Deze pagina is automatisch vertaald. De Engelse versie is gezaghebbend.

Eén backend, acht services#

Aurabase is een Rust monorepo die acht Axum-services bouwt. Elke service heeft zijn eigen poort en zijn eigen /v1/<service>/… routes, en services communiceren met elkaar via NATS verzoek/antwoord. Al het verkeer van uw applicaties loopt via één gateway.

Een service kan opnieuw opstarten, crashen of zelfstandig worden ingezet. De gateway houdt de status van elke service bij met een stroomonderbreker: na 5 storingen binnen 60 seconden antwoordt hij gedurende 30 seconden 503 voor die service en probeert het vervolgens opnieuw.

Diensten en verantwoordelijkheden#

Elke dienst bezit één domein, zijn eigen SQL-migraties en zijn eigen gegevens. Uw toepassingen bereiken hen alleen via de gateway.

DienstDomeinVerantwoordelijkheden
aura-gatewayAPI-gatewayProxy, authenticatie-middleware, snelheidsbeperking, stroomonderbreker
aura-authAuthenticatieAanmelden, aanmelden, OAuth 2.1, TOTP MFA en WebAuthn, sessies, JWKS
aura-dbDatabaseCRUD over PostgREST, versiebeheermigraties, typegeneratie, schemabeheer
aura-realtimeRealtimeWebSocket, SSE, gebeurtenisrelais, aanwezigheid, Postgres vastleggen van wijzigingsgegevens
aura-storageOpslagS3-compatibele objectopslag, multipart-upload, ondertekende URL's, afbeeldingstransformaties
aura-functionsEdge FunctionsWASM en Deno runtimes, cron, asynchrone taakwachtrij, wachtrij voor dode letters
aura-notificationsMeldingenTransactionele e-mail (SMTP), sms, mobiele push, HMAC-ondertekende webhooks
aura-aiAI-gatewayLLM-gevolgtrekking via één eindpunt, inbedding, RAG met pgvector

Isolatie per organisatie en project#

Elke organisatie krijgt zijn eigen PostgreSQL-cluster, ingericht met CloudNativePG (CNPG) in een Kubernetes-naamruimte die daarvoor is gereserveerd. Er wordt geen cluster, naamruimte of verbindingspool gedeeld tussen twee organisaties. De capaciteit van het cluster (vCPU, geheugen, replica's) volgt het plan van de organisatie.

Binnen dat cluster krijgt elk project zijn eigen Postgres-database, opgesplitst in vier schema's. Elk project heeft zijn eigen verbindingsrol, die alleen lid is van zijn eigen rollen. Rechten op de schema's van een project worden toegekend aan deze rollen en nooit aan PUBLIC. De gateway stelt de verbinding search_path in vanuit het project in de JWT van de client, en applicatietabellen worden beschermd door beveiliging op rijniveau (RLS).

Bij het zakelijke aanbod kan een project ook een speciaal CNPG cluster in zijn eigen naamruimte krijgen. Isolatie komt dan voort uit de fysieke scheiding van clusters, naast machtigingen.

SchemaEigenaarInhoud
project_{uuid}jijUw toepassingstabellen
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformplatformfunctions, jobs, cron, api_keys, webhooks

Er volgen drie gevolgen:

  • Geen toegang voor meerdere tenants. Twee organisaties delen nooit een cluster, een naamruimte of een verbindingspool.
  • Onafhankelijke migraties. Elk project migreert en draait zelfstandig terug.
  • Gewone export. pg_dump --schema='project_*' dumpt de gegevens, extensies en beleidsregels van een project.
Gedeeld schema

Het aura_console-schema wordt gedeeld. Het bevat de projects-tabel en de Studio-sessies. Er gaan geen applicatiegegevens doorheen.

Van krul tot Postgres#

De gateway controleert elk verzoek voordat het wordt doorgestuurd. Dit is het pad van GET /v1/db/{projectId}/devices vanaf een REST-client:

verzoek padtext
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

Elke stap schrijft gestructureerde logboeken met tracing, gecorreleerd door request_id.

Schalen#

Diensten zijn staatloos. Om capaciteit toe te voegen, start u een andere replica van het binaire bestand en verbindt u deze met NATS. Het voegt zich bij het cluster en dient verzoeken uit wanneer het gereed is. Er is geen verkiezing van leiders en geen gedistribueerde coördinatie.

Om verder te gaan#