O que é a arquitetura limpa? Como ela é estruturada e como funciona?

Question

IT Interview Practice · Accepted Answer

## O que é a arquitetura limpa?

**A arquitetura limpa** organiza o software em torno do comportamento de negócio, separando-o de interfaces de usuário, bancos de dados e frameworks. Seu objetivo é reduzir o efeito das mudanças de tecnologia sobre regras importantes da aplicação.

Por exemplo, “um pedido entregue não pode ser cancelado” é uma regra de negócio. Ela permanece a mesma, quer o cliente utilize um site ou uma aplicação móvel, e independentemente da tecnologia de armazenamento.

## Partes principais

A arquitetura limpa costuma ser ilustrada como círculos organizados de dentro para fora:

- **Entidades:** Contêm dados e regras centrais do negócio, como um pedido e suas condições de cancelamento.
- **Casos de uso:** Coordenam uma operação específica da aplicação, como recuperar um pedido, solicitar o cancelamento e salvar o resultado.
- **Adaptadores de interface:** Convertem dados entre a lógica de negócio e os sistemas externos. Um controlador converte uma solicitação HTTP em entrada para a operação de cancelamento; um adaptador de armazenamento transforma os dados do pedido em consultas ao banco de dados.
- **Frameworks e ferramentas:** Tecnologias na borda externa, como o framework web ou o sistema de banco de dados.

**A regra essencial é que o código interno não deve depender do código externo.** Um caso de uso pode trabalhar com uma interface de armazenamento de pedidos definida no lado do negócio; um adaptador externo implementa essa interface utilizando uma tecnologia específica.

## Exemplo: cancelar um pedido

Quando um cliente solicita o cancelamento, o controlador chama o caso de uso de cancelamento. O caso de uso recupera o pedido por meio de uma interface de acesso a dados e, em seguida, pede ao objeto do pedido que verifique se o cancelamento é permitido.

Se o pedido não tiver sido entregue e atender às condições, seu status muda para cancelado. O caso de uso solicita que a alteração seja salva, o adaptador de banco de dados realiza a escrita e o controlador retorna o resultado ao cliente.

Em tempo de execução, a lógica de negócio ainda pode chamar um adaptador por meio de uma interface conectada durante a inicialização. A regra de que as dependências apontam para dentro diz respeito às relações entre componentes do código; ela não significa que os dados ou as chamadas só possam percorrer uma direção.

## Benefícios

- **Testes mais fáceis das regras:** Cancelamentos permitidos e rejeitados podem ser testados com dados em memória, sem iniciar um servidor web ou banco de dados.
- **Um lugar claro para o comportamento de negócio:** As regras não ficam espalhadas entre controladores e consultas, tornando-as mais fáceis de ler e alterar de forma consistente.
- **Menor impacto das mudanças de tecnologia:** Substituir uma biblioteca de armazenamento ou um tratador de solicitações afeta principalmente os componentes externos se os contratos de negócio permanecerem inalterados.

## Limitações

- **Mais componentes:** Escrever e manter interfaces, casos de uso e código de conversão de dados exige tempo.
- **Os limites exigem disciplina:** Se um caso de uso utiliza diretamente tipos específicos de um framework ou de uma biblioteca de banco de dados, a lógica de negócio volta a depender da tecnologia externa.

## Quando você deve utilizá-la?

A arquitetura limpa é útil para sistemas com comportamento de negócio complexo, um longo ciclo de desenvolvimento e necessidades frequentes de testes. Para uma aplicação pequena que apenas lê e grava em algumas tabelas, uma estrutura mais simples pode ser mais fácil de utilizar. Não há necessidade de criar todos os círculos ou pastas, a menos que isso ajude a separar responsabilidades reais.

O que é a arquitetura limpa?

Partes principais

Exemplo: cancelar um pedido

Benefícios

Limitações

Quando você deve utilizá-la?

Perguntas relacionadas