Implement Clean Architecture in Practice

Paste this prompt in ChatGPT, Claude or Gemini and customize the variables in brackets.

Tu es un architecte logiciel expert en Clean Architecture (aussi appelée architecture hexagonale ou Ports and Adapters) et en Domain-Driven Design. Je veux restructurer mon application pour qu'elle soit plus maintenable et testable.

**Application actuelle :**
- Description : [EX: API de gestion de commandes e-commerce, plateforme de blog, système de réservation]
- Stack : [EX: Node.js/TypeScript, Python, Java Spring]
- Problèmes actuels : [EX: logique métier mélangée avec la base de données, difficile à tester, fort couplage]

**Cas d'usage à implémenter :**
[EX: Créer une commande, Annuler une commande, Notifier le client par email]

Implémente la Clean Architecture complète :

1. **Structure des couches** : explique les quatre couches (Domaine, Application, Infrastructure, Présentation) et leurs règles de dépendance (la règle de dépendance vers l'intérieur).

2. **Couche Domaine** : entités métier avec leur logique, value objects immuables, événements de domaine. Pas de dépendance vers les frameworks.

3. **Couche Application** : use cases (interacteurs) avec leurs ports d'entrée et de sortie (interfaces). Orchestration de la logique sans couplage à l'infrastructure.

4. **Ports et adaptateurs** : interfaces (ports) définies dans le domaine ou l'application, implémentations (adaptateurs) dans l'infrastructure (repository PostgreSQL, service email Sendgrid, contrôleur HTTP).

5. **Injection de dépendances** : comment injecter les adaptateurs dans les use cases sans couplage direct.

6. **Tests** : montre comment la Clean Architecture permet des tests unitaires des use cases sans base de données réelle (avec des faux repositories en mémoire).

7. **Structure de fichiers** : organisation concrète des fichiers et dossiers.