Ir para o conteúdo
Aura Logo
aurabase

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.

Explicação7 min lidoNível intermediárioRevisado em 4 de nov. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

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çoDomínioResponsabilidades
aura-gatewayGateway de APIProxy, middleware de autenticação, limitação de taxa, disjuntor
aura-authAutenticaçãoInscrição, login, OAuth 2.1, TOTP MFA e WebAuthn, sessões, JWKS
aura-dbBanco de dadosCRUD sobre PostgREST, migrações versionadas, geração de tipos, gerenciamento de esquemas
aura-realtimeTempo realWebSocket, SSE, retransmissão de eventos, presença, Postgres captura de dados alterados
aura-storageArmazenamentoS3- armazenamento de objetos compatível, multipart upload, URLs assinados, transformações de imagem
aura-functionsEdge FunctionsTempos de execução WASM e Deno, cron, fila de tarefas assíncronas, fila de mensagens não entregues
aura-notificationsNotificaçõesE-mail transacional (SMTP), SMS, push móvel, webhooks assinados por HMAC
aura-aiGateway de IAInferê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.

EsquemaProprietárioConteúdo
project_{uuid}vocêSuas tabelas de aplicativos
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformplataformafunctions, 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.
Esquema compartilhado

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:

caminho da solicitaçãotext
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#