Gustavo
4f736562f3
This work already existed uncommitted in the main working tree (not authored by this branch) and is required as a runtime dependency for the campaign outreach port (zpro-client, templates, outreach routes/UI). Copied in as-is, untouched, so this feature branch has a working baseline; the original uncommitted state in the main checkout is left exactly as it was.
63 lines
3.3 KiB
Markdown
63 lines
3.3 KiB
Markdown
# 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).
|