Pular para o conteúdo
← Todas as decisões

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.

Status
Aceita
Decidida em
11/08/2026
Publicada em
Sistema
plataforma B2B de funil comercial e propostas

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.

  1. Orçamento é peça comercial: circula, é revisado, é descartado. Contrato é peça jurídica.
  2. A exigência deve incidir onde o documento vira compromisso, não antes.
  3. Contrato não pode nascer incompleto. A validação precisa continuar existindo.
  4. 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.

modelagem de domínio validação contrato

Receba o resumo da semana

Um e-mail por semana com o que foi publicado. Sem spam, e você sai quando quiser.

Blog do Felipe Marciano

Decisões de arquitetura, .NET e sistemas distribuídos, escritas por quem vive com as consequências delas.

© 2026 Felipe Marciano. Todos os direitos reservados. · v1.54.0