Prospek - Sistema de Prospecção de Leads

O que faz

Aplicação web para buscar, salvar e acompanhar leads comerciais. O usuário pesquisa empresas por palavras-chave e localização via SERP API, salva os resultados e gerencia o funil de vendas por status. Webhooks disparam notificações automáticas para sistemas externos a cada evento relevante.

Stack principal

• Next.js 16 com App Router
• TypeScript
• Supabase (PostgreSQL + Auth + RLS)
• Tailwind CSS v4
• shadcn/ui + Radix UI
• SERP API (busca de leads)

Estrutura relevante

/app
  /api/search/route.ts     - Integração com SERP API
  /dashboard               - Listagem e gestão de leads
  /buscar                  - Interface de busca
  /webhooks                - Configuração de webhooks
  /auth/login
  /auth/signup

/scripts
  001_create_tables.sql
  002_create_profile_trigger.sql
  003_create_updated_at_trigger.sql

Banco de dados

Tabela	Função
profiles	Dados do usuário
leads	Leads salvos
webhooks	Configurações de destino
webhook_logs	Histórico de disparos

Comandos comuns

npm run dev       # Servidor de desenvolvimento
npm run build     # Build de produção
npm run start     # Inicia build gerado
npm run lint      # Lint do projeto

Variáveis de ambiente necessárias

SERP_API_KEY
NEXT_PUBLIC_SUPABASE_URL
NEXT_PUBLIC_SUPABASE_ANON_KEY

Webhooks e eventos

Três eventos disponíveis:

• lead_novo - lead salvo pelo usuário
• status_alterado - mudança de status no funil
• busca_completa - pesquisa realizada, inclui até 50 resultados no payload

Status do funil: Novo, Primeiro Contato, Em Conversão, Convertido.

Segurança

RLS habilitado em todas as tabelas. Autenticação gerenciada pelo Supabase Auth. Todas as APIs validam dados antes de persistir.