Architecture

Vue d'ensemble#

SpineOS repose sur une architecture à trois niveaux. Votre navigateur communique avec une couche frontend, qui délègue à un service API backend, qui orchestre des machines virtuelles sur une infrastructure bare-metal.

Les trois couches#

Frontend#

Le frontend sert le tableau de bord, la documentation et les pages marketing. Il agit également comme proxy sécurisé -- il transmet les requêtes authentifiées au service API afin que les endpoints internes ne soient jamais exposés directement au navigateur.

Quand vous ouvrez SpineOS dans votre navigateur, vous communiquez avec cette couche. Elle gère l'authentification OAuth, la gestion des sessions et le rendu de l'interface. Toute action touchant l'infrastructure -- créer un bureau, récupérer des métriques, télécharger des fichiers -- est transmise au service API.

Service API#

Le service API est une application autonome qui porte toute la logique métier. Il gère :

• Le cycle de vie des bureaux (création, démarrage, arrêt, suppression)
• L'orchestration des machines virtuelles (clonage, initialisation, health checks)
• Les opérations de fichiers via SFTP
• Les tâches Mission Control et les flux d'activité
• La facturation Stripe et la gestion des abonnements
• L'authentification par clé API pour l'accès programmatique

Le service API est le seul composant qui communique directement avec l'infrastructure cloud et les machines virtuelles. La surface d'attaque reste ainsi réduite et la frontière de confiance claire.

Infrastructure (Machines virtuelles)#

Les bureaux tournent en tant que machines virtuelles complètes sur des serveurs bare-metal dédiés. Chaque bureau est un clone d'un template pré-configuré : un environnement de bureau complet, avec gestionnaire de fenêtres et gestionnaire de fichiers, et le framework d'agent IA déjà installé.

Les VM sont isolées les unes des autres au niveau de l'hyperviseur. Chacune dispose de son propre CPU, RAM, disque et interface réseau.

Flux d'une requête#

Voici ce qui se passe quand vous créez un nouveau bureau :

1. Navigateur -- vous cliquez sur "Nouveau Bureau" et remplissez le formulaire.
2. Frontend -- valide votre session et transmet la requête au service API.
3. Service API -- vérifie votre plan d'abonnement, clone le template pré-configuré, injecte votre configuration et démarre la VM.
4. Infrastructure -- crée la VM, la démarre et renvoie le statut à l'API.
5. API -- interroge la VM jusqu'à ce qu'elle passe de "booting" à "running", puis marque ce bureau comme prêt.

L'ensemble du processus prend 30 à 60 secondes.

Connexions temps réel#

Trois fonctionnalités utilisent des connexions WebSocket persistantes au lieu du HTTP standard :

• Viewer VNC -- diffuse l'affichage du bureau dans votre navigateur en temps réel via le support WebSocket natif du serveur VNC.
• Terminal -- fournit une session shell complète dans le navigateur, sur WebSocket.
• Panneau chat -- se connecte à l'agent IA qui tourne dans la VM pour une conversation en direct.

Un proxy WebSocket se situe entre votre navigateur et les VM, authentifiant chaque connexion et routant le trafic vers la bonne machine virtuelle.

Provisionnement des VM#

Quand une nouvelle VM démarre pour la première fois, un processus d'initialisation s'exécute qui :

• Configure le compte utilisateur
• Injecte la configuration de votre fournisseur IA (clé API, sélection du modèle)
• Configure le framework d'agent IA
• Démarre les services en arrière-plan (serveur VNC, serveur terminal, gateway de l'agent)
• Active optionnellement la mémoire persistante avec les embeddings

Chaque bureau part donc de la même image de base mais reçoit une configuration personnalisée au démarrage.

Décisions de conception#

• BYOK (Bring Your Own Key) -- SpineOS ne stocke pas vos identifiants de fournisseur IA sur nos serveurs au-delà de l'injection initiale. Votre clé API va directement dans la VM.
• Clonage de template -- plutôt que d'installer des logiciels au démarrage, nous clonons un template pré-construit. Le provisionnement est rapide et reproductible.
• VM isolées -- chaque bureau est une machine virtuelle complète, pas un conteneur. L'isolation est plus forte et l'environnement plus réaliste pour les agents IA.
• Proxy sécurisé -- le frontend proxifie les appels API, ce qui garde les URLs de services internes et les tokens d'authentification hors du client.