Deixe o código calcular: aritmética, contagem, lógica de datas e conversão de unidades pertencem às ferramentas, não ao modelo

O que é

Um agente tem duas maneiras de obter um número: gerá-lo a partir dos pesos do modelo ou executar código que o calcule. A regra é usar código para tudo o que tem resposta exata e reservar o modelo para o julgamento: o que o número significa, se ele é plausível, o que fazer em seguida. A fronteira não tem a ver com dificuldade. Um modelo pode acertar uma soma de aparência difícil e errar uma contagem trivial, porque está reproduzindo o formato de respostas que já viu, e não contando de fato. A página da TypeSafe sobre os modos de falha do seu modelo de decisão diz isso com todas as letras sobre o próprio produto: o modelo não conta de forma confiável, o erro cresce com o tamanho do que é contado, ele lê datas como texto e não como grandezas ordenadas, e se sai pior com cores hexadecimais e código de baixo nível do que com nomes e linguagens de alto nível. A recomendação da mesma página vale para qualquer modelo: manter a aritmética no código, extrair as partes com o modelo e montá-las no código.

Por que importa

Uma contagem ou uma data errada que sai de um modelo tem exatamente a mesma aparência de uma correta; não há mensagem de erro. O custo aparece depois, numa decisão tomada com base nela. O código, ao contrário, falha de forma visível (uma exceção, um erro de tipo) e pode ser testado uma vez e, a partir daí, merecer confiança. Levar o cálculo para o código também torna a execução reproduzível: as mesmas entradas geram os mesmos números, e um revisor pode executá-los de novo.

Como aplicar

• Antes de pedir um número ao modelo, pergunte se uma expressão regular, um parser, uma fórmula de planilha ou dez linhas de código poderiam produzi-lo com exatidão; se sim, escreva e execute isso.
• Para contar itens que dependem de um julgamento: itere no código, faça ao modelo uma pergunta de sim/não por item e some no código.
• Datas: extraia ano, mês e dia como campos separados, com uma opção explícita "não informado", monte a data no código e faça ali todas as comparações, diferenças e cálculos de dia da semana.
• Unidades e moedas: converta no código, com a taxa ou o fator como entrada explícita; deixe o modelo avaliar apenas se o valor convertido é plausível.
• Mostre o cálculo na saída (a expressão ou o comando e o respectivo resultado) para que o leitor possa conferi-lo sem precisar confiar nem no modelo nem no agente.
• Quando não houver ferramenta disponível, diga que o número é uma estimativa e informe o método, em vez de apresentar um valor gerado pelo modelo como se tivesse sido calculado.

Armadilhas

O hábito de perguntar "quantos" ao modelo é forte porque se resolve com uma única chamada, em vez de uma ida e volta à ferramenta; reserve orçamento para essa ida e volta. O código também pode estar errado, mas erra sempre da mesma forma, e é justamente isso que o torna testável. E a extração ainda exige cuidado: decidir qual trecho é o valor total da fatura é um julgamento do modelo, e ele pode errar; a aritmética sobre esse total, não.