mattia-battiston/clean-architecture-example
Clean Architecture Example
Ce projet est une implémentation de référence pour structurer des applications Java en utilisant une architecture propre (clean architecture) et des principes de conception pilotée par le domaine (DDD). Il fournit un modèle pour organiser le code en couches concentriques, garantissant que les règles métier fondamentales et les entités de domaine restent entièrement indépendantes des frameworks, bases de données et mécanismes de livraison externes.
L'architecture repose sur le principe d'inversion de dépendance pour découpler la logique métier de l'infrastructure. En définissant des interfaces abstraites pour l'accès aux données et les services externes, le système permet le remplacement des technologies sous-jacentes sans nécessiter de modifications à la logique d'application principale. Une couche de configuration dédiée gère l'injection de dépendances, isolant le câblage spécifique au framework du code de domaine.
La base de code prend en charge une stratégie de test complète qui valide le comportement du système à plusieurs niveaux, y compris la logique unitaire isolée, les scénarios d'acceptation axés sur le métier et les parcours de bout en bout. Cette approche modulaire facilite la maintenance à long terme en garantissant que les actions métier restent encapsulées en tant qu'unités indépendantes et testables.
Features
- Clean Architecture Frameworks - Structures Java applications to keep core business rules independent of frameworks, databases, and external delivery mechanisms.
- Clean Architecture Implementations - Provides a reference implementation of clean architecture principles to decouple business logic from external frameworks and infrastructure.
- Dependency Inversion Patterns - Ensures high-level business logic depends on abstractions rather than concrete infrastructure implementations to maintain loose coupling.
- Domain-Driven Designs - Encapsulates complex business logic and data entities into isolated objects free from infrastructure dependencies.
- Layered Architectures - Organizes application code into concentric functional layers to isolate business logic from infrastructure and delivery concerns.
- Data Abstraction Layers - Defines abstract interfaces for data operations to allow swapping storage technologies without modifying core business logic.
- Data Access Abstractions - Defines interfaces for data operations to allow swapping storage backends without affecting core application code.
- Agnostic Models - Implements core business entities as plain objects independent of external persistence frameworks or runtime environments.
- Decoupled Logic Layers - Separates user interfaces and data access layers from core application logic to allow for flexible technology upgrades.
- Explicit Dependency-Injection Wiring - Implements explicit dependency injection wiring to decouple business logic from framework-specific infrastructure.
- Business Entities - Encapsulates core business data and rules within independent objects free from infrastructure or framework requirements.
- Logic Decoupling - Separates user interaction points and background tasks from core business logic to ensure accessibility through any communication channel.
- Testability Optimizations - Designs application components with clear interfaces to enable comprehensive testing without requiring external system environments.
- Use Case Driven Architectures - Implements discrete business actions as independent units that define their own data requirements to ensure isolation from delivery mechanisms.
- Business Logic Isolation - Executes discrete business actions as independent units that define their own data requirements through interfaces.
- End-to-End Testing - Validates system behavior through a tiered testing strategy covering unit logic, acceptance scenarios, and end-to-end journeys.
