ADR-022
O ciclo de proposta é etapa do funil, e não status da cotação
O documento passa por três mãos antes de chegar ao cliente, e nada disso era modelado: o negócio ficava na mesma etapa do começo ao fim. Tabela de workflow genérica foi descartada para quatro transições conhecidas.
Trilha Ciclo de proposta e cotação, 2ª de 4.
Contexto
O sistema assumia um ciclo de uma pessoa só: quem gera a cotação envia ao cliente e registra a resposta. A operação real passa o documento por três mãos antes de chegar ao cliente: quem cria preenche os dados iniciais, o vendedor revisa, um terceiro usuário preenche os valores da precificação e devolve, o vendedor finaliza e envia. Nada disso era modelado: o negócio ficava na mesma etapa do começo ao fim, e não havia como saber quem preencheu qual valor, nem quando.
Critérios que pesaram
Em ordem de peso.
- O quadro de acompanhamento é onde a operação olha. Se o documento está com o precificador há três dias e o cartão não mostra, a informação não existe na prática.
- Reaproveitar o que já existe: histórico de etapa, e-mail por etapa, arrastar e soltar entre colunas.
- Cada parada precisa ser filtrável e mensurável.
- Não construir motor genérico para um fluxo conhecido.
Opções consideradas
- Novos valores no enum de status da cotação: mexe pouca coisa e concentra tudo no módulo de cotação, mas o negócio continua parado no quadro e o funil mente sobre onde o trabalho está; além disso, esse enum já tinha sido renumerado uma vez e é referenciado em índice parcial. Descartada.
- Tabela de workflow genérica, com transições configuráveis. Flexível para o futuro, e sobre-engenharia para quatro transições conhecidas: nada no produto pedia motor genérico. Descartada.
- Etapas de negócio próprias, marcadas por flags na etapa, seguindo o padrão que o funil já usava.
Decisão
Cada parada do ciclo virou uma etapa do funil, identificada por uma flag booleana na etapa, o mesmo padrão agnóstico das flags que já existiam para "gerar cotação" e "iniciar operação", sem nada amarrado a nome ou a ordem. São cinco: aguardando vendedor, aguardando precificação, cotação retornada, enviar proposta e aguardando aprovação do cliente. A regra é no máximo uma etapa por funil com cada flag; havendo mais de uma, o sistema usa a de menor ordem e registra aviso. As etapas foram semeadas por migration nos funis existentes, com a ordem recalculada, e essa foi a parte mais arriscada da entrega, registrada como tal, porque precisava reordenar sem quebrar a autorreferência entre etapas. Toda transição anexa o PDF completo da cotação no estado em que ela está: cada destinatário recebe o documento inteiro, não um resumo, e por isso consegue revisar sem abrir o sistema.
Consequências
As duas metades pesam igual.
Melhorou
O quadro passou a refletir onde o trabalho realmente está e há quanto tempo, virando instrumento de gestão do ciclo e não só de cadastro. E o ciclo reaproveitou integralmente a infraestrutura de comunicação que já existia: cada transição grava uma linha na fila de envio, consumida pelo job, e nenhum envio síncrono novo foi criado.
Piorou
O funil passou a carregar conhecimento do ciclo de proposta: são cinco flags a mais na etapa, com validação de exclusividade, e um funil mal configurado quebra o fluxo de um jeito que só aparece na transição. Ficou registrado o caso da etapa órfã: se o usuário responsável pela precificação for desativado, a etapa aponta para alguém que não recebe mais; o envio falha com mensagem clara, mas não há alerta preventivo.
Revisitando hoje
Ainda de pé em set/2026. A escolha entre modelar o ciclo como estado interno do documento ou como posição no funil é a decisão inteira, e o critério que a resolveu vale em qualquer produto: modele onde a operação olha. Status interno é verdade que ninguém vê.
Segundo de doze registros sobre o ciclo de proposta. O anterior tirou uma exigência do lugar errado; este decide onde o ciclo passa a ser visível.