Guide de syntaxe du parcours utilisateur Mermaid.js

Un diagramme de parcours utilisateur décrit les étapes que l’utilisateur suit pour atteindre un objectif spécifique au sein de votre application. Contrairement aux organigrammes centrés sur les systèmes ou aux diagrammes de séquence, les parcours utilisateurs se concentrent sur les actions humaines, les étapes du flux de travail et le suivi de la satisfaction de l’utilisateur au fil du temps.

Structure de syntaxe de base

Chaque parcours utilisateur commence par la déclaration journey déclaration, suivie d’un titre et de sections séquentielles qui décomposent l’expérience utilisateur.

journey
title Parcours utilisateur exemple
section Nom de l'étape
  Nom de la tâche : Score : Acteur1, Acteur2

Référence de syntaxe

Le tableau ci-dessous détaille les éléments principaux utilisés pour construire une carte de parcours utilisateur dans Mermaid.js.

Composant Description Exemple de syntaxe
Déclaration Initialise le rendu du diagramme de parcours utilisateur. journey
Titre Définit le titre principal ou l’objectif utilisateur en haut de la carte. title Flux de connexion
Section Représente une phase ou un stade de haut niveau du parcours utilisateur. section Phase de découverte
Tâche Une action spécifique effectuée par l’utilisateur au sein d’une section. Parcourir la documentation
Note de satisfaction Un entier compris entre 1 et 5 qui représente le plaisir ou les difficultés de l’utilisateur. : 4 : (4 sur 5)
Acteurs Liste séparée par des virgules des rôles impliqués dans la réalisation de la tâche. Utilisateur, Système

Maquette du monde réel : Expérience de paiement en ligne

Cette maquette met en évidence un parcours utilisateur complet, suivant l’expérience d’un client lors de l’achat d’un article en ligne, en repérant les points de douleur émotionnelle (faibles notes) et les moments de plaisir (hautes notes).

parcours
titre Parcours d'achat en ligne
section Découverte du produit
  Rechercher un article : 4 : Utilisateur
  Comparer les prix : 3 : Utilisateur
  Visualiser les images du produit : 5 : Utilisateur
section Funnel de paiement
  Ajouter l'article au panier : 4 : Utilisateur
  Créer un compte : 2 : Utilisateur, Système
  Saisir les coordonnées de livraison : 3 : Utilisateur
  Traiter la carte de crédit : 1 : Utilisateur, Passerelle de paiement
section Après l'achat
  Recevoir la confirmation par e-mail : 5 : Système
  Suivre la livraison du colis : 4 : Utilisateur, Logistique


Astuce de syntaxe :Les notes de satisfaction sont automatiquement colorées par le moteur de rendu. Une note de 1 ou 2 met en évidence des frictions opérationnelles (rouge/orange), une note de 3 est neutre (jaune), et les notes de 4 ou 5 représentent des interactions fluides et réussies (vert).


Concept avancé : Parcours impliquant plusieurs acteurs

Dans les flux de travail complexes, les tâches sont rarement réalisées par une seule personne. Mermaid vous permet d’attribuer plusieurs acteurs à une même tâche en séparant leurs noms par des virgules. Cela est utile pour montrer où une interaction client nécessite un support côté serveur ou une automatisation provenant d’un système.

parcours
titre Exemple de support impliquant plusieurs acteurs
section Cas de support client
  Soumettre un ticket de problème : 3 : Client
  Affecter le ticket à un agent : 4 : Système, Administrateur du support
  Investiguer un bug technique : 2 : Développeur, Testeur QA
  Résoudre le problème et informer : 5 : Administrateur du support

Péchés courants de syntaxe

Lors de l’écriture de cartes de parcours utilisateur, de petites erreurs de formatage peuvent provoquer une erreur dans le moteur de rendu. Gardez ces trois règles de formatage à l’esprit pour vous assurer que votre diagramme se construit correctement :

  • La règle des deux points doubles : Chaque ligne de tâche doit suivre exactement la structure de Description de la tâche : Note : Acteur. Oublier le deuxième deux-points avant la liste des acteurs est la raison la plus courante pour laquelle un diagramme de parcours ne parvient pas à se charger.
  • Restrictions sur la plage des notes :Les notes de satisfaction doivent être un entier compris entre 1 et 5. Passer une note de 0 ou un nombre supérieur à 5 rompra les paramètres de mise en page.
  • Indentation : Bien que Mermaid soit souple concernant les espaces, garder vos tâches indentées sous leurs sections respectives rend vos fichiers texte bruts bien plus faciles à lire et à maintenir à mesure que les fonctionnalités de votre produit évoluent.
Retour en haut