03. Linguagem ubíqua

Este capítulo nasce das 30 questões publicadas sobre Linguagem ubíqua. 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 3 de 20 da disciplina Domain-Driven Design (DDD). Ele retoma Domínio, subdomínios e core domain e utiliza essa base para avançar. Na sequência, estudaremos Bounded contexts.

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 Linguagem ubíqua 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.

A afirmação reúne os três pilares da definição de Evans:

O ponto de partida é estabelecer o significado do conceito e o problema que ele procura organizar. A afirmação reúne os três pilares da definição de Evans: a linguagem é comum a todo o time (técnicos e especialistas de negócio), é estruturada em torno do modelo de domínio — os termos da linguagem correspondem aos elementos do modelo — e deve ser usada de forma pervasiva em conversas, documentos e código. O propósito é eliminar a ambiguidade e a necessidade de tradução entre a 'língua do negócio' e a 'língua do código': quando todos usam os mesmos termos com o mesmo significado, o conhecimento do domínio flui sem perdas. Há ainda um efeito prático valioso: a linguagem funciona como teste do modelo, pois, se uma frase montada com os termos do modelo soa estranha ou ambígua ao especialista, o problema costuma estar no modelo, e não apenas na comunicação. A regra ganha sentido quando suas consequências orientam a implementação.

Para aplicar Afirmação, 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, a linguagem ubíqua é um vocabulário comum estruturado em torno do modelo de domínio, construído e compartilhado por desenvolvedores e especialistas de negócio e empregado de forma consistente na fala, nos documentos e no código do projeto. 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.

Linguagem ubíqua não

A partir dessa distinção, o próximo elemento completa o fluxo. A linguagem ubíqua não é uma transcrição passiva do jargão do negócio: ela é lapidada em conjunto por desenvolvedores e especialistas, tendo o modelo de domínio como base. O vocabulário espontâneo dos especialistas frequentemente é ambíguo, varia de pessoa para pessoa e deixa sem nome conceitos que o negócio pratica todos os dias; parte do trabalho de modelagem é expor essas imprecisões, negociar definições mais rigorosas e, quando necessário, cunhar termos novos. Evans descreve o processo como um 'martelar' contínuo da linguagem: experimenta-se falar com os termos do modelo e ajusta-se o que soa errado, dos dois lados. O defeito do item está em rebaixar os desenvolvedores a escribas, retirando deles o papel de coautores ativos da linguagem. Observe como definição, mecanismo e efeito permanecem ligados.