CTX-03 · Le code suit le glossaire du bounded context

Style

Les deux styles

Sévérité

majeureMajeure pour un terme rejeté ou un double nom. Question pour un terme absent. Sans glossaire (voir Mettre en place un projet), la règle est inactive, et la revue le signale dans son résumé.

S’applique à

• Modèle (domain)
• Use cases (application)
• Adapters driving

Signal

• Un terme que le glossaire du bounded context marque comme rejeté apparaît dans le code du domaine, de l’application ou de l’API de ce bounded context.
• Un même concept porte deux noms entre le code, l’API et les tests.
• Un nouveau terme métier apparaît dans le domaine, mais pas dans le glossaire.

Pourquoi

Le but est zéro traduction entre les experts métier, les développeurs et le code, pas seulement moins de traductions. Un concept absent du langage convenu du bounded context est rejeté.

Exceptions

Les glossaires et les diagrammes vieillissent. Seuls le code et la façon dont l’équipe parle reflètent toujours le langage actuel. Un terme absent du glossaire n’est donc pas toujours un défaut : le glossaire peut être en retard.

Un terme rejeté dans un bounded context reste libre dans un autre (CTX-01).

Correction

• Terme rejeté ou double nom : renommer.
• Terme absent : demander s’il faut compléter le glossaire ou renommer.