Arquitetura
Como uma solicitação viaja do seu cliente para Postgres, como as organizações e projetos são isolados e como os serviços são escalonados.
Um back-end, oito serviços#
Aurabase é um monorepo Rust que constrói oito serviços Axum. Cada serviço tem sua própria porta e suas próprias rotas /v1/<service>/…, e os serviços se comunicam entre si por meio de solicitação/resposta NATS. Todo o tráfego dos seus aplicativos passa por um gateway.
Um serviço pode reiniciar, travar ou ser implantado sozinho. O gateway rastreia a integridade de cada serviço com um disjuntor: após 5 falhas em 60 segundos, ele responde 503 para esse serviço por 30 segundos e depois tenta novamente.
Serviços e responsabilidades#
Cada serviço possui um domínio, suas próprias migrações SQL e seus próprios dados. Seus aplicativos os alcançam somente através do gateway.
| Serviço | Domínio | Responsabilidades |
|---|---|---|
aura-gateway | Gateway de API | Proxy, middleware de autenticação, limitação de taxa, disjuntor |
aura-auth | Autenticação | Inscrição, login, OAuth 2.1, TOTP MFA e WebAuthn, sessões, JWKS |
aura-db | Banco de dados | CRUD sobre PostgREST, migrações versionadas, geração de tipos, gerenciamento de esquemas |
aura-realtime | Tempo real | WebSocket, SSE, retransmissão de eventos, presença, Postgres captura de dados alterados |
aura-storage | Armazenamento | S3- armazenamento de objetos compatível, multipart upload, URLs assinados, transformações de imagem |
aura-functions | Edge Functions | Tempos de execução WASM e Deno, cron, fila de tarefas assíncronas, fila de mensagens não entregues |
aura-notifications | Notificações | E-mail transacional (SMTP), SMS, push móvel, webhooks assinados por HMAC |
aura-ai | Gateway de IA | Inferência LLM através de um endpoint, embeddings, RAG com pgvector |
Isolamento por organização e projeto#
Cada organização obtém seu próprio cluster PostgreSQL, provisionado com CloudNativePG (CNPG) em um namespace Kubernetes reservado para ela. Nenhum cluster, namespace ou pool de conexões é compartilhado entre duas organizações. A capacidade do cluster (vCPU, memória, réplicas) segue o plano da organização.
Dentro desse cluster, cada projeto obtém seu próprio banco de dados Postgres, dividido em quatro esquemas. Cada projeto tem sua própria função de conexão, que é membro apenas de suas próprias funções. Os direitos nos esquemas de um projeto são concedidos a essas funções e nunca a PUBLIC. O gateway define a conexão search_path do projeto no JWT do cliente e as tabelas do aplicativo são protegidas por segurança em nível de linha (RLS).
Na oferta empresarial, um projeto também pode obter um cluster CNPG dedicado em seu próprio namespace. O isolamento vem então da separação física dos clusters, além das permissões.
| Esquema | Proprietário | Conteúdo |
|---|---|---|
project_{uuid} | você | Suas tabelas de aplicativos |
project_{uuid}_auth | aura-auth | users, sessions, oauth_accounts, mfa |
project_{uuid}_storage | aura-storage | buckets, objects, rls_policies |
project_{uuid}_platform | plataforma | functions, jobs, cron, api_keys, webhooks |
Seguem três consequências:
- Sem acesso entre locatários. Duas organizações nunca compartilham um cluster, um namespace ou um pool de conexões.
- Migrações independentes. Cada projeto migra e reverte sozinho.
- Exportação simples.
pg_dump --schema='project_*'despeja dados, extensões e políticas de um projeto.
O esquema aura_console é compartilhado. Ele contém a tabela projects e as sessões do Studio. Nenhum dado do aplicativo passa por ele.
De ondulação para Postgres#
O gateway verifica cada solicitação antes de encaminhá-la. Este é o caminho de GET /v1/db/{projectId}/devices de um cliente 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
Cada etapa grava logs estruturados com tracing, correlacionados por request_id.
Dimensionamento#
Os serviços são apátridas. Para adicionar capacidade, inicie outra réplica do binário e conecte-a a NATS. Ele se junta ao cluster e atende solicitações quando está pronto. Não há eleição de líderes nem coordenação distribuída.
Para ir mais longe#
- Banco de dados
Postgres, esquemas, migrações, RLS, geração de tipo TypeScript
- Autenticação
OAuth, MFA, ciclo de vida da sessão, RBAC
- Tempo real
WebSocket, SSE, presença, alterações Postgres
- Armazenamento
S3- buckets compatíveis, transformações, URLs assinados
- Edge Functions
Tempos de execução WASM e Deno, cron, fila de mensagens não entregues
- Convenções
Nomenclatura de esquemas, colunas e políticas RLS