~ / hub / Aggregate
4 out 2026conceitosguia prático

Aggregate

Cluster de entidades.

Em Domain-Driven Design, um agregado é um grupo de entidades e objetos de valor tratado como uma única unidade de consistência. Um deles é a raiz do agregado (aggregate root): o único ponto de entrada, de modo que o código externo só altera o agregado por ela.

Como funciona

  • A raiz protege as invariantes: regras que precisam valer sempre, como "o total do pedido é a soma dos itens".
  • Como regra geral, cada transação altera um único agregado; entre agregados, a consistência costuma ser eventual.
  • Outros agregados referenciam a raiz pelo identificador, não por objetos internos.

Exemplo

Em um pedido, Pedido é a raiz e os itens fazem parte do agregado. Para incluir um item, chama-se um método do pedido, que valida a regra e atualiza o total. Ninguém altera a lista de itens diretamente.

Limitações

Agregados grandes causam contenção e transações pesadas. Prefira agregados pequenos, desenhados em torno das invariantes que realmente exigem consistência imediata.

Relacionados: bounded context, eventos de domínio, aplicação de invariantes.

DICA Explore o hub de conteúdo.

Quer aplicar no seu time?

Diagnóstico gratuito.

solicitar →