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

ADR-023

O precificador é configurado na etapa, não no perfil nem no envio

Quando o vendedor manda a cotação para precificação, para quem ela vai? As quatro respostas possíveis em qualquer fluxo com passagem de bastão, e por que a que custa uma tela de configuração evita as três formas mais comuns de errar.

Trilha Ciclo de proposta e cotação, 3ª de 4.

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

Contexto

Com o ciclo de proposta modelado como etapas do funil, faltava responder uma pergunta operacional: quando o vendedor manda a cotação para precificação, para quem ela vai? Não havia envio para o precificador, nem devolução rastreada: o único envio existente mandava o PDF para o vendedor.

Critérios que pesaram

Em ordem de peso.

  1. Funis diferentes podem ter precificadores diferentes: o produto tem mais de um funil, com operações distintas.
  2. O vendedor precisa ver para quem vai antes de confirmar, sem transformar isso em escolha manual.
  3. Nunca enviar para o vazio. Destinatário ausente tem de ser erro explicado, não silêncio.
  4. A unidade de configuração do fluxo já existe, e é a etapa.

Opções consideradas

  • Enviar para todos os usuários com perfil de gestão: zero configuração, e faz todo gestor passar a receber e-mail de cotação, sem permitir precificadores diferentes por funil. Descartada.
  • Uma flag no cadastro do usuário, do tipo "recebe cotação". Controle explícito por pessoa, e global: não diferencia um funil do outro. Descartada.
  • O vendedor escolher numa lista a cada envio. Máxima flexibilidade, e escolha manual repetida sem padrão: cada vendedor manda para quem quiser. Descartada.
  • Um usuário responsável configurado na própria etapa.

Decisão

A etapa ganhou um campo de usuário responsável, obrigatório quando ela é a etapa de precificação e proibido nas demais, o mesmo padrão de validação que a etapa já usava para a sua outra autorreferência. O precificador é uma função do processo, não da pessoa nem do perfil, e é na etapa que o funil já é configurado. A tela de envio exibe o destinatário resolvido, nome e e-mail, em modo leitura, antes de o vendedor confirmar: atende ao pedido de ver quem vai responder sem transformar isso em decisão a cada envio. Se o usuário responsável estiver inativo ou sem e-mail, o envio falha com erro de validação dizendo qual etapa precisa ser corrigida, e nunca envia para o vazio em silêncio.

Consequências

As duas metades pesam igual.

Melhorou

Cada funil ganhou seu precificador, a configuração ficou num lugar só e visível, e o vendedor passou a saber para quem está mandando antes de mandar. A validação explícita fecha a classe de falha mais chata desse tipo de fluxo: o e-mail que "foi enviado" e não chegou a ninguém.

Piorou

Criou-se uma dependência entre configuração de funil e cadastro de usuário que ninguém reconcilia: desativar uma pessoa deixa a etapa apontando para ela, e o problema só aparece na próxima tentativa de envio. Isso está registrado como ponto em aberto: o envio falha com mensagem clara, mas não há alerta preventivo, e nada varre as etapas procurando responsável inativo.

Revisitando hoje

Ainda de pé em nov/2026, com uma evolução. Em 01/10/2026, a ADR-070 reduziu o ciclo a cinco paradas e manteve a resposta principal desta decisão: o precificador é configurado no ponto do fluxo, e não no perfil da pessoa nem na escolha de quem envia. Deixaram de valer as duas regras que a acompanhavam: a obrigatoriedade na etapa de precificação, que não existe mais, e o destinatário ausente como erro de validação que impedia o envio. A pergunta que essa decisão responde aparece em qualquer fluxo com passagem de bastão (para quem vai?), e as quatro respostas possíveis são sempre as mesmas: por perfil, por flag no usuário, por escolha no ato, ou por configuração no ponto do fluxo. Escolher a quarta custa uma tela de configuração e evita as três formas mais comuns de errar.

Terceiro de doze registros sobre o ciclo de proposta. O anterior criou as paradas do ciclo; este responde para quem cada uma manda o documento.

modelagem de domínio funil e-mail

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