# Visão Geral

O Grupo GTI opera uma **máquina comercial local**: um aplicativo (GTI-Comercial.exe)
que captura leads B2B das fontes públicas — principalmente a base oficial de CNPJs
da Receita Federal — e ajuda a tratá-los e exportá-los para as campanhas de
WhatsApp no Z-PRO.

## Soluções vendidas

- **ERP e sistemas de gestão** para comércio, serviços, restaurantes, mercados e distribuidoras.
- **Gestão de TI** para empresas com suporte, infraestrutura, servidores, redes, backup e segurança.
- **Autoatendimento para WhatsApp** com triagem, atendimento automático, vendas e agendamento.

Cada nicho do catálogo (57 nichos) já vem associado ao interesse provável e às dores
típicas, que alimentam a personalização das mensagens.

## Arquitetura (simples de propósito)

```
GTI-Comercial.exe → servidor Node local (porta 3900) → navegador
                        │
                        ├── Captura: base CNPJ por UF + OpenStreetMap + Wikidata (+ Google opcional)
                        ├── Banco SQLite local (data/gti.db): leads, score, dedup, histórico
                        └── Tratamento: dashboard, filtros, relatórios e exportações Z-PRO
```

Sem n8n, sem serviços externos obrigatórios: tudo roda no computador da GTI hoje
(e vai rodar num container Docker no Proxmox da empresa no futuro, sem mudança de
código). O primeiro contato via WhatsApp pode ser automático (ver
[08-automacao-envio.md](08-automacao-envio.md)); campanhas maiores e o
acompanhamento seguem por fora, no Z-PRO, a partir dos arquivos gerados pelo
módulo de tratamento.

## Premissas

- Foco inicial na Bahia (Santo Antônio de Jesus e região + capitais), mas o app
  funciona para **qualquer UF/cidade do Brasil** sem mudança de interface.
- A equipe não tem braço para operação manual intensa: o app faz a triagem
  (score de qualidade dos dados + score comercial por nicho, combinados numa
  prioridade P1-P4) e evita retrabalho (leads exportados ficam marcados).
- O WhatsApp é o canal central de conversão — leads com telefone válido têm prioridade.

## Resultado esperado

- Base grande e organizada de leads com WhatsApp (97%+ de cobertura via base CNPJ).
- Relatórios por nicho/cidade prontos para campanhas segmentadas.
- Histórico de tudo que já foi exportado/enviado, sem duplicar contato.
- Dashboard de gestão comercial na tela de Tratamento: percentual da base
  pronta para abordagem imediata (Potencial Comercial), cobertura da base
  já trabalhada, distribuição visual por prioridade, produtos recomendados
  por cidade e meta diária de exportações da equipe.
- Interface explica o "porquê" de cada score (composição detalhada no modal
  do lead), destaca a cidade+produto de maior oportunidade, mostra a
  evolução diária de exportações e oferece atalhos de um clique para gerar
  listas de prospecção (só P1, só um produto, só não exportados etc.).
- Acesso protegido por login (usuário/senha): o primeiro acesso vem com
  `admin`/`admin`, que pode cadastrar novos usuários (comercial ou admin)
  pela tela de Usuários.
- Automação de primeiro contato via WhatsApp (opcional, desligada por padrão):
  manda uma mensagem com o template do produto recomendado pra cada lead ainda
  não exportado, registra o que foi mandado e aplica tags no contato do Z-PRO —
  ver [08-automacao-envio.md](08-automacao-envio.md).