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

gti-maquina-comercial/docs/01-visao-geral.md

@@ -0,0 +1,62 @@
+# 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).