Files
COMERCIAL-GTI/gti-maquina-comercial/docs/01-visao-geral.md
T
GustavoandClaude Sonnet 5 f5af038e19 chore: import gti-maquina-comercial history via subtree
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

git-subtree-dir: gti-maquina-comercial
git-subtree-mainline: 93ca82979e
git-subtree-split: b77484946f
2026-09-28 15:50:08 -03:00

3.3 KiB

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); 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.