Générateur de diagrammes

/diagrams génère des diagrammes d’architecture visuels à partir des données de topologie sans utiliser Visio ou draw.io. La chaîne de traitement :

nœuds de topologie + arêtes + zones
        │
        ▼ filtre de portée (env / type / id / seuls les éléments gérés)
        │
        ▼ moteur de disposition (hiérarchique | force | concentrique | zone)
        │
        ▼ stylage (couleur par environnement pour chaque nœud, couleur d'encodage pour chaque arête)
        │
        ▼ optionnel : analyse AI Ollama → résumé + risques
        │
        ▼ canevas React Flow (drag-to-edit, sauvegarder avec historique de versions)
        │
        ▼ exporter PNG | SVG | PDF | Mermaid

Algorithmes de disposition

Algorithme	Quand utiliser
hiérarchique	Architecture à plusieurs niveaux, flux de requête, pare-feu → chaînes de serveurs. Coffman-Graham BFS, tri déterministe par niveau
force	Réseaux en mosaïque, microservices, topologies organiques. Fruchterman-Reingold, 300 itérations, arêtes critiques tirées 2 fois plus fortement
concentrique	Visualisation de la zone d’impact, analyse de dépendance. Nœud focal dans le centre, anneaux 1/6/12/18/24
zone	Documentation de conformité, segmentation réseau. Bandes de natation par environnement dans l’ordre fixe (internet → dmz → prod → …)

Types de diagrammes

Type	Filtrage
`architecture`	tous les nœuds (par défaut)
`network_flow`	tous les nœuds, arêtes montrées avec direction
`dependency`	3-hop BFS à partir de l’ID de nœud focal
`compliance_zone`	bandes de natation par environnement, avec rectangles de groupe
`blast_radius`	disposition concentrique à partir du nœud focal
`data_flow`	tous les nœuds avec traffic_profile=continu = animation

Modèles

5 modèles intégrés prêts à être clonés :

3-Tier Web Application — Internet → Pare-feu → LB → Serveurs Web → DB
Microservices — API Gateway avec 4 services backend + DB
Réseau Hub & Spoke — hub centrale avec 4 emplacements de branche via IPsec
Architecture Zero Trust — Provider d’identité + IAP + applications + SIEM
Configuration DR/Backup — Production + Réplica DR + stockage S3 à distance + monitoring

POST /api/v1/diagrams/from-template/:id clone un modèle en nouveau diagramme.

Analyse AI (Ollama)

Lorsque include_ai: true, le générateur effectue une seule appelle Ollama avec la liste complète de nœuds et d’arêtes plus des statistiques (arêtes non cryptées, arêtes critiques, lacunes de conformité). Le modèle LLM fournit :

{
  "résumé": "2-3 phrases résumant l'architecture",
  "risques": [
    { "gravité": "élevée", "description": "…", "remédiation": "…" }
  ]
}

Timeout 60 sec, modèle llama3.1:8b, exécuté localement dans la même stack Docker (pas de fournisseur AI externe). En cas d’erreur de parsing de la réponse LLM, le système revient à l’extrait brut en tant que résumé.

Export

Format	Comment
PNG	côté client via `html-to-image`, 2× ratio pixel pour qualité retina
SVG	côté client via `html-to-image`’s `toSvg`
PDF	PNG intégré dans `jsPDF` en mode paysage 1920×1080
Mermaid	côté serveur via `/api/v1/topology/export/mermaid`
Partage	lien de lecture seule publique via `POST /api/v1/diagrams/:id/share` — token 32 caractères sécurisé, pas d’expiration, ID tenant supprimé de la réponse

API

Méthode	Chemin
`GET /api/v1/diagrams`	liste des diagrammes + comptes de nœuds/edges
`POST /api/v1/diagrams/generate`	disposition + stylage + optionnel auto_save
`GET /api/v1/diagrams/templates`	modèles intégrés + modèles tenant
`POST /api/v1/diagrams/from-template/:id`	cloner un modèle
`GET /api/v1/diagrams/:id` · `PUT` · `DELETE`	CRUD avec historique de versions lors du PUT
`POST /api/v1/diagrams/:id/share` · `unshare`	lien de partage publique toggle
`GET /api/v1/diagrams/share/:token`	lecture seule (pas d’auth)

Historique de version

Chaque PUT /diagrams/:id snapshot la version précédente vers diagram_versions avec un résumé de changement. Pas d’interface pour afficher des diff (sur la feuille de route), mais les données sont là pour le retraitement forensique.

Limites

Pas de collaboration en temps réel — plusieurs éditeurs surchargent les modifications les uns des autres. Travail par personne, utilisez les snapshots comme points de synchronisation.
Pas d’export XML draw.io — Mermaid est disponible ; draw.io peut importer Mermaid.
Annotions AI par nœud ne sont pas encore disponibles — seul le résumé tenant et les risques.
Minimisation des passages — disposition hiérarchique ne fait pas d’optimisation de passage Sugiyama. Pour les diagrammes avec 50+ nœuds, nous recommandons la disposition zone ou force.