Avançado9 min de leituraNível 4

Onion Architecture

Um conceito central de padrões de arquitetura que toda pessoa engenheira sênior precisa saber defender em voz alta.

Introdução

Onion Architecture faz parte do ferramental de Padrões de Arquitetura. Este capítulo esclarece o que é, qual problema resolve e quais são os trade-offs que transformam isso em uma decisão relevante para entrevistas — e não em um item de checklist. Use o quiz interativo e os desafios abaixo para sair do "já ouvi falar" e chegar ao "sei defender uma arquitetura que usa isso".

Por que existe

Todo conceito de padrões de arquitetura existe porque uma solução ingênua esbarra em um limite — um gargalo, um modo de falha ou uma brecha de correção. Onion Architecture é o padrão que os engenheiros usam exatamente nesse ponto. Entender a pressão que cria a necessidade de Onion Architecture é o que separa decorar o conceito de saber quando aplicá-lo.

Analogia

Pense em Onion Architecture como uma ferramenta especializada na bancada: não é a que você pega toda vez, mas quando o problema tem o formato certo, nada resolve de forma tão limpa. A habilidade está em reconhecer esse formato rapidamente.

Como funciona

No alto nível, Onion Architecture funciona fazendo uma troca deliberada: aceita um custo (complexidade, latência, consistência ou dinheiro) para ganhar uma propriedade que importa mais naquele momento (escala, disponibilidade, correção ou velocidade). Em uma entrevista, descreva isso como mecanismo + trade-off — o que faz e o que custa — e conecte com os outros conceitos de padrões de arquitetura que costumam aparecer junto.

Quando usar

Recorra a isso quando

  • O problema que você está resolvendo tem claramente o formato que Onion Architecture otimiza.
  • Você já identificou o gargalo ou o modo de falha específico que Onion Architecture ataca.
  • A complexidade extra se justifica pela escala ou pela confiabilidade que você precisa.

Evite quando

  • Uma solução mais simples já atende ao requisito — não adote Onion Architecture preventivamente.
  • O custo de Onion Architecture (latência, consistência, esforço operacional) supera o benefício na sua escala atual.

Trade-offs

Vantagens

  • Ataca diretamente um problema conhecido de padrões de arquitetura.
  • Combina bem com os outros padrões desta seção.

Desvantagens

  • Adiciona complexidade que precisa ser operada e compreendida.
  • No contexto errado, as forças viram fraquezas.

O coração de Onion Architecture é um trade-off. Diga qual propriedade ele te dá e qual propriedade ele cobra, e você conseguirá raciocinar sobre isso em qualquer sistema — que é exatamente o que a pessoa entrevistadora está esperando ouvir.

Erros comuns

Fique atento a

  • Aplicar Onion Architecture por padrão, em vez de responder a uma necessidade medida.
  • Explicar o que Onion Architecture é sem articular o trade-off que ele carrega.

Pense como sênior

Visão de Engenheiro(a) Sênior

Pessoas sêniores discutem Onion Architecture a partir da pressão específica que o justifica e, na sequência, já nomeiam o custo. Esse enquadramento de dois lados é o sinal de entendimento real.

Visão de Engenheiro(a) Sênior

Conecte Onion Architecture aos conceitos vizinhos em Padrões de Arquitetura: as respostas interessantes estão em como os padrões se combinam, não em uma definição isolada.

Lembre-se

Onion Architecture é um trade-off, não um ganho de graça — sempre exponha os dois lados.

Lembre-se

Recorra a Onion Architecture em resposta a uma necessidade medida, nunca por reflexo.

Resumo

Onion Architecture é um padrão de padrões de arquitetura definido pelo trade-off que faz. Domine o problema que ele resolve, o mecanismo e o custo, e você conseguirá defender seu uso em uma discussão de arquitetura.

Pontos-chave

  • Onion Architecture resolve um problema específico de padrões de arquitetura — saiba exatamente qual.
  • Sempre associe o benefício ao seu custo.
  • Aplique em resposta a um gargalo real, não por padrão.

Suas anotações

Salvo neste dispositivo