FlowZap - Not another Diagramming tool

FlowZap est conçu pour les travailleurs de tous les secteurs de votre organisation — comptables, représentants du service client, responsables de production — qui veulent modéliser des processus rapidement, clairement, et sans jargon technique. Voici votre guide pas-à-pas pour écrire et modifier le Code FlowZap, le langage simple qui alimente vos diagrammes.

Qu’est-ce que le Code FlowZap ?

Le Code FlowZap est une façon très directe de décrire visuellement un flux de travail. Vous écrivez quelques lignes courtes pour définir des étapes (nodes), les connecter (edges) et organiser le tout dans des couloirs (lanes) qui correspondent à vos équipes ou rôles. Aucune compétence de programmation n’est requise.

1. Organiser votre processus avec des rangées

Pensez aux rangées comme des rangées dans votre diagramme, chacune représentant une équipe, un service ou un rôle. Chaque rangée regroupe les étapes qui lui appartiennent.

lane1 {
  ...nodes...
  ...edges...
}

lane2 {
  ...nodes...
  ...edges...
}

Le nom de la rangée (lane1, lane2, …) est libre.
Utilisez des noms explicites qui ont du sens pour votre processus (par ex. Ventes, Comptabilité).

2. Ajouter des étapes avec des nœuds

À l’intérieur de chaque rangée, listez chaque étape de votre processus. Chaque étape est appelée un node.

n1: circle      label:"Start"
n2: rectangle   label:"Saisir les données"
n3: taskbox     owner:"Alice" description:"Vérifier la saisie" system:"FormApp"
n4: diamond     label:"Est-ce valide ?"

Comment rédiger un nœud :

ID : code court pour l’étape (n1, n2, …).
Shape : circle, rectangle, diamond ou taskbox.
Attributs :
- label:"Texte" — libellé affiché dans le diagramme.
- Pour taskbox, ajoutez : owner:"Nom", description:"Détails", system:"NomDuSystème".

Mélangez les attributs comme nécessaire, l’ordre n’a pas d’importance.

3. Relier les étapes avec des connecteurs

Après vos nœuds, décrivez comment chaque étape se connecte à la suivante.

n1.handle(right)  -> n2.handle(left)   [label="suivant"]
n2.handle(bottom) -> n3.handle(top)

Comment rédiger un connecteur :

De : node de départ + côté de sortie (n1.handle(right)).
Vers : node d’arrivée + côté d’entrée (n2.handle(left)).
Flèche : toujours -> pour indiquer la direction.
Label (optionnel) : [label="Texte"] pour le texte du connecteur, ou laissez vide.

4. Relier des rangées entre elles

Si une étape passe d’une rangée à l’autre, préfixez simplement le nom de la rangée devant le node :

n3.handle(bottom) -> lane2.n5.handle(top) [label="Envoyer pour revue"]

5. Exemple complet

lane1 {
  n1: circle      label:"Start"
  n2: rectangle   label:"Collecter les infos"
  n3: diamond     label:"Besoin d’une revue ?"
  n4: circle      label:"End"

  n1.handle(right)  -> n2.handle(left)
  n2.handle(right)  -> n3.handle(left)
  n3.handle(top)    -> n4.handle(left)         [label="Non"]
  n3.handle(bottom) -> lane2.n5.handle(top)    [label="Oui"]
}

lane2 {
  n5: rectangle label:"Revoir les détails"
  n6: circle    label:"Fin de la revue"

  n5.handle(right) -> n6.handle(left)
}

6. Conseils et bonnes pratiques

Gardez les IDs courts : n1, n2, etc.
Aide par IA : Demandez à votre agent IA préféré de générer un premier brouillon de Code FlowZap.
Case "Auto-Layout" : cette option fait une première mise en page du diagramme ; vous pouvez l’ajuster ensuite.
Commentaires : vous pouvez ajouter des commentaires au-dessus des lanes (//), mais évitez sur les lignes d’edges.
Labels : un label de connecteur peut être vide (label="") ou omis.

Écrivez ou collez simplement votre Code FlowZap dans l’éditeur, puis cliquez sur « Mettre à jour le diagramme ». Votre processus prend vie — aucune compétence technique requise !