thomas@hammoudi:~/dev$

La carte de tous mes services, vérifiée contre le réel

Une page dessine mes 73 services (sites, automatisations, mails…) et ce qui les relie. Un programme la compare au réel et signale tout ce qui ne colle plus.

en service · 73 services cartographiés et contrôlés, en novembre 2026 · mis à jour en

Avant
Chaque projet est documenté à part : impossible de voir ce qui casse si un service s'arrête.
Maintenant
73 services sur une page : je vois ce qui casse si l'un d'eux s'arrête.

Utile si vous faites tourner plusieurs sites et automatisations, et voulez savoir ce qui dépend de quoi.

En 3 étapes

  1. Un fichier unique décrit chaque service, chaque échange entre eux et 18 parcours complets (publier une vidéo, par exemple).
  2. Un programme compare ce fichier au réel, en lecture seule, et liste tout ce qui ne colle plus : service oublié, lien disparu.
  3. Je tranche ce qui est un vrai risque, puis la carte est corrigée et redessinée sur une page web.
La carte de mes services, une boîte par service rangée par famille. Ici, la souris passe sur n8n, mon outil d'automatisation, et allume tout ce qui en dépend.
La carte de mes services, une boîte par service rangée par famille. Ici, la souris passe sur n8n, mon outil d'automatisation, et allume tout ce qui en dépend.
$ carte-architecture-infra --schema5 étapes · 3 faits maison

Le contrôle de la carte

01

La routine

relance les deux contrôles

Claude Code

relance

02fait maison

Le contrôle

cherche les écarts, sans rien écrire

lit : Le fichier de données

avecNode.js

écarts

03

Moi

je tranche ce qui est un vrai risque

tranché

04

La mise à jour

corrige les données

écrit : Le fichier de données

Claude Code

carte à jour

05fait maison

La carte

73 services, 182 liaisons

lit : Le fichier de données

avecHTMLSVG

Les données

Le fichier de données

briques, échanges, parcours

lu par 02, 05 · écrit par 04

lit
écrit
lit

À côté

L'état réel vérifié

workflows actifs, actions

n8nGitHub Actions

fait maison

Le contrôle en direct

sauvegarde, secrets

Une carte en écart ne reçoit pas de date de vérification.

  • fait maison
  • outil du marché
  • une personne
  • les données

le détail, étape par étape

Pourquoi je l'ai fait

Derrière mes sites tournent des dizaines de services : le Blog sous WordPress, le site des apps, 65 workflows n8n actifs (des enchaînements automatiques), des GitHub Actions, des routines, Notion, l’envoi des mails. Avant de toucher à l’un d’eux, je dois savoir qui l’appelle, et ma documentation disait ce que fait chaque projet, jamais qui dépend de lui. Il me fallait un schéma de toute l’infra, facile à parcourir. Et une carte dessinée une fois ment dès le premier workflow ajouté.

Ce que ça fait, concrètement

Une page dessine toute l’infra. Chaque service a sa boîte, avec son logo, rangée dans la colonne de sa famille (pilotage, automatisation, poste local, sites, diffusion, mesure, public). Entre deux services, un seul trait : plus il est épais, plus il regroupe d’échanges, et son pointillé dit comment la donnée passe (API, webhook, flux, fichiers, mail). Je clique sur une boîte, et j’ai le détail : ce qu’elle contient, ce qu’elle reçoit et envoie, ce qui la déclenche.

En novembre 2026, ça fait 73 services reliés par 182 liaisons. En dessous, le modèle détaillé compte 240 briques (les pièces élémentaires : un workflow, une table, un plugin), 378 échanges et 18 parcours de bout en bout (publier une vidéo, par exemple).

Une seconde vue recolore la carte selon une question : et si Claude disparaissait demain ? Réponse : 141 liaisons sur 182 continuent sans lui. J’ai tout raconté dans Si Anthropic s’arrête demain.

Comment ça marche, en détail

Fabrication : 240 briques, 378 échanges, 18 parcours, un seul fichier de données

Tout part d’un seul fichier de données. La page, elle, ne contient aucune donnée : elle dessine ce fichier en SVG (une image vectorielle) et place les boîtes à l’ouverture, pour que les traits soient les plus courts possible. Ensuite, un programme compare ce fichier au réel, sans rien y toucher (il est en lecture seule), et liste les écarts. Un seul écart, et il sort en erreur. Et tant qu’il en reste un, la carte ne reçoit pas de date de vérification : pas question d’afficher « vérifiée » sur une carte fausse.

Le fichier de données : deux étages, une flèche qui suit la donnée, une preuve par échange

Un fichier JavaScript décrit les briques (un workflow, un plugin, une table, un service), leurs échanges et les parcours. On décrit d’abord les briques et leurs échanges, puis on range chaque brique dans une boîte : la carte se déduit du détail, jamais l’inverse. Les flèches suivent la donnée, et non celui qui appelle : quand n8n va chercher des vidéos dans une banque d’images, la flèche part de la banque. Chaque échange cite sa preuve, et ce qui est déduit sans avoir été vérifié est marqué comme tel.

Et la carte ne se remplit ni de mémoire ni depuis la documentation : il a fallu auditer chaque couche en direct (DNS, hébergeurs, base, cache, comptes). Sans ça, des briques entières manquaient à l’appel.

Le vérificateur : cohérence, carte, GitHub Actions et n8n en direct

Un script Node.js, en lecture seule, contrôle :

  • La cohérence : identifiant en double, échange vers une brique absente, parcours qui cite un échange inconnu ;
  • La carte : chaque brique tombe dans une seule boîte, chaque logo et chaque document cité existent ;
  • Les GitHub Actions : chaque workflow du site des apps est sur la carte ;
  • n8n, en direct par son API : chaque workflow actif est cité, chaque workflow cité existe, et son état correspond.

En novembre 2026, il a attrapé un workflow actif, créé depuis le dernier passage, qui n’était pas sur la carte.

Le contrôle en direct : hébergeurs, sauvegarde des automatisations, secrets en clair

Un second script interroge les hébergeurs, vérifie que la sauvegarde des automatisations a bien tourné et qu’aucun secret ne traîne en clair dans un workflow. Les valeurs attendues, il les lit dans la carte.

La mise à jour : Claude Code corrige, un script date, une régression remonte dans le rapport

Une routine relance les deux contrôles. Si le réel a bougé, Claude Code corrige le fichier de données, puis un script recopie la date et les chiffres dans la documentation, et ce script refuse d’écrire tant qu’un contrôle échoue. Une régression, en revanche (une sauvegarde en panne, par exemple), ne se corrige pas en redessinant la carte : elle remonte dans le rapport, et la décision me revient.

Le rôle de chaque pièce

Les 5 étapes du schéma, une par une
  1. La routineClaude Code Une routine relance les deux contrôles, puis Claude Code met la carte à jour.
  2. Le contrôleNode.jsfait maison Contrôle la cohérence, la carte, les GitHub Actions et chaque workflow n8n actif. Code d'erreur dès qu'il y a un écart.
  3. Moi Une régression, comme une sauvegarde en panne, ne se corrige pas sur la carte : elle remonte, et je tranche.
  4. La mise à jourClaude Code Claude Code corrige le fichier de données, puis un script recopie la date et les chiffres. Il refuse tant qu'un contrôle échoue.
  5. La carteHTML · SVGfait maison Une boîte par service, un trait par paire, le détail au clic, la vue « sans Claude ».

# mémoires

  • Le fichier de données Décrit chaque service, chaque échange et chaque parcours. La page ne contient aucune donnée.

# à côté

  • L'état réel vérifién8n · GitHub Actions Le contrôle confronte la carte à n8n et aux GitHub Actions, en lecture seule.
  • Le contrôle en directfait maison Vérifie que la sauvegarde des automatisations a tourné et qu'aucun secret n'est en clair.

Ce que vous pouvez reprendre chez vous

La carte complète reste privée : elle en dit trop sur la façon d’entrer chez moi. Une version publique, simplifiée, sans accès ni réglages, est sur la page Ce que j’utilise.

Pour dresser la vôtre : un seul fichier de données, une page qui le dessine, un script qui le confronte au réel par les API des services, et un autre qui refuse de dater une carte en écart.

Ce que j'en retiens

La première version, en octobre 2026, tirait un trait pour chaque échange. Mon verdict : complètement illisible, un gros paquet avec des traits partout. Une boîte par service, un trait par paire, le détail au clic, et elle est devenue utile.

Et une carte ne voit que ce qu’on a audité. La première marquait en rouge « pas de vraie sauvegarde des fichiers ». J’en avais, elle ne les voyait juste pas. Depuis, un « il n’y a pas » est d’abord une question.

Images

  • Vue d'ensemble : 73 services et toutes leurs liaisons, du pilotage à gauche jusqu'au public à droite.
    Vue d'ensemble : 73 services et toutes leurs liaisons, du pilotage à gauche jusqu'au public à droite.

tous les projets