19. CQRS no contexto do DDD

Este capítulo nasce das 30 questões publicadas sobre CQRS no contexto do DDD. 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 19 de 20 da disciplina Domain-Driven Design (DDD). Ele retoma DDD e microsserviços e utiliza essa base para avançar. Na sequência, estudaremos Event Sourcing no contexto do DDD.

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 CQRS no contexto do DDD 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.

CQRS

O ponto de partida é estabelecer o significado do conceito e o problema que ele procura organizar. CQRS separa a responsabilidade de alterar estado da responsabilidade de lê-lo, de modo que os modelos não precisam compartilhar a mesma forma. No lado da escrita, agregados e comandos podem concentrar regras de negócio e proteção de invariantes. No lado da leitura, projeções podem ser moldadas diretamente para as telas ou relatórios que atendem. A separação é útil justamente quando as exigências de escrita e consulta divergem de maneira relevante. A regra ganha sentido quando suas consequências orientam a implementação.

Para aplicar CQRS, 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 padrão CQRS, o modelo empregado para processar comandos pode ser distinto do modelo usado para responder consultas, permitindo que cada lado seja estruturado conforme suas próprias necessidades. 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.

Item inverte a motivação típica do CQRS, pois o padrão ganha valor quando os modelos de

A partir dessa distinção, o próximo elemento completa o fluxo. O item inverte a motivação típica do CQRS, pois o padrão ganha valor quando os modelos de leitura e escrita têm formas ou preocupações diferentes. Um agregado de escrita pode ocultar estado interno e expor operações de negócio, enquanto uma visão de leitura pode combinar e desnormalizar dados de várias origens. Impor os mesmos objetos e atributos aos dois lados reduz essa liberdade e tende a recriar o acoplamento do modelo CRUD compartilhado. CQRS também pode ser aplicado com diferentes graus de separação, mas não busca uma representação canônica única. Observe como definição, mecanismo e efeito permanecem ligados.