Architectuur
Hoe een verzoek van uw klant naar Postgres reist, hoe organisaties en projecten geïsoleerd zijn en hoe services worden geschaald.
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.
| Dienst | Domein | Verantwoordelijkheden |
|---|---|---|
aura-gateway | API-gateway | Proxy, authenticatie-middleware, snelheidsbeperking, stroomonderbreker |
aura-auth | Authenticatie | Aanmelden, aanmelden, OAuth 2.1, TOTP MFA en WebAuthn, sessies, JWKS |
aura-db | Database | CRUD over PostgREST, versiebeheermigraties, typegeneratie, schemabeheer |
aura-realtime | Realtime | WebSocket, SSE, gebeurtenisrelais, aanwezigheid, Postgres vastleggen van wijzigingsgegevens |
aura-storage | Opslag | S3-compatibele objectopslag, multipart-upload, ondertekende URL's, afbeeldingstransformaties |
aura-functions | Edge Functions | WASM en Deno runtimes, cron, asynchrone taakwachtrij, wachtrij voor dode letters |
aura-notifications | Meldingen | Transactionele e-mail (SMTP), sms, mobiele push, HMAC-ondertekende webhooks |
aura-ai | AI-gateway | LLM-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.
| Schema | Eigenaar | Inhoud |
|---|---|---|
project_{uuid} | jij | Uw toepassingstabellen |
project_{uuid}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, objects, rls_policies |
project_{uuid}_platform | platform | functions, 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.
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:
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#
- Database
Postgres, schema's, migraties, RLS, TypeScript typegeneratie
- Aut
OAuth, MFA, sessielevenscyclus, RBAC
- Realtime
WebSocket, SSE, aanwezigheid, Postgres wijzigingen
- Opslag
S3-compatibele buckets, transformaties, ondertekende URL's
- Edge Functions
WASM en Deno runtimes, cron, wachtrij voor dode letters
- Conventies
Naamgeving van schema's, kolommen en RLS-beleid