Pular para o conteúdo
← Voltar para artigos

Nossos testes passaram. O cliente redesenhou tudo à mão.

Um motor de traçado de dutos foi entregue com todos os testes verdes, e mesmo assim o instalador redesenhou o resultado à mão. O que isso nos ensinou sobre a distância entre software correto e software aceito, e como testamos isso hoje.

EngenhariaTestesCritério de produto
Um instalador redesenhando um traçado de dutos a lápis vermelho sobre uma planta baixa impressa, com uma trena e luvas de trabalho na bancada.

Entregamos uma funcionalidade de traçado automático de dutos com a suíte de testes inteira verde. Todo layout que ela produzia era válido: os trechos eram alinhados aos eixos, os dutos estavam dimensionados corretamente e a vazão de ar fechava ao longo do tronco. Por todas as verificações que tínhamos escrito, funcionava.

O instalador imprimiu o resultado e redesenhou cada duto à mão.

Nada estava quebrado de um jeito que os nossos testes pudessem ver. “Os testes passam” e “a pessoa que vive disso aceita o resultado” se revelaram duas afirmações diferentes, e só a segunda importava para o cliente.

A causa era uma única coordenada

O motor ancorava o tronco principal na posição da unidade de tratamento de ar. Parece razoável, porque é da unidade de tratamento de ar que o ar sai. Mas ela fica na borda da planta. Ancorar o tronco ali significava que cada ramal precisava partir dessa borda e atravessar a planta inteira para chegar à sua grelha.

O resultado era um sistema de dutos válido que nenhum instalador construiria: uma espinha encostada em uma parede, com ramais longos cruzando o pavimento inteiro.

O problema era mensurável. O comprimento total dos ramais chegava a cerca de 2.140 px no desenho. Uma pequena grelha de closet, que precisava de apenas 7 CFM, tinha um ramal de 450 px.

Uma pessoa não desenha assim. Uma pessoa passa o tronco pelo meio das grelhas que ele atende, para que os ramais fiquem curtos e equilibrados dos dois lados.

A correção foi uma palavra. Em vez de ancorar o tronco na coordenada da unidade de tratamento de ar, passamos a ancorá-lo na mediana das coordenadas das grelhas. O comprimento total dos ramais caiu para 840 px, e o ramal do closet virou um trecho curto. Nada mais mudou.

Passar e ser aceito são afirmações diferentes

Os testes não estavam errados. Eles verificavam exatamente o que tínhamos pedido que verificassem: a geometria é ortogonal, a vazão nunca aumenta ao longo do tronco, os ramais saem dos dois lados e as curvas caem nos cantos. Tudo isso era verdade antes da correção e depois dela.

O que a suíte não verificava era aquilo que definia a funcionalidade: o desenho precisa parecer um desenho que um instalador faria. Não tínhamos escrito esse teste porque ainda não sabíamos que esse era o requisito. Entendíamos a física. Não tínhamos encontrado o objetivo.

O redesenho não foi uma reclamação. Foi a especificação, entregue com atraso e da forma mais clara possível: um especialista fazendo o trabalho do jeito que ele deve ser feito.

Encontrando o objetivo real

Boa parte do que conta como habilidade de engenharia em um problema novo é descobrir o que você está realmente otimizando. É fácil otimizar o objetivo que lhe deram. É mais difícil perceber que o objetivo declarado (“produzir um layout de dutos válido”) está no lugar de um objetivo não declarado (“produzir o layout que um especialista teria desenhado”), e encontrar o verdadeiro antes que o cliente precise desenhá-lo para você.

Você o encontra observando o trabalho em uso, não relendo o briefing. O briefing dizia “dimensionar e traçar os dutos”. Não dizia “manter os ramais curtos e centralizar o tronco em relação às suas grelhas”, porque o instalador não pensava nisso como um requisito. É simplesmente assim que se desenham dutos. Era invisível para ele e desconhecido para nós, e requisitos desse tipo só aparecem quando um usuário real põe as mãos no resultado.

O que mudamos

Depois que o objetivo é conhecido, ele deixa de ser uma questão de gosto. Vira um teste como qualquer outro. O redesenho se transformou em uma única asserção: o comprimento total dos ramais fica abaixo de 1.100 px, verificado a cada execução.

A lição vai além desse bug e hoje orienta a forma como construímos:

  • Teste a propriedade que um especialista reconheceria, não as coordenadas. “Retorna exatamente estes pontos” pode passar enquanto a funcionalidade está errada. “Os ramais são curtos e equilibrados dos dois lados” é o que importa para um instalador, e continua fazendo sentido quando a implementação interna muda.
  • Trate o primeiro redesenho de um especialista como a especificação. Quando alguém que conhece o domínio refaz o seu resultado à mão, esse retrabalho é o requisito. Registre-o como uma verificação antes de mudar o código, para que não haja regressão.
  • Coloque o resultado diante de um usuário real cedo. O objetivo que você presumiu e o que importa raramente são o mesmo, e a distância entre eles é onde está o trabalho de verdade.

Uma decisão de projeto tornou a correção fácil. O motor de traçado é uma função pura: entram números, sai geometria, sem nenhuma interface de usuário envolvida. O problema pôde ser reproduzido, medido e testado sem abrir o canvas, e é por isso que uma mudança de uma palavra pôde ser verificada, em vez de ficar na esperança. O projeto completo está descrito no estudo de caso da plataforma de HVAC.

Os testes verdes nos disseram que o código fazia o que tínhamos pedido. O redesenho nos disse o que deveríamos ter pedido.

Trabalhando com algo nessa linha?

Se algo disso se parece com o problema à sua frente, conte onde você está e aonde quer chegar. Voltamos com um plano em até dois dias úteis.