| Concept | Signification | Exemple Client–Commande |
|---|---|---|
| Modèle métier | Définitions partagées d'un domaine | Clients, commandes et règles de livraison |
| Type d'entité | Structure réutilisable | Client et Commande |
| Instance | Enregistrement d'un type | Client CLI-001, nommé ACME France |
| Propriété | Valeur portée par une instance | nom, montant, devise |
| Relation | Lien métier entre des entités | Client passe Commande |
| Action | Opération définie pour un usage | Préparer une intervention autorisée |
Les interfaces techniques emploient aussi ObjectType pour un type d'objet et LinkType pour un type de lien. Une propriété de référence ne suffit pas, à elle seule, à expliquer la cardinalité et le cycle de vie d'une relation métier.
Type ou instance ?
Créer le type Client définit des champs ; cela ne crée aucun client réel. Créer l'instance CLI-001 renseigne ces champs pour une occurrence. Dans le Modeler, sélectionnez Client puis ouvrez Instances pour faire cette distinction.
Changer la définition d'une propriété peut affecter les formulaires, les intégrations et les données existantes. Ajouter une contrainte n'est pas une correction automatique de toutes les anciennes instances. Vérifiez l'impact d'une évolution.
Propriété ou relation ?
Utilisez une propriété pour une valeur sans identité propre : le montant de la commande. Précisez son unité et sa devise. Utilisez une relation lorsque la cible est un concept que vous devez identifier et consulter : le Client auquel appartient la Commande.
Un nom de client stocké comme texte dans une commande ne permet pas de distinguer deux homonymes. Préférez une correspondance reposant sur un identifiant stable.
Définition, données et preuve
Le schéma indique ce qui est attendu. L'instance donne une valeur réelle. La provenance explique d'où vient cette valeur. Un document peut apporter une règle ou une justification sans être automatiquement transformé en instance.
Pour vérifier votre compréhension, retrouvez CLI-001, ouvrez sa fiche et identifiez : son type, ses propriétés renseignées, sa provenance et ses liens. Si aucun lien vers une commande n'existe, ne déduisez pas qu'il existe à partir du seul nom.
Continuez avec le quickstart interface ou le guide de conception.
