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

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.

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

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.

  1. 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.
  2. Reaproveitar o que já existe: histórico de etapa, e-mail por etapa, arrastar e soltar entre colunas.
  3. Cada parada precisa ser filtrável e mensurável.
  4. 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.

modelagem de domínio funil workflow

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