08. Agregados e invariantes

Este capítulo nasce das 30 questões publicadas sobre Agregados e invariantes. A leitura do acervo revelou 30 núcleos de conhecimento, aqui reorganizados como uma explicação progressiva: primeiro o vocabulário e o modelo mental, depois os mecanismos, as decisões de implementação, os limites e a forma de verificar o comportamento do sistema.

Depois de entender o fluxo de desenvolvimento, aprofundamos a modelagem do negócio. O DDD organiza conhecimento, linguagem, limites e regras para que o software represente o domínio com clareza. Este é o capítulo 8 de 20 da disciplina Domain-Driven Design (DDD). Ele retoma Objetos de valor e utiliza essa base para avançar. Na sequência, estudaremos Serviços de domínio e de aplicação.

O fio condutor

O desenvolvimento de software começa com um problema e avança por decisões que precisam permanecer compreensíveis e verificáveis. Requisitos orientam modelos; modelos orientam código e arquitetura; testes verificam comportamento; e a operação devolve informações para o próximo ciclo. Uma falha importante no início tende a se espalhar pelas etapas seguintes.

Neste capítulo, use Agregados e invariantes para acompanhar quatro perguntas: qual problema precisa ser resolvido, como o mecanismo funciona, que consequências a escolha produz e como o resultado será verificado. Essa sequência transforma termos técnicos em decisões que podem ser explicadas e testadas.

Parte 1 — Fundamentos e vocabulário

Começamos por Parte 1 — Fundamentos e vocabulário, pois essa base organiza os conceitos e exemplos que aparecerão no restante do capítulo.

Item reproduz com fidelidade a definição de Evans: o agregado

O ponto de partida é estabelecer o significado do conceito e o problema que ele procura organizar. O item reproduz com fidelidade a definição de Evans: o agregado é um cluster de objetos associados tratado como unidade para mudanças de dados, com uma raiz e uma fronteira bem definida. O papel central dessa fronteira é ser o limite de consistência transacional — ao fim de uma transação que modifica o agregado, todas as invariantes dele devem estar satisfeitas. Fora da fronteira, entre agregados distintos, a consistência pode ser relaxada e alcançada de forma eventual. É essa distinção que orienta o desenho: o que precisa estar consistente de imediato fica dentro; o que tolera atraso fica fora. A regra ganha sentido quando suas consequências orientam a implementação.

Para aplicar Item reproduz com fidelidade a definição de Evans: o agregado, acompanhe a execução desde a entrada até a saída e anote pré-condições, mudança de estado, custo e falhas possíveis. Assim o conceito deixa de ser um rótulo e passa a orientar decisões.

Use como teste da compreensão: No Domain-Driven Design, agregado é um aglomerado de entidades e objetos de valor tratado como uma única unidade para fins de alteração de dados, e sua fronteira define o escopo dentro do qual as invariantes de negócio devem estar íntegras ao término de cada transação. Depois verifique a afirmação com execução controlada, teste automatizado, análise do contrato, medição ou documentação da versão correspondente. A evidência deve reproduzir a propriedade afirmada, inclusive nos casos de erro e de fronteira.

Raiz

A partir dessa distinção, o próximo elemento completa o fluxo. A raiz é a porta de entrada única do agregado: detém identidade global, é o alvo exclusivo de referências externas duradouras e intermedeia toda alteração nos objetos internos. O objetivo é dar às invariantes um único guardião — se cada operação passa pela raiz, ela consegue validar o estado do conjunto antes de aceitar a mudança. Na prática, um cliente do modelo não chama item.alterarQuantidade() diretamente: pede pedido.alterarQuantidadeDoItem(itemId, qtd), e a raiz decide se a operação preserva as regras do conjunto, como limite de valor total ou proibição de itens duplicados. A raiz pode até ceder referências transitórias a internos para uso momentâneo em consulta, mas o controle de escrita permanece com ela. Observe como definição, mecanismo e efeito permanecem ligados.