15. Context mapping e relações entre contextos

Este capítulo nasce das 30 questões publicadas sobre Context mapping e relações entre contextos. 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 15 de 20 da disciplina Domain-Driven Design (DDD). Ele retoma Supple design e refinamento do modelo e utiliza essa base para avançar. Na sequência, estudaremos Camada anticorrupção e integração com legados.

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 Context mapping e relações entre contextos 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.

Context map

O ponto de partida é estabelecer o significado do conceito e o problema que ele procura organizar. O context map é o instrumento do design estratégico que descreve a paisagem existente: quais bounded contexts há, onde seus modelos se tocam e traduzem, e como as equipes responsáveis se relacionam — quem é upstream, quem decide, quem coopera com quem. Evans orienta expressamente a mapear o terreno existente e deixar as transformações para depois, porque decisões de integração dependem de fatores humanos e organizacionais tão concretos quanto os técnicos: orçamento, prioridade, disposição de cooperar. Transformar o mapa é possível, mas é uma decisão posterior e negociada, que parte desse retrato honesto. A confusão frequente clássica é tratá-lo como um diagrama de arquitetura alvo (to-be) — nesse caso, o item estaria errado. A regra ganha sentido quando suas consequências orientam a implementação.

Para aplicar Context map, 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 design estratégico do Domain-Driven Design, o context map é elaborado para retratar a situação atualmente existente no projeto — os bounded contexts, os pontos de contato entre seus modelos e as relações entre as equipes responsáveis, inclusive as de natureza organizacional e política —, e não para prescrever a arquitetura ideal que se pretende alcançar. 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 os papéis. Na metáfora do rio que dá nome à relação, o que acontece rio

A partir dessa distinção, o próximo elemento completa o fluxo. O item inverte os papéis. Na metáfora do rio que dá nome à relação, o que acontece rio acima (upstream) afeta quem está rio abaixo (downstream) — nunca o inverso. É o contexto upstream que, com suas decisões de modelo, seu calendário e suas mudanças, condiciona o sucesso do downstream; ao downstream cabe reagir: negociar (customer-supplier), aderir ao modelo alheio (conformist) ou isolar-se por tradução (anticorruption layer). Um exemplo cotidiano: o ERP corporativo que publica sua API é upstream; a equipe que integra um novo módulo a essa API é downstream e absorve cada mudança de versão. Observe como definição, mecanismo e efeito permanecem ligados.