Architecture

Aurabase est un monorepo Rust organisé en 8 binaires Axum indépendants. Chacun écoute sur son propre port, expose ses routes HTTP /v1/<service>/…, et communique avec les autres via NATS request/reply.

Un service peut redémarrer, crash ou être déployé indépendamment. Le gateway observe la santé de chacun via un circuit breaker — après 5 échecs consécutifs sur un service, il ouvre le disjoncteur et répond 503 pendant 30 secondes, laissant le service récupérer.

Chaque service a une responsabilité unique, un binaire séparé, des migrations SQL propres et un port par défaut. En production cloud, les ports internes sont masqués derrière le gateway.

Chaque projet Aurabase reçoit quatre sous-schémas Postgres. Le cloisonnement est logique, appliqué par PostgreSQL lui-même : chaque projet possède son propre rôle de connexion, membre de ses seuls rôles, et les droits sur ses schémas ne sont accordés qu'à ceux-là — jamais à PUBLIC. Le gateway injecte le search_path de connexion à partir du JWT du client, et les tables applicatives sont protégées par RLS.

Sur les offres pro et enterprise, chaque projet dispose en plus de sa propre instance PostgreSQL : le cloisonnement y est alors assuré par la séparation des instances, pas seulement par les permissions.

Trois garanties

• Séparation physique — pas de voisin bruyant, pas de fuite cross-tenant, pas de pool partagé.
• Migrations indépendantes — chaque projet évolue à son rythme ; un rollback n'affecte que lui.
• Export trivial — pg_dump --schema=project_* rend toute votre base, extensions et policies incluses.

Le gateway valide chaque requête entrante avant de la router. Voici le chemin complet d'un GET /v1/db/{projectId}/rows?table=devices depuis un client REST.

# 1. TLS termine au load balancer (nginx/envoy)
curl → :443 → aura-gateway:8080
# 2. Middleware request_id + tracing
request_id = "req_7f3c..."   trace_id = "4a2e..."
# 3. Rate limit (token bucket par IP + clé API)
RATE_LIMIT_RPS=100   burst=200
# 4. Auth middleware — JWT decode + claims check
NATS aura.svc.auth verify_jwt → { sub, project_id, role }
# 5. Circuit breaker — service sain ?
breaker[aura-db] = CLOSED   proceed
# 6. Proxy via NATS request/reply
NATS aura.svc.db → aura-db:8082
# 7. aura-db ouvre connexion Postgres avec search_path
SET search_path TO project_a7f3_, public;
SELECT id, value FROM devices ORDER BY last_seen DESC LIMIT 50;

Les services sont sans état. Ajouter un réplica signifie démarrer un nouveau binaire et le connecter à NATS — il se rejoint le cluster automatiquement et commence à servir dès qu'il est prêt. Aucun leader, aucune élection, aucune coordination distribuée.