Lead.Tracker cruza o que você já sabe sobre seus clientes (CRM, planilhas, portfólio técnico) com o que você vende, e aponta onde tem dinheiro na mesa: cliente com Veeam mas sem DR, prospect crescendo sem produto X, conta que vale reavaliação de preço. Tudo com evidência, nunca um palpite.
Regras determinísticas fazem o trabalho pesado; IA é opcional e só entra pra interpretar, correlacionar e redigir — nunca decide sozinha, nunca inventa produto fora do seu portfólio.
Módulo instalável do Tech.Forge.
- Encontra oportunidades de verdade — cross-sell, up-sell, serviços, otimização de custo e modernização, cada uma com motivo e evidência (fato + implicação de negócio + fonte + data, nunca um log técnico cru).
- Prioriza por impacto — score de aderência, potencial financeiro, score estratégico e confiança são números separados, nunca misturados num só.
- Quantifica o tamanho do problema — alcance (isolado/parcial/ generalizado) × criticidade viram uma severidade clara, qualificada pelo vendedor em segundos.
- Acompanha o funil de ponta a ponta — status auditável (detectada → qualificada → revisada → contatada → oportunidade, ou descartada com motivo categorizado), com histórico completo de quando e por quê.
- Garante discovery antes de qualificar — pra avançar uma oportunidade, o vendedor responde com as palavras do cliente por que isso acontece hoje, por que agora e o que o contato ganha ou perde. Sem tempo? "Qualificar sem discovery" com justificativa registrada. Dá pra desligar em Configurações.
- Cuida da carteira, não só de leads novos — saúde de conta e sugestão de quando revisar cada cliente (baseado em renovação + saúde, nunca aleatório), alerta de oportunidade parada há tempo demais.
- Prospecta geograficamente — a partir do seu Google Maps, encontra empresas parecidas com seus melhores clientes (ICP configurável ou derivado automaticamente), com filtro anti-spam por representante/dia. Mostra o site de cada empresa e, rodando a busca de novo, não duplica o que já está na base.
- Se adapta ao seu CRM — mapeia qualquer campo personalizado do Salesforce pra um papel de negócio (sem precisar saber o que é API name), e avisa em português quando um mapeamento quebra.
- Ajuda a escrever o contato — rascunho de e-mail persuasivo com guardas contra alucinação (nunca inventa urgência, nunca cita "cliente parecido" sem caso real), sugestão de próximo passo por cliente/prospect (canal, motivo, cadência) — sempre uma sugestão pra você confirmar, nunca um disparo automático.
- Monta o business case — documento de 1 página por oportunidade (situação, gap, custo de não agir, estado futuro) em PDF, só com o que o motor já calculou; a IA, se ligada, apenas escreve a prosa.
- Avisa quando a conta depende de uma pessoa só — cobertura de contatos por oportunidade: sem decisor tocado recentemente ou com um único contato ativo, aparece a sugestão de abrir um segundo.
- Mostra o panorama — dashboard executivo com KPIs e gráficos, tudo vindo de dado real.
- Completa porte e setor das empresas — em Entrada de dados, ligue a API de dados de empresas que você contratou e clique em "Completar porte e setor": só o que está vazio é preenchido; divergência com outra fonte vira conflito para você resolver.
- Monta o portfólio a partir do seu site — informe o endereço do site da sua empresa em Configurações e clique em "Ler meu site": a IA sugere fabricantes, produtos e serviços, cada um com o trecho do site que o comprova. Você marca o que vale e só então eles entram no portfólio. Só lemos o endereço que você informou, e só com IA configurada.
- Respeita quem não quer ser contatado — marque uma empresa inteira, ou só um contato, como "não contatar" (por canal ou em todos, com motivo). Enquanto estiver ativo, o sistema não sugere o próximo toque nem gera rascunho de e-mail, e pede confirmação explícita pra registrar um contato mesmo assim. Reativar nunca apaga o histórico.
- Mantém o dado confiável entre fontes — se o Salesforce muda o setor de uma empresa, o valor atualiza (e a troca fica registrada). Se duas fontes discordam, nada é sobrescrito: o conflito aparece em Configurações pra você escolher qual manter, e a escolha não é perguntada de novo.
- Registra o que mudou — "histórico de alterações" em cada oportunidade: o que mudou (alcance, criticidade, renovação, discovery e o que a sincronização alterou), antes e depois, quando e por quem. Textos pessoais nunca entram no histórico.
- Poupa seu tempo — exporta PDF/Excel com um clique em toda tela de resultado.
- Funciona com ou sem IA — o motor de oportunidades roda inteiro sem nenhuma chave de API configurada; IA é só um complemento opcional que nunca decide sozinha nem envia nada automaticamente.
O fluxo segue a ordem de trabalho: ver → trazer dados → lapidar e agir → calibrar.
| Aba | O que você faz ali |
|---|---|
| Dashboard | Visão executiva: o que pede decisão hoje (cada número leva à lista já filtrada), valor do pipeline e funil. Cobertura de meta por representante, matriz por categoria e demais indicadores ficam recolhidos. |
| Entrada de dados | A porta de entrada única: atualizar os dados das fontes, conectar Salesforce, Google Maps, o site da sua empresa e uma API de enriquecimento (porte e setor), importar planilha CSV e fazer a prospecção geográfica (assistente guiado). |
| Oportunidades | Lapidar e agir: a lista viva do que o motor encontrou, com status e saúde da conta, filtros, conflitos de dados entre fontes (quando houver), e em cada linha o status, a próxima ação sugerida, "não contatar", rascunho de e-mail, business case, discovery, qualificação e histórico de alterações. Exporta PDF e Excel do que está na tela. |
| Configurações | Calibragem de uso mais raro, em seções recolhíveis: portfólio (inclui "Ler meu site"), regras (com o botão opcional "Sugerir regras com IA": você aceita ou ignora cada sugestão), mapeamento de campos do Salesforce, IA, limites e prazos e metas por representante. |
O campo Você é, no topo, vale para todas as abas (próxima ação, prospecção, escolhas em conflitos e histórico).
Backend em Python/FastAPI, frontend em React/TypeScript, persistência em
SQLite local, providers desacoplados de fonte de dado, IA plugável por
provider, empacotado como .mod do Tech.Forge.
Lead.Tracker não é preso a nenhuma fonte específica — Salesforce é só uma integração opcional entre várias.
Hoje: Salesforce (com mapeamento de campo customizado), Google Maps (prospecção geográfica) e importação de empresas + portfólio por CSV em lote — sem CRM nenhum conectado. No radar: HubSpot, Pipedrive, LinkedIn e outros conectores.
O portfólio (fabricante, produto, serviço e as regras que os conectam) é cadastrado direto na tela de Configurações ou importado em lote por CSV. Nunca é inventado por IA nem por integração nenhuma — toda oportunidade referencia só o que já está no seu catálogo configurado.
Uma planilha viva: filtre por cliente ou prospect, por produto ou serviço, ordene por score ou potencial financeiro, expanda qualquer empresa pra ver as fontes por trás do número. Copie o que precisar ou gere um rascunho de e-mail comercial direto dali.
Regras determinísticas são a base — a IA entra depois, só pra interpretar contexto, correlacionar sinais, enriquecer justificativa e redigir texto. Ela nunca decide sozinha que uma oportunidade existe, e nunca inventa produto ou serviço fora do portfólio configurado.
# Backend
pip install -r backend/requirements.txt
python -m pytest -q # suíte completa
python -m pytest tests/test_opportunity_engine.py -q # um arquivo específico
# Frontend
cd frontend
npm install
npm run build # gera frontend/index.js (build output, gitignored)
npm run test # vitest — lógica pura (filtros/ordenação/paleta)Não faz parte do projeto (é uma dependência de desenvolvimento, gitignored):
git clone https://github.com/julianscunha/Tech.Forge .techforge-dev
# copiar manifest.yaml, backend/, frontend/index.js, core/, providers/, exports/, ai/,
# assets/, docs/ e tests/ para .techforge-dev/modules/installed/lead_tracker/
cd .techforge-dev/core/backend && python run.py # sobe o Core em :8000install()/enable()/health_check() do módulo só são chamados de verdade
via POST /api/v1/marketplace/activate/{id} e /deactivate/{id} — o
endpoint /api/v1/health é um stub do Core que não invoca o ModuleContract
diretamente, só reflete o status do registry.
O Lead.Tracker é um módulo do ecossistema Tech.Forge e deve respeitar seu contrato de módulo, SDK, frontend host e empacotamento.
- Core da plataforma:
Tech.Forge - Catálogo oficial de módulos:
Tech.Forge.Modules
Este repositório é o desenvolvimento do módulo — a distribuição pro catálogo oficial acontece a partir do .mod publicado em cada release.
Tudo em docs/: visão geral e critérios de qualificação (uso do produto), princípios, o que já foi construído (docs/implementacao/) e o que ainda falta (docs/roadmap.md).
Contribuições são bem-vindas. Veja CONTRIBUTING.md para as regras de domínio que todo PR precisa respeitar, como rodar o projeto localmente e o fluxo de contribuição.
MIT.