Risu Server
Un panneau auto-hébergé pour cartographier ses serveurs, les services qui tournent dessus et ce qui dépend de quoi.
Le contexte
Été 2025, chez Kalya Santé. Je m'occupais des serveurs en plus du développement, et il me manquait un endroit où voir d'un coup d'œil quels services tournaient où, et ce qui dépendait de quoi.
La question qui m'intéressait se pose toujours avant de toucher à une machine : si j'arrête cette base une heure pour la mettre à jour, qu'est-ce qui tombe avec ? Les outils de supervision répondent très bien à « qu'est-ce qui est en panne ». Aucun ne dit ce qui va l'être.
Risu Server (risu, c'est l'écureuil en japonais) est un panneau auto-hébergé qui garde cette carte à jour. J'ai commencé le 11 juin 2025, la version 1.0.0 date du 14 juillet.
Une fiche par service
Chaque service a sa fiche, avec ce qu'on cherche toujours au mauvais moment : le serveur qui l'héberge, les ports exposés, le chemin d'installation, le dépôt du code, des notes en Markdown et la date de la dernière maintenance.

La partie utile est à droite. D'un côté, ce dont le service a besoin pour fonctionner. De l'autre, tous ceux qui ont besoin de lui. Chaque lien porte un niveau (critique, optionnel ou solution de repli), parce que perdre son cache et perdre sa base de données ne se valent pas.
Un contrôle empêche aussi de créer une boucle. Si A dépend de B, Risu refuse que B dépende de A, même par trois intermédiaires.
La carte
Le tableau de bord dessine l'ensemble. Les serveurs sont des boîtes avec leurs services rangés dedans. Les traits sont les dépendances.

L'historique Git garde une trace honnête de la bagarre. Le 12 juin, un commit s'appelle « feat: ouais ouais ouais ». Le suivant, le même jour, « feat: good graph ». Entre les deux, j'ai abandonné une première bibliothèque de graphes pour Cytoscape, qui sait dessiner des nœuds à l'intérieur d'autres nœuds. La première traîne d'ailleurs encore dans les dépendances du projet, je ne l'ai jamais retirée.
Un serveur peut aussi avoir un parent, ce qui sert à représenter une machine virtuelle posée sur un hôte physique.

Les captures de cette page montrent une infrastructure inventée pour l'occasion. Les adresses IP sortent des plages réservées à la documentation.
Ce que Risu ne fait pas
Il ne surveille rien, et je préfère l'écrire ici que le laisser découvrir dans le code. Le champ « URL de contrôle » existe, la route qui renvoie l'état des serveurs aussi, mais elle tire cet état au hasard : 95 % de chances d'être « en ligne ». C'était un bouche-trou en attendant de brancher de vraies sondes, et je ne l'ai jamais remplacé.
Savoir si un service répond, des outils comme Uptime Kuma le font déjà très bien, et mieux que ce que j'aurais écrit. Ce qu'ils n'ont pas, c'est la carte des dépendances. C'est la partie de Risu qui vaut quelque chose.
Le dépôt n'a plus bougé depuis août 2025.
Autour de la carte
La connexion passe uniquement par OAuth. Les adresses du fournisseur d'identité et la correspondance des champs se règlent par variables d'environnement, donc Risu se branche sur le système de connexion qu'une équipe a déjà, sans stocker un seul mot de passe.
Un script peut lire et alimenter la carte par une API REST, avec des clés dont seule l'empreinte est conservée en base. Sa documentation Swagger est générée à partir des routes.
Côté installation, le projet fournit une image Docker et un paquet Cloudron.
Ce qui est humain, ce qui est IA. Sur 97 commits, 82 sont de moi et 15 de Jules, l'agent de code de Google, à qui j'ai laissé les corvées : conteneurisation, intégration continue, erreurs TypeScript, README. L'un de ses commits s'intitule « Jules was unable to complete the task in time ». Au moins, il prévient.
Stack technique
| Couche | Technologie | Ce qu'elle fait ici |
|---|---|---|
| Serveur | AdonisJS 6 | Routes, API et connexion OAuth |
| Interface | Svelte 5 avec Inertia | Des pages Svelte servies par AdonisJS, sans API intermédiaire à maintenir |
| Données | SQLite, via l'ORM Lucid | Un seul fichier à sauvegarder |
| Graphe | Cytoscape | Les services dessinés à l'intérieur de leur serveur |
| Style | Tailwind CSS, DaisyUI 5 | Composants et thèmes |
| API | Clés d'API, Swagger généré | Lecture et écriture depuis des scripts |
| Installation | Docker, paquet Cloudron | Deux façons de l'héberger chez soi |