Commit inicial: GTI Maquina Comercial

App local (Node + SQLite) para captura, tratamento e exportacao de leads
comerciais, com dashboard de gestao, login/usuarios e integracao Z-PRO.

Co-Authored-By: Claude <noreply@anthropic.com>

docs/01-visao-geral.md

@@ -0,0 +1,55 @@
+# 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 Docker, sem serviços externos obrigatórios: tudo roda no computador
+da GTI. O envio das mensagens é feito por fora (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.