Aller au contenu principal

Conventions de nommage

Un nom doit être compris par un utilisateur métier et rester stable lorsque les systèmes sources changent.

Types d’entités​

  • Utilisez un nom singulier : Client, pas Clients.
  • Préférez le terme métier au nom de table : Commande, pas SAP_VBAK.
  • Évitez les suffixes de département ou de source : ClientMarketing, ClientCRM.
  • Ajoutez un qualificatif seulement lorsqu’il distingue réellement deux concepts : ContratCadre et ContratApplication.

Propriétés​

  • Employez un nom précis : dateÉchéance, pas date2.
  • Indiquez l’unité lorsqu’elle n’est pas évidente : duréeMinutes.
  • N’encodez pas le type technique dans le nom : actif, pas is_active_boolean.
  • Réservez les identifiants sources à des propriétés explicitement documentées.

Relations​

Nommez une relation avec un verbe lisible dans les deux sens : Client passe Commande et Commande est passée par Client. Évitez lié à, qui ne décrit pas le sens métier.

Compatibilité API​

Séparez le libellé affiché de l’identifiant technique stable lorsque le produit le permet. Une correction éditoriale ne doit pas casser les intégrations existantes.