Aller au contenu principal

Organisation par Projets et Tags

Au-delà d'un certain nombre de flux, la clarté de l'organisation ne se fait pas dans l'éditeur mais en amont : le choix des Apps, des tags et des noms détermine ce qu'on retrouve, ce qu'on maintient et ce que la cartographie des échanges montre. Pour créer des Apps et des ressources, voir Ressources.

Comment ça s'articule​

Les Apps : regrouper par système​

Créez une App pour chaque système externe avec lequel vous interagissez :

  • Shopify (e-commerce)
  • SAP (ERP)
  • Mailchimp (marketing)

Chaque App regroupe les ressources liées à ce système et alimente la cartographie des échanges de données. Associez l'App aux objets qui touchent le système :

ÉlémentOù associerPourquoi
DéclencheursChamp « App »Identifier la source des données
Nœuds HTTPChamp « App »Identifier le système appelé
RessourcesChamp « App »Regrouper les actions par système

Les tags : faciliter la recherche​

Définissez une convention de tags partagée par l'équipe, par exemple :

  • Par domaine : commandes, stocks, clients
  • Par type : api, batch, realtime
  • Par priorité : critique, standard

Quand utiliser quoi​

La nomenclature ci-dessous est une recommandation d'équipe, pas une règle du produit : l'essentiel est qu'elle soit stable et partagée pour que la recherche et les traces restent lisibles.

Déclencheurs — [type]-[domaine]-[action] :

  • api-commandes-creation
  • file-produits-import
  • cron-stocks-sync-daily
  • webhook-paiements-confirmation

Flux — [action]-[domaine]-[détail] :

  • traiter-commande-ecommerce
  • synchroniser-stocks-erp
  • envoyer-notification-client

Nœuds — nommez les nœuds d'un flux de façon descriptive (Récupérer les détails commande, Valider le montant, Envoyer vers ERP) : un flux aux nœuds bien nommés se maintient beaucoup plus facilement. Utilisez les Notes pour documenter une partie complexe ou grouper visuellement des nœuds liés.

Ce qu'il faut savoir avant de commencer​

App immuable

Une fois créée, le nom de l'App ne peut plus être modifié et l'App ne peut pas être supprimée. Choisissez bien vos noms.

Avant de déployer
  • Une App est créée pour chaque système
  • Les tags sont utilisés de manière cohérente
  • Les nœuds des flux sont renommés
  • Les Notes documentent les parties complexes

Aller plus loin​

Voir aussi : Ressources