Accueil › Architecture & design patterns › Le coût de l'indirection, et quand il est justifié
Le coût de l'indirection, et quand il est justifié
Ports, adaptateurs et hexagoneintermediaire
L'hexagone se paie, et le prix est immédiat.
Un appel qui était une ligne devient un port, un adaptateur, une traduction et un branchement dans le point de composition. Le pas à pas au débogueur traverse maintenant trois fichiers pour atteindre la requête SQL. La recherche « qui implémente ce contrat » remplace le clic qui menait directement au code.
// avant : une ligne, tout est là, rien ne se teste sans base
const client = await pool.query("SELECT * FROM clients WHERE id=$1", [id]);
// après : trois fichiers, et un domaine qui se teste en mémoire
// domaine/port/clients.js → parId(id)
// infra/sql/depotClients.js → implémente parId, traduit la ligne
// main.js → branche l'un sur l'autre
Ce coût est réel. Il devient rentable quand au moins un de ces faits est vrai : la dépendance est volatile (fournisseur externe, format imposé par un tiers), elle rend les tests lents ou datés, ou une deuxième implémentation existe déjà — en test, en lot, sur un autre canal d'entrée.
Pour un service qui lit une table et la renvoie en JSON, sans règle et sans variation attendue, l'hexagone ajoute des fichiers et n'achète rien.
Les termes à connaître
- Coût d'indirection
Ce que l'hexagone fait payer à chaque lecture : des fichiers en plus, une traduction aux frontières, et un pas de débogage supplémentaire par frontière franchie.
- Traduction de frontière
Le code qui convertit une ligne de base ou un corps de requête en objet du domaine, et retour. Il est ennuyeux à écrire et nécessaire à maintenir.
- Signal de déclenchement
Le fait observable qui justifie d'isoler le domaine : une deuxième implémentation, un test lent, un fournisseur externe volatil.
- Architecture en oignon
Une variante de Jeffrey Palermo : les mêmes dépendances vers le centre, exprimées en anneaux concentriques plutôt qu'en côtés.
- Clean architecture
La formulation de Robert C. Martin, qui ajoute un vocabulaire d'entités, de cas d'usage et une règle explicite de franchissement des frontières.
- Hexagone de façade
Un projet qui a les dossiers et les interfaces, mais dont le domaine importe encore l'infrastructure. Il paie le coût sans toucher le bénéfice.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.