Pular para conteúdo

Relatório de Pré-Aprovações

O que é

Tela /relatorios/pre-aprovacoes ("Relatórios" → "Pré-Aprovações"): dashboard de análise da API de pre-aprovacao — o resultado das sessões que dizem se um lead está pré-aprovado antes mesmo de virar contato completo no funil.

Como funciona

Página fina: não há lógica de negócio própria no CRM, ela só embute um dashboard Metabase (#6) via iframe assinado por JWT (token de 10min, auto-renovado 1min antes de expirar), servido pelo endpoint GET /v2/metabase/pre-aprovacoes-token. Tem botões "Atualizar" (renova o token) e "Abrir em nova aba".

O mesmo sinal de pré-aprovação aparece de outras duas formas no produto: - Flag preAprovado no read-model do card de negocio (Kanban Comercial). - Métrica dedicada no dashboard-comercial v2 (useDashboardPreAprovacao).

Este relatório é a visão analítica agregada (Metabase), não uma lista operável de leads.

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/relatorios/pre-aprovacoes.tsx
  • API (token do embed Metabase): apps/api-menos-juros/src/v2/shared/metabase/metabase.controller.ts (rota pre-aprovacoes-token, dashboard Metabase #6), metabase.service.ts
  • DB: pre_aprovacao_sessoes (supabase/migrations/20251103194358_create_optimized_pre_approval_structure.sql e migrations subsequentes)

Relacionado

comercial · pre-aprovacao · dashboard-comercial · negocio

Histórico

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