Accueil › Architecture & design patterns › Le domaine au centre, l'infrastructure au bord
Le domaine au centre, l'infrastructure au bord
Ports, adaptateurs et hexagoneintermediaire
L'architecture hexagonale pose une seule règle, et tout le reste en découle : les dépendances pointent vers le domaine, jamais l'inverse.
Le domaine contient ce que l'application décide. L'infrastructure contient ce qui la relie au monde : HTTP, SQL, fichiers, horloge, messagerie. Entre les deux, des contrats possédés par le domaine.
// ❌ le domaine connaît sa base
import { pool } from "../infra/postgres.js";
export async function cloturer(idCommande) {
const c = await pool.query("SELECT * FROM commandes WHERE id = $1", [idCommande]);
// ... la règle métier est noyée dans le transport
}
// ✅ le domaine ne connaît qu'un vocabulaire qu'il a écrit
export function cloturer(commande, horloge) {
if (commande.lignes.length === 0) return { ok: false, motif: "commande vide" };
return { ok: true, commande: { ...commande, closeLe: horloge.maintenant() } };
}
La seconde version ne mentionne ni Postgres, ni Date, ni Express. Elle se
teste en une ligne, sans conteneur ni serveur. L'infrastructure vient se
brancher dessus au démarrage, dans un fichier unique.
Le nom « hexagone » n'a aucune valeur technique : Cockburn voulait une figure avec plusieurs côtés, pour montrer qu'une application a plusieurs points de branchement — et pas seulement un dessus et un dessous. Le nom qu'il juge plus juste est d'ailleurs « ports et adaptateurs ».
Les termes à connaître
- Architecture hexagonale
Un style décrit par Alistair Cockburn, aussi appelé « ports et adaptateurs » : le domaine est au centre, tout ce qui parle au monde extérieur est branché autour de lui.
- Domaine
Les règles de l'application : ce qu'elle décide, ce qu'elle calcule, ce qu'elle refuse. Il ne contient aucun appel à une base, un fichier ou un réseau.
- Infrastructure
Tout ce qui est remplaçable sans que le métier change d'avis : base de données, HTTP, file de messages, horloge, système de fichiers.
- Règle de dépendance
Les flèches de dépendance pointent toutes vers le centre. Le domaine ne nomme jamais un module d'infrastructure.
- Hexagone
La forme n'a aucune signification mathématique : six côtés suggèrent simplement plusieurs points de branchement, pas une hiérarchie haut/bas.
- Adaptateur
Le code qui traduit entre une technologie précise et un contrat du domaine. C'est le seul endroit où un nom de bibliothèque apparaît.
- Point de composition
Le fichier de démarrage qui instancie les adaptateurs et les branche sur le domaine. Il connaît tout le monde ; personne ne le connaît.
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.