Clean Architecture e hexagonal (portas e adaptadores)

A regra da dependência

Martin (2012) unificou ideias da arquitetura hexagonal de Alistair Cockburn (2005) e da arquitetura cebola: o código só pode depender de camadas mais internas. Entidades e casos de uso não conhecem banco, HTTP nem UI. Por isso dá para testar o negócio sem nada disso.

Portas e adaptadores

Na hexagonal, o domínio define portas (interfaces) de entrada (o que o app oferece) e de saída (o que ele precisa: salvar, enviar). Adaptadores conectam o mundo real: controller HTTP, tela, Room, Retrofit.

Sem cerimônia

Para um app pequeno, três pacotes (ui, domain, data) bastam; casos de uso só valem quando há regra para colocar neles. O guia do Android marca a camada de domínio como opcional. A arquitetura deve acompanhar a complexidade do projeto.

// domain (módulo puro Kotlin, sem Android)
data class Meta(val id: String, val valorAlvo: Long, val guardado: Long) { val progresso get() = guardado * 100 / valorAlvo }
interface MetasPort { suspend fun buscar(id: String): Meta?; suspend fun salvar(m: Meta) }
class Depositar(private val metas: MetasPort) {
  suspend operator fun invoke(id: String, centavos: Long): Meta {
    require(centavos > 0)
    val m = metas.buscar(id) ?: error("meta não encontrada")
    return m.copy(guardado = m.guardado + centavos).also { metas.salvar(it) }
  }
}
// data (adaptador)
class RoomMetas(private val dao: MetaDao) : MetasPort { /* mapeia entity <-> domínio */ }
// ui
class MetaViewModel(private val depositar: Depositar) : ViewModel()