Saltar al contenido
Logotipo de Aurabase
aurabase

Arquitectura

Cómo viaja una solicitud desde su cliente a Postgres, cómo se aíslan las organizaciones y los proyectos, y cómo escalan los servicios.

Explicación7 min leerNivel intermedioRevisado el 4 nov 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

Un backend, ocho servicios#

Aurabase es un monorepo Rust que crea ocho servicios Axum. Cada servicio tiene su propio puerto y sus propias rutas /v1/<service>/…, y los servicios se comunican entre sí a través de solicitud/respuesta NATS. Todo el tráfico de sus aplicaciones pasa por una puerta de enlace.

Un servicio puede reiniciarse, fallar o implementarse por sí solo. La puerta de enlace rastrea el estado de cada servicio con un disyuntor: después de 5 fallas en 60 segundos, responde 503 para ese servicio durante 30 segundos y luego lo intenta nuevamente.

Servicios y responsabilidades#

Cada servicio posee un dominio, sus propias migraciones SQL y sus propios datos. Sus aplicaciones les llegan sólo a través de la puerta de enlace.

ServicioDominioResponsabilidades
aura-gatewayPuerta de enlace APIProxy, middleware de autenticación, limitación de velocidad, disyuntor
aura-authAutenticaciónRegistro, inicio de sesión, OAuth 2.1, TOTP MFA y WebAuthn, sesiones, JWKS
aura-dbBase de datosCRUD sobre PostgREST, migraciones versionadas, generación de tipos, gestión de esquemas
aura-realtimeEn tiempo realWebSocket, SSE, retransmisión de eventos, presencia, Postgres cambiar captura de datos
aura-storageAlmacenamientoS3: almacenamiento de objetos compatible, carga multiparte, URL firmadas, transformaciones de imágenes
aura-functionsEdge FunctionsTiempos de ejecución WASM y Deno, cron, cola de trabajos asíncronos, cola de mensajes fallidos
aura-notificationsNotificacionesCorreo electrónico transaccional (SMTP), SMS, push móvil, webhooks firmados por HMAC
aura-aiPuerta de enlace de IAInferencia LLM a través de un punto final, incrustaciones, RAG con pgvector

Aislamiento por organización y proyecto.#

Cada organización obtiene su propio clúster PostgreSQL, provisto de CloudNativePG (CNPG) en un espacio de nombres de Kubernetes reservado para ella. No se comparte ningún clúster, espacio de nombres o grupo de conexiones entre dos organizaciones. La capacidad del cluster (vCPU, memoria, réplicas) sigue el plan de la organización.

Dentro de ese clúster, cada proyecto obtiene su propia base de datos Postgres, dividida en cuatro esquemas. Cada proyecto tiene su propio rol de conexión, que es miembro únicamente de sus propios roles. Los derechos sobre los esquemas de un proyecto se otorgan a esos roles y nunca a PUBLIC. La puerta de enlace establece la conexión search_path del proyecto en el JWT del cliente y las tablas de la aplicación están protegidas por seguridad a nivel de fila (RLS).

En la oferta empresarial, un proyecto también puede obtener un clúster CNPG dedicado en su propio espacio de nombres. El aislamiento proviene entonces de la separación física de los clusters, además de los permisos.

esquemapropietarioContenido
project_{uuid}tuTus tablas de aplicaciones
project_{uuid}_authaura-authusers, sessions, oauth_accounts, mfa
project_{uuid}_storageaura-storagebuckets, objects, rls_policies
project_{uuid}_platformplataformafunctions, jobs, cron, api_keys, webhooks

Siguen tres consecuencias:

  • Sin acceso entre inquilinos. Dos organizaciones nunca comparten un clúster, un espacio de nombres o un grupo de conexiones.
  • Migraciones independientes. Cada proyecto migra y retrocede por sí solo.
  • Exportación simple. pg_dump --schema='project_*' vuelca los datos, extensiones y políticas de un proyecto.
Esquema compartido

El esquema aura_console es compartido. Contiene la tabla projects y las sesiones de Studio. No pasa ningún dato de la aplicación.

De rizo a Postgres#

La puerta de enlace verifica cada solicitud antes de enrutarla. Esta es la ruta de GET /v1/db/{projectId}/devices desde un cliente REST:

ruta de solicitudtext
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 paso escribe registros estructurados con tracing, correlacionados por request_id.

Escalado#

Los servicios son apátridas. Para agregar capacidad, inicie otra réplica del binario y conéctelo a NATS. Se une al clúster y atiende solicitudes cuando está listo. No hay elección de líder ni coordinación distribuida.

para ir más lejos#