ormuzPARTNER
Accueil/Design standards

Design standards

Nodes, Agent tools et événements sont des contrats publics différents. Réutiliser des services internes est sain ; copier automatiquement leur surface d’un contrat à l’autre ne l’est pas.

Chaque interface a son intention

InterfaceOptimise pourErreur fréquente
NodeComposition explicite dans un graphe, bindings typés, routes et garanties statiques.Créer une famille CRUD complète sans use case de processus.
ToolSélection par un Agent, arguments simples à fournir, observation utile et effet borné.Copier un node 1:1 ou exposer une API générique au modèle.
ÉvénementDécrire un fait survenu et son contexte typé.Exposer le mécanisme webhook plutôt que le fait métier.

Garanties partagées

La forme des interfaces peut diverger ; leurs invariants métier restent communs.

  • types et identités canoniques ;
  • autorité de création, de champ et de transition ;
  • permissions et isolation marchand ;
  • classification et provenance des données ;
  • idempotence réelle des opérations ;
  • observabilité et contrat économique lorsqu’ils s’appliquent.

Avant de publier un contrat

  1. Prouver le cas d’usage

    Décrivez la tâche ou le résultat métier qui justifie une nouvelle surface publique.

  2. Prouver l’autorité

    Vérifiez que l’opération ne fabrique pas une décision ou un fait appartenant à un autre rôle.

  3. Borner la surface

    Définissez cardinalité, limites, erreurs, effets, répétition et contexte nécessaire.

  4. Documenter et tester

    Le contrat ne doit pas dépendre d’une connaissance implicite du code ou du fournisseur.