Architettura
Il modo in cui una richiesta viaggia dal tuo cliente a Postgres, il modo in cui le organizzazioni e i progetti vengono isolati e la scalabilità dei servizi.
Un backend, otto servizi#
Aurabase è un monorepo Rust che crea otto servizi Axum. Ogni servizio ha la propria porta e le proprie rotte /v1/<service>/… e i servizi comunicano tra loro tramite richiesta/risposta NATS. Tutto il traffico proveniente dalle tue applicazioni passa attraverso un gateway.
Un servizio può riavviarsi, bloccarsi o essere distribuito da solo. Il gateway tiene traccia dello stato di ciascun servizio con un interruttore automatico: dopo 5 errori entro 60 secondi, risponde 503 per quel servizio per 30 secondi, quindi riprova.
Servizi e responsabilità#
Ogni servizio possiede un dominio, le proprie migrazioni SQL e i propri dati. Le tue applicazioni li raggiungono solo attraverso il gateway.
| Servizio | Dominio | Responsabilità |
|---|---|---|
aura-gateway | Portale API | Proxy, middleware di autenticazione, limitazione della velocità, interruttore automatico |
aura-auth | Autenticazione | Registrazione, accesso, OAuth 2.1, TOTP MFA e WebAuthn, sessioni, JWKS |
aura-db | Banca dati | CRUD su PostgREST, migrazioni con versione, generazione di tipi, gestione dello schema |
aura-realtime | In tempo reale | WebSocket, SSE, inoltro eventi, presenza, Postgres modifica acquisizione dati |
aura-storage | Stoccaggio | S3-archiviazione di oggetti compatibile, caricamento in più parti, URL firmati, trasformazioni di immagini |
aura-functions | Edge Functions | Runtime WASM e Deno, cron, coda lavori asincroni, coda messaggi non recapitabili |
aura-notifications | Notifiche | E-mail transazionale (SMTP), SMS, push mobile, webhook firmati HMAC |
aura-ai | Portale AI | Inferenza LLM tramite un endpoint, incorporamenti, RAG con pgvector |
Isolamento per organizzazione e progetto#
Ogni organizzazione ottiene il proprio cluster PostgreSQL, fornito con CloudNativePG (CNPG) in uno spazio dei nomi Kubernetes ad esso riservato. Nessun cluster, spazio dei nomi o pool di connessioni è condiviso tra due organizzazioni. La capacità del cluster (vCPU, memoria, repliche) segue il piano dell'organizzazione.
All'interno di quel cluster, ogni progetto ottiene il proprio database Postgres, suddiviso in quattro schemi. Ogni progetto ha il proprio ruolo di connessione, che è membro solo dei propri ruoli. I diritti sugli schemi di un progetto vengono concessi a tali ruoli e mai a PUBLIC. Il gateway imposta la connessione search_path dal progetto nell' JWT del client e le tabelle dell'applicazione sono protette dalla sicurezza a livello di riga (RLS).
Nell'offerta aziendale, un progetto può anche ottenere un cluster CNPG dedicato nel proprio spazio dei nomi. L'isolamento deriva quindi dalla separazione fisica dei cluster, oltre alle autorizzazioni.
| Schema | Proprietario | Contenuto |
|---|---|---|
project_{uuid} | tu | Le tue tabelle applicative |
project_{uuid}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, objects, rls_policies |
project_{uuid}_platform | piattaforma | functions, jobs, cron, api_keys, webhooks |
Ne conseguono tre conseguenze:
- Nessun accesso tra tenant. Due organizzazioni non condividono mai un cluster, uno spazio dei nomi o un pool di connessioni.
- Migrazioni indipendenti. Ogni progetto viene migrato e ripristinato autonomamente.
- Esportazione normale.
pg_dump --schema='project_*'scarica i dati, le estensioni e le policy di un progetto.
Lo schema aura_console è condiviso. Contiene la tabella projects e le sessioni Studio. Nessun dato dell'applicazione lo attraversa.
Dall'arricciatura a Postgres#
Il gateway controlla ogni richiesta prima di instradarla. Questo è il percorso di GET /v1/db/{projectId}/devices da 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
Ogni passaggio scrive log strutturati con tracing, correlati da request_id.
Ridimensionamento#
I servizi sono apolidi. Per aggiungere capacità, avvia un'altra replica del binario e connettila a NATS. Si unisce al cluster e serve le richieste quando è pronto. Non vi è alcuna elezione del leader e nessun coordinamento distribuito.
Per andare oltre#
- Banca dati
Postgres, schemi, migrazioni, RLS, generazione di tipi TypeScript
- Aut
OAuth, MFA, ciclo di vita della sessione, RBAC
- In tempo reale
WebSocket, SSE, presenza, Postgres modifiche
- Stoccaggio
S3- bucket compatibili, trasformazioni, URL firmati
- Edge Functions
Runtime WASM e Deno, cron, coda messaggi non recapitati
- Convenzioni
Denominazione di schemi, colonne e policy RLS