Clean Architecture com Node.js e TypeScript: Guia Prático para Sistemas Escaláveis

A Clean Architecture (Arquitetura Limpa), concebida por Robert C. Martin (Uncle Bob), é um padrão arquitetural que visa desacoplar regras de negócio de frameworks, bancos de dados e detalhes de infraestrutura.

Princípios Fundamentais

1. **Independência de Frameworks**: A arquitetura não depende de bibliotecas de terceiros. 2. **Testabilidade**: As regras de negócio podem ser testadas sem banco de dados, servidor web ou qualquer outro elemento externo. 3. **Independência de Interface de Usuário**: A UI pode mudar facilmente sem alterar as regras de negócio. 4. **Independência de Banco de Dados**: A troca de PostgreSQL para MongoDB ou DynamoDB não impacta as entidades da aplicação.

Camadas da Clean Architecture no Node.js

- **Entities (Domain)**: Representam os objetos de negócio e regras corporativas. - **Use Cases (Application)**: Contêm as regras de negócio específicas da aplicação. - **Interface Adapters (Controllers/Presenters/Gateways)**: Convertem dados do formato mais conveniente para use cases e entidades. - **Frameworks & Drivers (Infrastructure)**: Onde residem os bancos de dados, frameworks web (Express, Fastify, NestJS) e serviços externos.