# Leads Per Hour — produto, telas e modelo de domínio

O que é: um SaaS de **prospecção outbound B2B** (pt-BR). Gera leads
por ICP, roda **cadências automáticas** (e-mail interno, WhatsApp e **ligação por
IA**), centraliza as conversas e mede o funil. O vendedor opera em cima desses
sinais. Usuário de referência: Bruno Brauns (bruno@pertodigital.com.br).

## As 21 telas e seus grupos

A barra lateral é agrupada nestas 5 seções. Ao criar uma tela que conviva com as
existentes, reutilize o nome e o grupo exatos.

**Operações**
1. Conversas — caixa de entrada multicanal (WhatsApp/e-mail), com status
   (Respondido / Não respondido), vendedor responsável, classificação, origem
   (campanha/cadência) e reunião agendada.

**Criação**
2. Bases Neurais — bases de conhecimento que alimentam a IA/assistentes.
3. Geração de Leads (ICP) — perfis de cliente ideal; gera listas de leads.
4. Lista de Contatos — listas/mailings de contatos.
5. Assinaturas de Envio — identidades/remetentes usados nos disparos.
6. Cadência — templates de sequência (passos por e-mail/WhatsApp), ex.: "JUR + SEO".
7. Automação de Disparos — automação dos envios da cadência.
8. Disparo Direcionado — envio pontual e segmentado.
9. Inbound — entrada de leads inbound.

**Cockpit**
10. Em Tempo Real — contadores ao vivo (Empresas, Contatos, Cadências, Conversas,
    MQL, Reunião) + feed de atividade.
11. Painel de Dados — Totalizadores (Empresas, Contatos, E-mails, Telefones,
    Conversas, Reuniões, Reuniões Indiretas) + Funil Decantado – Outbound, com filtro de período.
12. Métricas de Automação — desempenho das cadências (enviados, abertura, resposta).

**Contato**
13. Social — sinais sociais (LinkedIn etc.).
14. Contatos — base de pessoas.
15. Empresas — base de empresas (setor, contatos, envios, disparos).

**Configuração**
16. Assistentes Virtuais — agentes de IA.
17. WhatsApp — conexão/conta de WhatsApp.
18. BlackList — supressão.
19. Todas as Agendas — agendas/calendários.
20. Usuários — gestão de usuários.
21. Configurações — ajustes gerais.

> Dica de UX: o Cockpit hoje está dividido em 3 telas (10/11/12). Na direção
> "Oráculo", o recomendado é **unificá-las em uma só**. Ver `oraculo-ux.md`.

## Funil decantado – Outbound (4 etapas)

`Leads → Impactado → Conversas → Reuniões`, cada etapa com contagem e % de
conversão da anterior. É a métrica-mãe do produto; o gargalo típico fica em
**Impactado → Conversa**. Sempre que mostrar funil, use exatamente estes nomes.

## Modelo de domínio (entidades)

- **Lead / Contato**: pessoa (nome, cargo, empresa, e-mail, telefone E.164,
  LinkedIn) com um **fit** (0–100) e uma **temperatura** (quente/morno/frio).
- **Empresa**: organização (setor, nº de contatos, envios, disparos).
- **Cadência**: sequência de passos automáticos multicanal (e-mail/WhatsApp/
  ligação IA), com `step` atual / `total` e status (em andamento / concluída).
- **Sinal**: evento que dispara ação — ex.: "abriu o e-mail 3× e não agendou",
  "visitou a página de preços", "concluiu a cadência sem interagir", "respondeu",
  "aceitou conexão". O sinal define a temperatura e a próxima ação.
- **Touch**: um toque (manual ou automático) num canal. Canais manuais do
  vendedor: LinkedIn, WhatsApp, Ligação. Canais da automação/cadência: e-mail,
  WhatsApp, ligação por IA.
- **Histórico da cadência**: timeline do que a automação já fez por um lead
  (cada e-mail/WhatsApp/ligação, com status e a mensagem enviada).

## Dois sinais canônicos (úteis em telas de ação)

1. **Abriu e-mail mas não agendou** → lead quente/morno → tarefas de avanço
   (conectar no LinkedIn, WhatsApp consultivo, ligar).
2. **Passou pela cadência inteira sem interagir** → lead **frio** → mostrar o
   histórico do que já foi tentado (com as mensagens) + uma **sugestão de avanço**
   com um ângulo novo (ex.: conexão pessoal no LinkedIn, sem pitch).

## Dados de exemplo plausíveis (para protótipos)

- Créditos exibidos: `10.824`. Período típico: "01–10 jun, 2026".
- Cadências reais do seed: "JUR + SEO", "NVC2026", "TCU - Geral",
  "Mailing completo HR4Results".
- Funil exemplo: Leads 1.240 → Impactado 470 (38%) → Conversas 108 (9%) →
  Reuniões 14 (1,1%).
- Pessoas de exemplo: Larissa Souza (Alesco), Rafael Teixeira (HR4Results),
  Yasmin Borges (Indorama), Pedro Alves, Diego Martins, Camila Reis.
- Empresas: Alesco, HR4Results, Indorama, Florestal, Vetra Log.
