ADR-021
Dados do contrato exigidos no envio da proposta, e não na criação da cotação
Exigir os dados de contrato na criação da cotação travava o ciclo no ponto em que o vendedor menos tem informação, e a saída encontrada foi inventar cadastro para conseguir cotar. Validação no lugar errado não protege: ensina a burlar.
Trilha Ciclo de proposta e cotação, 1ª de 4.
Contexto
A criação de uma cotação recusava quando faltavam CPF, RG, nacionalidade, profissão e estado civil do cliente. Esses dados existem por causa de uma cláusula do contrato, não do orçamento. O efeito prático foi o oposto do controle pretendido: o ciclo comercial travava no ponto em que o vendedor menos tem informação, e a saída encontrada era inventar CPF para conseguir cotar.
Critérios que pesaram
Em ordem de peso.
- Orçamento é peça comercial: circula, é revisado, é descartado. Contrato é peça jurídica.
- A exigência deve incidir onde o documento vira compromisso, não antes.
- Contrato não pode nascer incompleto. A validação precisa continuar existindo.
- Dado que falta precisa ser visível como aviso, senão a surpresa acontece no envio.
Opções consideradas
- Manter a validação na geração da cotação: garante que nenhum contrato nasça incompleto, e é o estado que produziu o cadastro falso. Descartada.
- Remover a validação e corrigir depois: zero fricção, e um contrato com a cláusula de qualificação em branco não se sustenta juridicamente. Descartada por razão de negócio.
- Mover a validação para o envio da proposta e para a solicitação de assinatura, mantendo aviso não bloqueante antes disso.
Decisão
A validação dos dados de contrato saiu da criação da cotação e passou a rodar no envio da proposta e na solicitação de assinatura, as duas portas em que o documento deixa de ser orçamento. As mensagens trocaram "antes de gerar a cotação" por "antes de enviar a proposta". Continuam bloqueando a geração apenas os dados comerciais sem os quais a cotação não tem como ser calculada: moeda e vendedor do negócio. A pré-validação continua reportando os dados de contrato faltantes, mas como aviso, não como bloqueio. Meses depois, uma correção de acompanhamento ajustou os textos das telas de cliente e de negócio, que ainda diziam que a exigência era na geração, o que mostra o alcance real desse tipo de mudança: ela não termina no validador.
Consequências
As duas metades pesam igual.
Melhorou
O orçamento passou a circular desde o primeiro contato, que é o comportamento que a operação já tinha na prática, com a diferença de não precisar mais falsificar cadastro para consegui-lo. E a exigência jurídica ficou mais forte, não mais fraca: agora ela guarda duas portas, e não uma.
Piorou
São duas portas de validação para manter em sincronia, e a regra passou a viver em dois lugares. Também apareceu a classe de defeito que a mudança criou: qualquer texto de interface que descrevesse a regra antiga virou informação errada, e não existe mecanismo que ligue a regra ao texto que a explica.
Revisitando hoje
Ainda de pé em set/2026. O aprendizado transferível não é sobre validação, é sobre onde ela mora: uma exigência jurídica colocada no ponto errado do fluxo não protege nada: ela só ensina o usuário a burlá-la, e o dado falso que entra é pior que o dado ausente que se pretendia evitar.
Primeiro de doze registros sobre o ciclo de proposta e cotação. São decisões de modelagem de domínio, e não de infraestrutura: o que está em jogo é onde cada regra do negócio mora. Estão publicadas como foram escritas, incluindo o que piorou.