Hexagonal Architecture / Ports & Adapters

Il problema

Framework, database e protocolli esterni tendono a invadere il dominio e rendere costose sostituzioni e test.

Il pattern

Mettere dominio e casi d'uso al centro; definire porte in ingresso/uscita e adapter per HTTP, database, broker e servizi esterni.

Come funziona

Le dipendenze puntano verso il core. RepositoryPort e PatientPort sono interfacce del core; PostgreSQLAdapter ed EMPIAdapter appartengono all'infrastruttura.

Esempio sanitario

Benefici

• Dominio indipendente dalla tecnologia
• Testabilità elevata
• Boundary naturali per microservizi

Trade-off

• Più struttura e interfacce
• Overengineering su servizi molto semplici

Quando usarlo

Per servizi con logica di dominio e più integrazioni.

Quando evitarlo

Per CRUD minimale dove il costo strutturale supera il beneficio.

Pattern correlati