Clean Architecture: como construir sistemas mais organizados e sustentáveis

Clean Architecture</>

À medida que um sistema cresce, manter o código organizado se torna um desafio cada vez maior. Novas funcionalidades, integrações, regras de negócio e mudanças de tecnologia podem tornar a aplicação difícil de manter.

É nesse contexto que surge a Clean Architecture, uma abordagem de desenvolvimento de software que busca organizar o sistema de forma que suas regras de negócio não dependam diretamente de frameworks, bancos de dados ou outras tecnologias externas.

O que é Clean Architecture?

Clean Architecture, ou Arquitetura Limpa, é um conceito apresentado por Robert C. Martin, conhecido como Uncle Bob. Seu principal objetivo é separar as responsabilidades do sistema, mantendo o núcleo da aplicação independente de detalhes externos.

Na prática, isso significa que as regras de negócio devem continuar funcionando mesmo que a empresa decida trocar o banco de dados, o framework ou a forma de exposição da API.

A arquitetura é baseada na ideia de que as dependências devem apontar para dentro, em direção às regras de negócio.

Principais camadas

Embora existam diferentes formas de implementar a arquitetura, ela geralmente é organizada em camadas com responsabilidades bem definidas:

Entidades (Entities)

Representam as regras de negócio mais importantes e independentes da aplicação. São responsáveis por comportamentos e conceitos fundamentais do domínio.

Casos de uso (Use Cases)

Contêm as regras específicas da aplicação. Eles coordenam as operações necessárias para realizar uma funcionalidade, sem depender diretamente de detalhes como HTTP ou banco de dados.

Adaptadores de interface (Interface Adapters)

Fazem a conversão entre os dados externos e o formato esperado pelos casos de uso. Controllers, presenters e alguns serviços de transformação podem fazer parte dessa camada.

Frameworks e detalhes externos

É onde ficam elementos como NestJS, Express, bancos de dados, ORMs, filas, APIs externas e mecanismos de infraestrutura.

Esses componentes são importantes, mas devem ser tratados como detalhes que podem ser substituídos.

Por que utilizar Clean Architecture?

A adoção dessa abordagem pode trazer benefícios importantes para projetos de software:

• Manutenção mais simples: cada camada possui responsabilidades claras.
• Testes mais fáceis: regras de negócio podem ser testadas sem depender de banco de dados ou serviços externos.
• Menor acoplamento: mudanças em frameworks e infraestrutura causam menos impacto.
• Maior flexibilidade: facilita a substituição de tecnologias ao longo do tempo.
• Melhor organização da equipe: torna mais claro onde cada funcionalidade deve ser implementada.

Um exemplo prático

Imagine um sistema de vendas em que um cliente realiza um pedido.

Em uma aplicação muito acoplada, o controller pode conter regras de negócio, consultas ao banco, validações e chamadas para serviços externos.

Com Clean Architecture, o fluxo pode ser organizado da seguinte forma:

1. O controller recebe a requisição.
2. O caso de uso executa a regra de negócio.
3. Uma interface de repositório define como os dados serão acessados.
4. Uma implementação concreta utiliza PostgreSQL, MongoDB ou outro banco.
5. O resultado retorna ao controller, que responde à API.

Dessa forma, o caso de uso não precisa saber qual banco está sendo utilizado.

Clean Architecture em projetos modernos

Em aplicações desenvolvidas com tecnologias como Node.js, TypeScript e NestJS, a Clean Architecture pode ser aplicada por meio da separação entre domínio, casos de uso, infraestrutura e interfaces.

Um exemplo de organização seria:

src/
├── domain/
│   ├── entities/
│   └── repositories/
├── application/
│   └── use-cases/
├── infrastructure/
│   ├── database/
│   └── external-services/
└── presentation/
    └── controllers/

Essa estrutura é apenas uma sugestão. O mais importante não é seguir uma pasta específica, mas preservar a separação de responsabilidades e a direção das dependências.

Quando utilizar?

Clean Architecture pode ser especialmente útil em sistemas que possuem:

• Regras de negócio complexas;
• Vida útil longa;
• Muitas integrações;
• Necessidade de testes automatizados;
• Equipes maiores;
• Evolução constante de funcionalidades.

Para aplicações pequenas e simples, aplicar todas as camadas pode gerar complexidade desnecessária. A arquitetura deve ser utilizada de acordo com o contexto e as necessidades do projeto.

Conclusão

Clean Architecture não é apenas uma forma de organizar pastas. É uma maneira de estruturar o software para que as regras de negócio permaneçam protegidas das mudanças externas.

Quando aplicada com equilíbrio, ela contribui para sistemas mais testáveis, flexíveis e fáceis de evoluir, permitindo que a equipe concentre seus esforços na entrega de valor para o negócio.