Architecture hexagonale
L'architecture hexagonale (ou Clean Architecture) organise une application en couches concentriques, avec le cœur métier au centre, totalement indépendant des détails techniques comme la base de données ou le framework web. Ces éléments externes ne communiquent avec le cœur qu'à travers des interfaces (« ports ») et des adaptateurs.
Ce découpage prend tout son sens quand un projet doit durer : une entreprise qui migre de MySQL vers PostgreSQL, qui change de fournisseur d'emailing, ou qui ajoute une nouvelle intégration de paiement peut le faire en ne touchant qu'un adaptateur, sans risquer de casser la logique métier. C'est aussi ce qui rend le code testable : on peut valider les règles de gestion avec des tests unitaires rapides, sans base de données ni serveur réel derrière.
Le piège est de sur-architecturer un petit projet avec cette structure alors qu'il n'a ni la durée de vie ni la complexité qui la justifient : le nombre de fichiers et d'interfaces explose pour un gain réel limité. À l'inverse, sur une reprise de projet ou un audit, l'absence totale de séparation entre logique métier et détails techniques est presque toujours le signe d'une dette qui va freiner toute évolution future.
