Pourquoi la Clean Architecture ?

Le problème que résout une architecture bien pensée

La plupart des codebases commencent propres. Six mois plus tard, ajouter une fonctionnalité simple prend des jours. Tests cassés, effets de bord, couplage invisible — c'est le signe d'une architecture qui a cédé à la pression du court terme.

La règle fondamentale

La Clean Architecture repose sur une règle unique : les dépendances pointent toujours vers l'intérieur. Le domaine ne connaît ni Express, ni TypeORM, ni PostgreSQL. Ce sont les couches extérieures qui s'adaptent au domaine — jamais l'inverse.

Test simple

Si remplacer PostgreSQL par MongoDB nécessite de toucher à tes entités métier, ton architecture est compromise.

Les 4 couches

Domain — entités, value objects, interfaces de repository. Aucune dépendance externe.
Application — use-cases qui orchestrent le domaine. Connaît le domaine, pas l'infra.
Infrastructure — TypeORM, Express, S3, Redis. Implémente les interfaces du domaine.
Presentation — controllers, routes, validators. Traduit HTTP ↔ use-cases.

À retenir

L'architecture n'est pas une contrainte — c'est ce qui te permet de changer d'avis sans tout casser.

Topics and skills covered

Architecture logicielle
Séparation des préoccupations

Entity vs Value Object

Ch.1