14. Supple design e refinamento do modelo

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

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 Supple design e refinamento do modelo 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.

Uma intention-revealing interface comunica o que o elemento significa e

O ponto de partida é estabelecer o significado do conceito e o problema que ele procura organizar. Uma intention-revealing interface comunica o que o elemento significa e faz no modelo, valendo-se da linguagem ubíqua, sem expor etapas acidentais da implementação. Uma operação como `pedido.confirmar()` revela uma intenção do negócio melhor que uma sequência pública de setters sobre status, data e flags. Ao depender do propósito e do contrato, o código cliente fica menos acoplado ao algoritmo interno e pode sobreviver à sua refatoração. O padrão não se reduz a escolher nomes longos: assinatura, tipos e granularidade também precisam formar uma abstração coerente. A regra ganha sentido quando suas consequências orientam a implementação.

Para aplicar Uma intention-revealing interface comunica o que o elemento significa e, 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 DDD, uma intention-revealing interface expressa, nos nomes de classes e operações, o propósito reconhecido no domínio e o resultado prometido ao cliente, evitando obrigá-lo a compreender o mecanismo interno usado para cumprir a operaçã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.

Item troca a intenção pelo mecanismo: uma interface reveladora

A partir dessa distinção, o próximo elemento completa o fluxo. O item troca a intenção pelo mecanismo: uma interface reveladora descreve o efeito conceitual da operação, não as etapas do algoritmo que a implementa. Um método `calcularJurosComLoopDiarioEAjustarCentavos()` amarra o cliente a decisões técnicas, ao passo que `juros.acumuladosAte(data)` formula o resultado na linguagem do domínio. A previsibilidade vem de um contrato claro, de tipos adequados e de assertions sobre condições relevantes, não da exposição do procedimento interno. Se o algoritmo mudar de iteração diária para fórmula fechada, o nome orientado ao mecanismo se tornará falso e espalhará impacto pelos clientes. Observe como definição, mecanismo e efeito permanecem ligados.