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.
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.
| Servicio | Dominio | Responsabilidades |
|---|---|---|
aura-gateway | Puerta de enlace API | Proxy, middleware de autenticación, limitación de velocidad, disyuntor |
aura-auth | Autenticación | Registro, inicio de sesión, OAuth 2.1, TOTP MFA y WebAuthn, sesiones, JWKS |
aura-db | Base de datos | CRUD sobre PostgREST, migraciones versionadas, generación de tipos, gestión de esquemas |
aura-realtime | En tiempo real | WebSocket, SSE, retransmisión de eventos, presencia, Postgres cambiar captura de datos |
aura-storage | Almacenamiento | S3: almacenamiento de objetos compatible, carga multiparte, URL firmadas, transformaciones de imágenes |
aura-functions | Edge Functions | Tiempos de ejecución WASM y Deno, cron, cola de trabajos asíncronos, cola de mensajes fallidos |
aura-notifications | Notificaciones | Correo electrónico transaccional (SMTP), SMS, push móvil, webhooks firmados por HMAC |
aura-ai | Puerta de enlace de IA | Inferencia 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.
| esquema | propietario | Contenido |
|---|---|---|
project_{uuid} | tu | Tus tablas de aplicaciones |
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 |
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.
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:
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#
- Base de datos
Postgres, esquemas, migraciones, RLS, TypeScript generación de tipos
- autenticación
OAuth, MFA, ciclo de vida de la sesión, RBAC
- En tiempo real
WebSocket, SSE, presencia, cambios Postgres
- Almacenamiento
S3: depósitos compatibles, transformaciones y URL firmadas
- Edge Functions
Tiempos de ejecución WASM y Deno, cron, cola de mensajes fallidos
- Convenciones
Denominación de esquemas, columnas y políticas RLS