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 isolés. L'isolation est physique : aucune requête ne peut traverser les frontières sans consentement explicite. Le gateway injecte le search_path de connexion à partir du JWT du client.

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.