Architecture Hexagonale : le guide pratique pour une clean architecture

Shodo vous accompagne de la compréhension métier à la production à travers notre approche socio-technique : aligner business, architecture, processus et organisation pour orchestrer le changement.
Dans un secteur qui adore les effets de mode, les frameworks salvateurs et les grandes vérités, nous préférons garder un doute méthodique. Nous défendons une approche exigeante, accessible et tournée vers le collectif. On apprend, on partage, on progresse en démontrant et en faisant. Et si nos convictions existent, elles restent toujours révisables. Notre industrie a quelque chose à nous apprendre : les certitudes vieillissent souvent plus vite que le code.
![Manifeste Tech : [notre métier mérite mieux que des dogmes]](/_next/image?url=https%3A%2F%2Fcms.shodo.io%2Fuploads%2FSHODO_OCT_25_10_aca69099a3.jpg&w=3840&q=75)
Exécuter une demande ne suffit pas
Nous sommes le partenaire de nos clients. Notre rôle est de comprendre leur métier, leurs enjeux et la réalité dans laquelle ils évoluent. Et la seule manière de le faire est avec lui, en confrontant nos points de vue, en réduisant collectivement notre ignorance fonctionnelle et en évitant de déployer nos incompréhensions en production. C'est l'une des convictions fondatrices de notre Manifeste Tech.
Être utile avant d’avoir raison
Cette posture guide notre manière d'accompagner. Nous sommes des partenaires plus que de simples exécutants. Cela implique un devoir de conseil exercé avec humilité : nos recommandations s'inscrivent dans un contexte qui n'est pas le nôtre, avec des contraintes et des conséquences que nous ne porterons pas directement. Dans notre Manifeste Tech, l'expertise n'a de valeur que lorsqu'elle aide à prendre de meilleures décisions.
Ne rien imposer
L'expertise ne doit jamais devenir un moyen de disqualifier ou de contraindre. Elle doit permettre d'éclairer, d'expliquer et de rendre les décisions compréhensibles. Car la confiance se construit par la preuve sociale, en démontrant par les faits que nos choix produisent réellement de la valeur. Notre responsabilité ne s'arrête pas au moment de la décision. Un logiciel n'est pas un simple outil : c'est un patrimoine vivant qui engage durablement l'entreprise et ses équipes. C'est pourquoi notre Manifeste Tech défend des décisions partagées, comprises par celles et ceux qui devront les porter, les faire vivre et les faire évoluer.


Transformer des intuitions en connaissances.
Backlogs, spécifications et user stories ne sont que des hypothèses de valeur jusqu'à leur confrontation à l'usage. Tant qu'un logiciel n'est pas confronté au réel, rien ne permet d'affirmer qu'il répondra à un besoin, qu'il sera utilisé ou qu'il produira l'impact attendu. Chaque mise en production n'est pas l'aboutissement du travail, mais le moment où l'apprentissage commence réellement.
Construire un patrimoine durable
Un logiciel qui crée durablement de la valeur n'est pas un projet que l'on livre puis que l'on oublie. C'est un produit. Un patrimoine vivant dont la valeur se construit dans le temps, par sa capacité à s'adapter aux évolutions du métier, à rester compréhensible et à continuer de servir celles et ceux qui l'utilisent.
Un logiciel ne peut être dissocié de l'organisation qui le construit. Vouloir améliorer un logiciel sans tenir compte de cette réalité revient souvent à corriger les conséquences plutôt que les causes. Pour transformer durablement un système, il faut donc regarder autant les interactions humaines que le code lui-même.

Il reflète aussi l’organisation qui l’a conçu.
Règles, interactions, silos, habitudes et manière de faire circuler l’information : l’environnement laisse toujours une empreinte sur le système. Contraintes métier, modes de fonctionnement et dynamiques d’équipe façonnent directement le logiciel. Chercher à améliorer un système sans tenir compte de cette réalité revient souvent à corriger les conséquences plutôt que les causes.

Le contexte prime sur les recettes
Une méthode pertinente dans une organisation peut devenir contre-productive dans une autre. Faire preuve d’intelligence situationnelle, c’est partir du contexte existant, comprendre les équilibres en place et introduire les changements au bon moment, plutôt que plaquer des solutions toutes faites.

Le collectif comme multiplicateur de valeur
Elle repose sur la capacité collective à comprendre, partager et apprendre ensemble. Une organisation qui favorise la coopération, la circulation du savoir et la prise d’initiative produit des systèmes plus robustes, plus cohérents et plus durables.

L’autonomie se construit, elle ne se décrète pas
Une organisation qui fétichise le contrôle finit souvent par ralentir l’apprentissage, fragiliser l’autonomie et empêcher les équipes de progresser ensemble

C'est un système vivant qui doit pouvoir évoluer, être maintenu et continuer à produire de la valeur dans le temps sans devenir un poids pour celles et ceux qui l'utilisent ou le font évoluer. Cette conviction est au cœur de notre Manifeste Tech.
Le métier en est le point d’ancrage. C’est lui qui donne le sens, éclaire les arbitrages et permet d’exprimer clairement l’intention du système. Concevoir sans comprendre le métier revient souvent à produire un logiciel techniquement correct, mais déconnecté de la réalité qu’il est censé servir.
À l'inverse, un logiciel pensé à partir du métier reste maîtrisable. Il peut évoluer avec confiance, s'adapter sans se fragiliser et continuer à produire de la valeur dans la durée. C'est cette recherche permanente d'équilibre entre compréhension métier, qualité logicielle et pérennité des systèmes qui guide notre Manifeste Tech et notre approche du Software Craftsmanship.

Nous refusons de transformer nos habitudes, nos intuitions ou nos succès passés en certitudes.
Nos pratiques doivent pouvoir être questionnées, testées et contredites. C’est l’un des principes de notre Manifeste Tech : formuler des hypothèses, les confronter au réel, observer les résultats et ajuster en conséquence.
Le réel a toujours le dernier mot.
Une idée ne devient pas pertinente parce qu’elle est séduisante, populaire ou défendue avec assurance. Elle le devient lorsqu’elle résiste à l’épreuve des faits. Cette exigence rejoint l’esprit du Software Craftsmanship : progresser par la pratique, la preuve et l’amélioration continue.