Pular para conteúdo

Dashboard Comercial

O que é

Tela /vendas/dashboard ("Relatórios" → "Dashboard"): visão geral de métricas do funil comercial — contatos novos, Open Finance, propostas em negociação, envios para Mesa, aprovações/negações, aceites e pagamentos — com filtro de período e origem. É a tela padrão que qualquer usuário do time comercial abre primeiro para saber "como está o funil hoje".

Como funciona

A rota renderiza um DashboardSwitcher, que decide entre duas implementações e injeta um toggle flutuante para trocar entre elas:

  • v1 (legada, é o default) — componente monolítico com cards de KPI (ContactMetricsGrid), gráfico composto (recharts) e tabelas, consultando Supabase/UnifiedDatabaseService diretamente.
  • v2 (opt-in, mais nova) — reconstrução com FilterBar, HeroStrip (tiles de destaque), o bloco "Funis de conversão" (FunnelGroup/FunnelCanvas, ver funil-vendas), rankings por parceiro/produto/banco e um agente de IA embutido (AgentFAB/AgentChat) para perguntas em linguagem natural sobre os números. Consome hooks próprios em domains/comercial/dashboard-v2/hooks/* (metricas, funil, pré-aprovação, origens, ranking de produtos/bancos, breakdown de criação etc.), cada um batendo numa rota read-model dedicada.

⚠️ A escolha de versão não persiste: useDashboardVersion sempre inicia em "v1" a cada carregamento da página; o toggle vale só durante a sessão da aba. Ou seja, v1 continua sendo a versão "oficial" hoje — v2 é uma prévia em rollout gradual, não uma substituição já consumada.

Onde vive no código

  • CRM (switcher): apps/crm-menos-juros/client/src/pages/vendas/dashboard-v2/DashboardSwitcher.tsx, useDashboardVersion.ts
  • CRM (v1): apps/crm-menos-juros/client/src/pages/vendas/dashboard/index.tsx, domains/comercial/dashboard/hooks/*
  • CRM (v2): apps/crm-menos-juros/client/src/pages/vendas/dashboard-v2/index.tsx e components/* (HeroStrip, FunnelGroup, FunnelCanvas, TrendChart, OriginsPanel, Ranking, RankingBancosPerfil, RankingProdutos), domains/comercial/dashboard-v2/hooks/* e api/dashboard-api.ts
  • API: apps/api-menos-juros/src/v2/comercial/dashboard/ (v1) e apps/api-menos-juros/src/v2/comercial/dashboard-v2/ (v2), incluindo dashboard-v2-leitura.repository.ts (lê pre_aprovacao_sessoes para o card de pre-aprovacao)

Relacionado

comercial · funil-vendas · metas-comercial · pre-aprovacoes · oportunidades-elegibilidade · negocio

Histórico

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