Formations — 1 037 leçons en français

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.

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.