Skip to main content

Módulo 13: Dashboard & Relatórios — UI

Status: Rascunho Inicial Regras de negócio: ver regras-negocio/13_dashboard.md Domínio: ver dominio/meta.md


1. Organização dos Painéis na Interface

O acesso aos painéis é unificado em uma aba principal "Dashboard" no menu lateral do CRM, dividida em três visões conforme o perfil do usuário:


2. Componentes da Interface

2.1 Painel Comercial (Vendas & Metas)

  • Gráfico de Funil de Conversão:

    • Componente gráfico mostrando o número de registros em cada estágio: Leads Novos → Qualificados → Propostas → Contratos.
    • Hover sobre as barras exibe a taxa de quebra de cada etapa intermediária.
  • Velocímetro de Metas:

    • Mostrador circular com ponteiro apontando o percentual de atingimento da meta de vendas do período corrente.
    • Exibe o valor total acumulado e a meta cadastrada (ex: "R$ 15.000 / R$ 20.000" ou "12 / 15 Contratos").
    • Barra de progresso alternativa para dispositivos móveis.
  • Ranking de Consultores (Somente Líderes/Gestores):

    • Tabela comparativa listando os melhores consultores da equipe por volume de fechamento no mês corrente, exibindo Nome, Equipe, Quantidade de Contratos e Valor total gerado.

2.2 Painel Operacional (Backoffice & SLAs)

Focado em filas de pendência e tempos médios de trâmite de fluxos.

  • Cards de Status das Filas:
    • Vistorias pendentes de análise: Exibe a quantidade de vistorias no status EM_ANALISE com alerta vermelho se houver registros fora do SLA configurado (ex: mais de 2 horas pendente).
    • Contratos aguardando assinatura: Quantidade de envelopes enviados e sem resposta.
    • Adesões aguardando ativação: Contratos prontos sem conciliação financeira de pagamento de entrada.

2.3 Painel Executivo (Saúde Financeira)

Visão consolidada do negócio com foco estratégico.

  • Grid de Indicadores Financeiros (KPI Cards):
    • Card MRR: Receita Mensal Recorrente projetada.
    • Card Churn Rate: Gráfico de linha demonstrando a evolução das rescisões de contrato mês a mês.
    • Card Inadimplência: Percentual de planos em atraso ativo contra a base de faturamento esperado.

2.4 Interface de Relatórios & Exportação

Tela dedicada para geração e download de planilhas.

  • Filtros Universais:
    • Período (Intervalo de Data Início e Fim).
    • Seleção de Time / Padrinho (Dropdown hierárquico).
    • Seleção de Status da Operação.
  • Lista de Relatórios Disponíveis:
    • Botões dedicados para acionar o job de geração: Produção Cascata, Descartes de Leads ou Vencimento de Proteções.
  • Painel de Downloads/Jobs Ativos:
    • Mostra o progresso de exportações em processamento em segundo plano (Barra de progresso).
    • Ao concluir, o status muda para verde exibindo o botão "Download CSV/XLSX".

3. Indicadores e Cores Semânticas de Alertas

  • Sucesso (Meta atingida, SLAs em dia): Verde Esmeralda.
  • Atenção (Meta em andamento, fila de vistoria moderada): Amarelo Ouro.
  • Crítico (Estouro de SLA de vistoria, alta inadimplência): Vermelho Coral.