Formations — 1 037 leçons en français

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.

Lire l'explication détaillée et faire le quiz →

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.