Arquitetura em camadas para KMP

À medida que seu aplicativo KMP cresce, o código compartilhado pode se transformar em uma confusão. Uma arquitetura em camadas clara mantém cada parte em seu lugar, para que ambos os aplicativos continuem fáceis de alterar.

A maioria dos aplicativos KMP se organiza em três camadas: dados, domínio e apresentação. Cada uma tem uma função, e as dependências fluem em uma única direção previsível.

A camada de dados conversa com o mundo externo: Ktor para HTTP e SQLDelight para armazenamento. Ela busca bytes brutos e entrega dados limpos para cima, ocultando os detalhes.

A camada de domínio contém suas regras de negócio e seus modelos. Ela não sabe nada sobre HTTP ou SQL, portanto permanece pura, portável e facilmente testável.

A camada de apresentação prepara o estado para a tela. Os ViewModels compartilhados ficam aqui, transformando dados de domínio no StateFlow que cada interface coleta.

A regra de ouro: as camadas externas dependem das internas, nunca o contrário. A apresentação conhece o domínio; o domínio não conhece nenhum dos vizinhos.

As camadas se conectam por meio de interfaces, não de classes concretas. O domínio declara o que precisa; os dados fornecem a implementação, para que você possa trocar as partes livremente.

Cada camada pode ter suas próprias estruturas: um DTO de rede nos dados e um modelo limpo no domínio. O mapeamento entre eles impede que particularidades da API vazem para suas regras.

A separação compensa quando os requisitos mudam. Troque uma API REST por GraphQL e somente a camada de dados mudará; o domínio e a apresentação nem perceberão.

Dados, domínio e apresentação podem ficar todos em commonMain. Android e iOS reutilizam toda a pilha e fornecem apenas a tela nativa final.

Você não precisa de dez camadas no primeiro dia. Comece com estas três, mantenha as setas de dependência limpas e deixe a estrutura crescer somente quando isso trouxer benefícios. 🙂

Você dividiu o código compartilhado em dados, domínio e apresentação, apontou as dependências para dentro e conectou as camadas por meio de interfaces. Divisões claras, alterações fáceis. 🎉