Compétence Draw.io Diagramme
Quand utiliser cette compétence
- L'utilisateur demande un organigramme, un schéma de processus ou un diagramme de flux de travail
- L'utilisateur demande un ERD, un diagramme de base de données ou un modèle de relations entre entités
- L'utilisateur demande un diagramme d'architecture, de système ou de composants
- L'utilisateur demande un diagramme de classes, de séquence ou UML
- L'utilisateur dit "draw.io", "diagramme", "organigramme", "visualise ce processus"
- L'utilisateur demande de mettre à jour, corriger ou étendre un fichier
.drawioexistant
OBLIGATOIRE — À lire avant de générer quoi que ce soit
- Détecter d'abord le type de diagramme — voir les références diagram-types/ avant d'écrire du XML
- Appliquer les normes de style universelles — voir
references/box-style-standards.md - Toutes les positions sont codées en dur — il n'existe pas de mise en page automatique dans le XML de draw.io
- Exécuter la boucle de révision visuelle après chaque export — voir
references/visual-review-protocol.md - Ne jamais déclarer terminé sans une passe visuelle — exporter en PNG, le lire, le corriger, répéter
Détection du type de diagramme
| L'utilisateur dit... | Fichier de référence |
|---|---|
| "organigramme", "processus", "étapes", "flux de travail", "procédure" | references/diagram-types/flowchart.md |
| "ERD", "base de données", "tables", "entités", "clé étrangère" | references/diagram-types/erd.md |
| "architecture", "système", "composants", "services" | references/diagram-types/layout.md |
| "classe", "UML", "héritage", "méthodes", "attributs" | references/diagram-types/class.md |
| "séquence", "interaction", "ligne de vie", "appels d'acteur" | references/diagram-types/sequence.md |
Flux de travail standard de génération
Étape 1 — Charger la référence du type
Lire le fichier references/diagram-types/ approprié avant d'écrire du XML.
Étape 2 — Planifier tous les éléments
Lister chaque nœud, connexion et section avant de coder. Ne pas improviser la mise en page en cours de construction.
Étape 3 — Appliquer le style universel des boîtes
Chaque nœud doit inclure les attributs d'espacement universels de references/box-style-standards.md.
Étape 4 — Créer le dossier de sortie et écrire le XML
mkdir -p ./diagrams
Enregistrer dans :
./diagrams/<nom-diagramme>.drawio
Liste de vérification avant enregistrement :
- Tous les éléments
mxCellont des identifiants numériques séquentiels uniques - L'espacement universel des boîtes est appliqué à chaque style de nœud :
spacingLeft=12;spacingRight=12;spacingTop=10;spacingBottom=10;verticalAlign=top; - Les flèches utilisent un routage enchaîné, pas de fan-out d'une seule source vers plusieurs cibles
- Écart minimum de 15 à 20 pixels entre deux boîtes (vérifier le bas de la liste des sous-éléments par rapport au haut de la section suivante)
- Hauteurs calculées avec la formule dans box-style-standards.md (×16 px par ligne à fontSize=10)
- Les panneaux de texte large (notes, descriptions) font 530 px de large ou plus — pas 460 px ou moins
- Pas de
\nlittéral dans les attributs value — utiliser
pour les sauts de ligne -
verticalAlign=topsur toutes les boîtes de contenu multiligne
Étape 5 — Exporter en PNG et exécuter la boucle de révision visuelle
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output ./diagrams/<nom>.png --scale 2 --border 30 ./diagrams/<nom>.drawio
Suivre ensuite le protocole complet dans references/visual-review-protocol.md.
Étape 6 — Livrer
Envoyer d'abord le PNG à l'utilisateur. Pour les grands diagrammes, envoyer des captures d'écran de sections (haut, milieu, bas) avant l'image complète.
Puis demander les formats supplémentaires souhaités :
Le diagramme est prêt. Quel format souhaitez-vous ?
1 — Image PNG (prête à visualiser)
2 — Fichier .drawio (éditable dans draw.io)
3 — SVG (vecteur évolutif)
4 — PDF
5 — Tout ce qui précède
Répondez avec le(s) numéro(s) de votre choix.
Pour une livraison par Drive ou des chemins de sortie personnalisés, suivre references/workflow-sop.md.
Référence CLI
# macOS — Exporter PNG (standard)
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <sortie.png> --scale 2 --border 30 <fichier.drawio>
# macOS — Exporter PNG haute résolution
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format png --output <sortie.png> --scale 3 --border 30 <fichier.drawio>
# macOS — Exporter SVG
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format svg --output <sortie.svg> <fichier.drawio>
# macOS — Exporter PDF
/Applications/draw.io.app/Contents/MacOS/draw.io --export --format pdf --output <sortie.pdf> <fichier.drawio>
# Linux / headless — Exporter PNG
xvfb-run -a drawio --export --format png --output <sortie.png> --scale 2 --border 30 <fichier.drawio>
# Linux / headless — Exporter SVG
xvfb-run -a drawio --export --format svg --output <sortie.svg> <fichier.drawio>