Pular para conteúdo

Funil de Vendas

O que é

Tela /vendas/funil ("Relatórios" → "Funil"): mostra a queda (drop-off) de volume em cada etapa da jornada, do primeiro contato até o pagamento, para achar onde o funil comercial mais perde gente.

Como funciona

A página combina duas fontes num só lugar:

  1. Funil calculado no cliente — consultas diretas ao Supabase (via UnifiedDatabaseService) agregadas por dia/origem, com as etapas: Novos Contatos Total → Novos Contatos Completos → Contatos Dentro do Perfil → Contatos com Open Finance → Contatos Enviados para Mesa → Propostas Negadas → Contatos com 1+ Propostas (aprovado) → Propostas Aceitas → Propostas Pagas. Cada etapa mostra quantidade, valor e % acumulado.
  2. Dashboard Metabase embutido ("Dashboard de Análise (Metabase)", ao final da página) — iframe assinado via JWT (token de 10min, auto-renovado), servido pelo endpoint GET /v2/metabase/funil-vendas-token (dashboard Metabase #7).

Diferença de escopo com o bloco "Funis de conversão" do dashboard-comercial v2 (FunnelGroup): aquele é uma visão compacta multi-funil dentro do dashboard geral; esta tela é o relatório dedicado, com o detalhamento etapa a etapa e o dashboard Metabase.

Regras de negócio

⚠️ A documentar. Esta tela ainda não tem as regras de negócio levantadas do código.

O que entra aqui: invariante (o que nunca pode acontecer), permissão (quem pode fazer o quê), bloqueio (o que impede a ação e a mensagem que o usuário vê), cálculo (fórmula e arredondamento) e efeito colateral (o que mais muda quando isso acontece).

Regra só entra aqui com origem no código — arquivo e linha. Regra que alguém "acha que é assim" é pior que seção vazia, porque vira decisão de produto baseada em memória.

Onde vive no código

  • CRM: apps/crm-menos-juros/client/src/pages/vendas/funil/index.tsx
  • API (token do embed Metabase): apps/api-menos-juros/src/v2/shared/metabase/metabase.controller.ts (rota funil-vendas-token, dashboard Metabase #7), metabase.service.ts

Relacionado

comercial · dashboard-comercial · pipe-e-etapa · negocio · proposta

Histórico

  • 2026-07-10 (INGEST wiki): página criada para o cluster de Relatórios/Analytics do Comercial.