Campanhas

O que é

Tela /vendas/campanhas ("Relatórios" → "Campanhas"): dashboard de análise de campanha de marketing/aquisição — de onde os leads vieram e como performaram.

Como funciona

Mesmo padrão de pre-aprovacoes: página fina que só embute um dashboard Metabase (#8) via iframe assinado por JWT (token de 10min, auto-renovado), servido pelo endpoint GET /v2/metabase/campanhas-token. Sem lógica de negócio própria no CRM — botões "Atualizar" e "Abrir em nova aba".

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/campanhas/index.tsx
• API (token do embed Metabase): apps/api-menos-juros/src/v2/shared/metabase/metabase.controller.ts (rota campanhas-token, dashboard Metabase #8), metabase.service.ts

Relacionado

comercial · campanha · dashboard-comercial

Histórico

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