GTI Máquina Comercial

Aplicativo local do Grupo GTI para capturar e tratar leads B2B em qualquer estado/cidade do Brasil, com foco na base oficial de CNPJs da Receita Federal.

Como usar (dia a dia)

1. Dê dois cliques em GTI-Comercial.exe (ou em INICIAR-GTI.bat).
2. O navegador abre em http://127.0.0.1:3900 com duas abas:
   • 📡 Capturar Leads — escolha estado, cidades, nichos e fontes e rode a captura com progresso ao vivo. Se a base CNPJ do estado ainda não existe, o botão "Extrair base agora" prepara tudo (~40–60 min, uma única vez por estado).
   • 📊 Tratar Leads — dashboard com totais e rankings por cidade/nicho, navegador de leads com filtros (qualidade, WhatsApp, exportado...) e o botão Gerar relatório / exportação que produz os arquivos para envio.

Tudo roda somente neste computador (porta local 127.0.0.1). Nenhum dado sai da máquina, exceto as consultas às fontes públicas durante a captura.

Exportações disponíveis

Tipo	Para quê
📊 Planilha (CSV + Excel)	Lista completa com score — números como texto, sem notação científica
🗂️ Z-PRO Oportunidades (JSONL)	Um payload createOpportunity por linha, pronto para importar
📨 Z-PRO Disparo em massa (CSV)	dataInput para BulkSendMessageWithVariable + instruções

Leads exportados ficam marcados — o filtro "ainda não exportados" evita reenvio. Os IDs padrão do Z-PRO (pipeline/etapa/responsável) ficam no ⚙️ Configurações.

O .xls gerado é uma tabela HTML (o Excel avisa sobre o formato ao abrir — é normal, basta confirmar). Use o .csv se preferir.

Qualidade dos leads (score)

Score: +35 telefone válido, +25 CNPJ válido, +25 empresa válida, +5 cidade, +5 nicho, +5 CNAE. Bom ≥ 85, médio 60–84, ruim < 60. Empresa vazia, com lixo ou começando com número é sempre ruim (regra crítica). Duplicidade: CNPJ → WhatsApp → empresa+cidade.

Fontes de captura

• Base CNPJ (Receita Federal) — principal: todas as empresas ativas da UF, ~97% com telefone.
• OpenStreetMap (Overpass e Nominatim) — grátis, complementar.
• Wikidata — grátis, volume baixo.
• BrasilAPI — enriquecimento opcional da base CNPJ.
• Google Places — paga; preencha GOOGLE_MAPS_API_KEY no .env.

Novo estado (ex.: expandir para Sergipe)

1. Na aba Captura, escolha SE — Sergipe.
2. Clique em Extrair base agora e aguarde (usa os zips já baixados em prospeccao/cnpj/rfb-raw/).
3. Pronto: capture qualquer cidade de SE normalmente. Nada muda na interface.

Os zips brutos da Receita (7 GB, Brasil inteiro) já estão no projeto. Para atualizá-los no futuro (a Receita publica mensalmente): bash scripts/baixar-base-rfb.sh.

Uso avançado (linha de comando)

npm start                                             # sobe o servidor
npm test                                              # roda os testes
node scripts/capturar-leads.mjs --sources=cnpj-base --uf=BA --cities="Ilheus"
node scripts/extrair-base-cnpj.mjs --uf=SP            # extrai base de outra UF

Estrutura do projeto

GTI-Comercial.exe      inicia tudo (servidor + navegador)
scripts/               entradas de linha de comando
src/                   código do servidor, fontes de captura, exportações
public/                interface (HTML/CSS/JS)
data/gti.db            banco local (SQLite) com todos os leads
data/exports/          arquivos de exportação gerados
prospeccao/cnpj/       base CNPJ extraída por UF + zips brutos da Receita
docs/                  playbook comercial, LGPD e referência da API Z-PRO

Requisitos

• Windows com Node.js 24+ (https://nodejs.org)
• Para extrair novas UFs: unzip (vem com o Git para Windows) ou o tar nativo do Windows

Log e problemas

• Log do servidor: data/server.log
• Se a tela não abrir: rode node scripts/servidor.mjs num terminal e veja a mensagem.