@danhachuel/leadmaster 0.0.0-stage → 0.1.1

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+Todas as mudanças notáveis deste projeto serão documentadas neste ficheiro.
+O formato é baseado no [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.0/).
+
+A etiqueta visual de versão usa patch de dois dígitos (ex.: `0.1.00`); o registry NPM
+normaliza para a forma canônica (ex.: `0.1.0`).
+
+## [0.1.01] — 2026-10-23
+
+### Removido
+
+- **Pipeline de vídeos faceless** — o LeadMaster agora é 100% focado em prospecção
+  (CRM, extratores de leads e agentes de IA). Removidos:
+  - Aba lateral "Pipeline de Vídeos", página e rota `/pipeline`.
+  - Integrações com MoneyPrinterTurbo, Short-Video-Maker, OpenMontage e upload para
+    YouTube: serviços backend, endpoints `/api/pipeline`, cards e testes em
+    Ferramentas, menções no Painel, tutorial do header, FAQ do Suporte e
+    diagnóstico.
+  - Motor do pipeline, agendador de publicação e contadores diários de upload.
+  - `pipeline.json` do armazenamento local — removido automaticamente das
+    instalações existentes, junto com as chaves de vídeo do `config.json`
+    (`integracoes.moneyprinter`, `short_video_maker`, `openmontage`,
+    `youtube_upload`, `uploads`) e o evento de webhook `video.publicado`.
+
+### Adicionado
+
+- Migração automática de configuração: chaves de vídeo de versões antigas são
+  limpas na primeira execução da nova versão.
+- Card "Status da Conexão" do Painel passa a mostrar LLM e OpenOutreach.
+
+### Alterado
+
+- Backend de desenvolvimento (uvicorn) agora usa a porta **8010** — a 8000 costuma
+  ser usada por outros serviços locais (ex.: PandaNews), o que causava conflito.
+
+## [0.1.00] — 2026-10-23
+
+### Adicionado
+
+- **Versão inicial do LeadMaster** — SaaS local de prospecção e automação de conteúdo,
+  instalável via `npx @danhachuel/leadmaster` e 100% offline (sem nuvem).
+- **Launcher NPM** (`scripts/cli.mjs`): comandos `install`, `start`, `doctor`, `version`,
+  `help`; **comando único auto-suficiente** (estilo Thunderbolt) — `npx
+  @danhachuel/leadmaster` sem argumentos verifica e prepara tudo sozinho antes de subir;
+  **instalação idempotente** (dependências Python e Node só são instaladas/atualizadas
+  quando realmente faltam; interface só é reconstruída quando o build não existe ou
+  falha por deps desatualizadas); resolução da pasta de dados (`--home` /
+  `LEADMASTER_HOME`, padrão `Documents/REPOSITORIO/LeadMaster`); instalação automática
+  das dependências Python; porta padrão da UI/API **5055** com auto-incremento (5056,
+  5057, ...) quando ocupada; deteção de instância já ativa; abertura automática do
+  navegador; encerramento limpo.
+- **Workflow de publicação** (`.github/workflows/publish-npm.yml`): build do frontend,
+  validação de metadados, smoke-test do launcher, publicação via `dist-tag next`,
+  verificação de tarball e promoção a `latest` por tag `v*`.
+- **Backend FastAPI** (`backend/`):
+  - Persistência local em JSON (`storage/leads.json`, `campaigns.json`, `pipeline.json`,
+    `config.json`) com escrita atômica e seeds automáticas.
+  - CRUD de leads com importação em massa, agente de CRM (sugestão de movimentação e
+    enriquecimento via BrasilAPI/LLM).
+  - Campanhas de disparo com execução em background, contadores e log por lead.
+  - Motor do pipeline de vídeos faceless com 5 etapas (roteiro, thumbnail/título,
+    produção wide 16:9, produção shorts 9:16, upload), controle
+    iniciar/pausar/parar/repetir, logs por etapa e agendamento de publicação
+    (não listado → 1h → público).
+  - Integrações: MoneyPrinterTurbo (localhost:8080), Short-Video-Maker (localhost:3123),
+    OpenMontage (CLI), upload YouTube com limite de 50/dia e fallback
+    `youtube-uploader-mcp`, LLM OpenAI-compatível, OpenOutreach, pipecat.
+  - Extratores de leads: Google Maps (`gosom/google-maps-scraper`), Instagram
+    (`lucasoal/igmapper`), CNPJ (BrasilAPI + provedor de busca por CNAE/UF +
+    `D4Vinci/Scrapling`).
+  - Endpoints de diagnóstico (`/api/health`, `/api/doctor`), métricas do painel e
+    serving estático da UI construída (modo `npx`).
+- **Frontend React 18 + Vite + TypeScript + Tailwind** (`frontend/`):
+  - UI fiel ao protótipo `LeadMaster v1.0` (sidebar `#1e1b4b`, cards brancos, gradientes
+    indigo/purple, Font Awesome) com as 7 Leis de UX aplicadas; **favicon de urso** nas
+    guias dos navegadores (`frontend/public/favicon.svg`).
+  - Páginas: Painel (métricas + gráficos Chart.js), Leads (CRUD + progresso de
+    preenchimento), CRM Kanban (`@dnd-kit` — Leads/Em contato/Proposta/Fechado),
+    Disparos (campanhas), Extratores (Google Maps/Instagram/CNPJ), Pipeline de vídeos,
+    Agentes (disparo/atendimento), Ferramentas (configuração de chaves e caminhos),
+    Webhook e Suporte (diagnóstico).
+  - Componentes: Sidebar, Header, MetricCard, ProgressBar, Accordion, Modal, Toast,
+    StatusBadge, gráficos (barras horizontais e doughnut) e Kanban com drag-and-drop.
+- **Documentação**: `README.md` (instalação, arquitetura, integrações), `AGENTS.md`
+  (regras de projeto, versionamento `MAJOR.MINOR.PATCH` com patch de dois dígitos,
+  release via GitHub Actions, push obrigatório, CHANGELOG obrigatório) e `LICENSE` (MIT).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dan Pariente Hachuel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,119 @@
-# Temporary Holding Version
+# LeadMaster
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**SaaS local de prospecção.** CRM, extratores de leads e agentes de IA — instalável via
+`npx`, 100% local, sem nuvem e sem banco de dados externo.
+
+![Stack](https://img.shields.io/badge/React%2018-Vite%20%2B%20TS-61dafb) ![Backend](https://img.shields.io/badge/FastAPI-Python%203.11%2B-009688) ![Storage](https://img.shields.io/badge/storage-JSON%20local-orange)
+
+---
+
+## Instalação e uso
+
+Requisitos: **Node 18+** e **Python 3.11+** no PATH.
+
+```cmd
+:: CMD / MobaXterm (Windows)
+npx.cmd --yes --prefer-online @danhachuel/leadmaster@0.1.0 install
+npx.cmd --yes --prefer-online @danhachuel/leadmaster@0.1.0
+```
+
+```bash
+# Linux / macOS / PowerShell
+npx --yes @danhachuel/leadmaster@0.1.0 install
+npx --yes @danhachuel/leadmaster@0.1.0
+```
+
+- `install` prepara a pasta de dados e instala as dependências Python.
+- Sem argumentos, o launcher sobe o servidor local (FastAPI na porta **5055**) e abre o
+  navegador automaticamente. Se a porta 5055 estiver ocupada, o LeadMaster sobe
+  automaticamente na próxima livre (5056, 5057, ...). Pressione `Ctrl+C` para encerrar.
+- Flags úteis: `--home=<caminho>` (pasta de dados), `--port=<numero>`,
+  `doctor` (diagnóstico), `help`.
+
+A pasta de dados padrão é `Documents\REPOSITORIO\LeadMaster` (sobrescreva com
+`--home` ou `LEADMASTER_HOME`). Todos os dados — leads, campanhas e
+configuração — ficam em `<home>\storage` como arquivos JSON.
+
+### Modo desenvolvimento (a partir do repositório)
+
+```bash
+npm install          # dependências da raiz (concurrently)
+npm run dev          # sobe backend (uvicorn :8010, reload) + frontend (Vite :5055)
+```
+
+O Vite dev server sobe a UI de desenvolvimento em `http://localhost:5055` (com
+auto-incremento para 5056, 5057... se a porta estiver ocupada) e faz proxy de `/api`
+para `http://127.0.0.1:8010` (backend de desenvolvimento).
+
+---
+
+## Módulos
+
+| Módulo | O que faz |
+|---|---|
+| **Painel** | Status da conexão, taxa de entrega, taxa de erro, total de leads; gráfico de barras (leads por etapa do CRM) e doughnut (campanhas: enviadas × erros). |
+| **Leads** | CRUD completo, importação em massa a partir dos extratores, barra de progresso de preenchimento, enriquecimento por IA. |
+| **CRM Kanban** | Drag-and-drop (@dnd-kit) nas colunas *Leads → Em contato → Proposta → Fechado*; o agente de IA sugere movimentações e enriquece os cards. |
+| **Extratores** | **Google Maps** (palavra-chave + localização, via `gosom/google-maps-scraper`), **Instagram** (URL do perfil, via `lucasoal/igmapper`) e **CNPJ** (BrasilAPI + busca por CNAE/UF + `D4Vinci/Scrapling`). Toda extração gera pré-visualização antes de importar. |
+| **Disparos** | Campanhas de disparo (texto/áudio) com templates configuráveis e execução via `eracle/OpenOutreach`. |
+| **Agentes** | Agente de disparo (prompts/templates) e agente de atendimento (texto via LLM ou voz via `pipecat-ai/pipecat`). |
+| **Ferramentas** | Chaves de API, URLs das integrações locais, testes de conexão — tudo salvo em `config.json` local. |
+
+---
+
+## Arquitetura
+
+```
+npx @danhachuel/leadmaster
+ └─ scripts/cli.mjs            # instala deps Python, sobe uvicorn, abre navegador
+     └─ backend/main.py        # FastAPI: API + serving da UI construída (frontend/dist)
+         ├─ services/storage.py        # JSON local (leads, campanhas, config)
+         ├─ services/extractors.py     # Maps / Instagram / CNPJ
+         ├─ services/crm_agent.py      # sugestões + enriquecimento
+         ├─ services/agents.py         # disparo (OpenOutreach) + atendimento
+         └─ services/llm.py            # LLM OpenAI-compatível
+```
+
+- **Portas**: LeadMaster UI/API `:5055` (auto-incrementa: 5056, 5057, ... se ocupada) ·
+  backend de desenvolvimento `:8000`.
+- **Degradación graciosa**: se um serviço externo não estiver configurado/rodando, a ação
+  falha com mensagem acionável — nada de falsos sucessos.
+
+### Serviços externos (opcionais, todos locais)
+
+| Serviço | Como usar no LeadMaster |
+|---|---|
+| [gosom/google-maps-scraper](https://github.com/gosom/google-maps-scraper) | Informe o caminho do binário em *Ferramentas → Extratores*. |
+| [lucasoal/igmapper](https://github.com/lucasoal/igmapper) | Informe o caminho em *Ferramentas → Extratores*. |
+| BrasilAPI / OpenCNPJ / Scrapling | Consulta por CNPJ e busca por CNAE/UF (configuráveis). |
+| [eracle/OpenOutreach](https://github.com/eracle/OpenOutreach) | Agente de disparo. |
+| [pipecat-ai/pipecat](https://github.com/pipecat-ai/pipecat) | Atendimento por voz. |
+
+---
+
+## UX
+
+A interface replica o protótipo `LeadMaster v1.0` (sidebar escura `#1e1b4b`, cards
+brancos, gradientes indigo/purple) e aplica as **7 Leis de Usabilidade**:
+
+1. **Fitts** — CTAs grandes ("Nova Campanha", "Salvar").
+2. **Hick** — configurações avançadas em accordions.
+3. **Zeigarnik** — barras de progresso (preenchimento de leads e campanhas).
+4. **Jakob** — consistência com o modelo mental do protótipo (menu lateral fixo).
+5. **Gradiente de Meta** — "Faltam 2 campos para o lead ficar completo".
+6. **von Restorff** — botão principal com gradiente sobre fundo neutro.
+7. **Miller** — métricas agrupadas em cards (chunking).
+
+---
+
+## Versionamento e release
+
+- Etiqueta visual: `MAJOR.MINOR.PATCH` com **patch de dois dígitos** (`0.1.00` → `0.1.99`
+  → `0.2.00`; `0.9.99` → `1.0.00`). O NPM normaliza para a forma canônica (`0.1.0`).
+- Publicação **sempre** via GitHub Actions (`.github/workflows/publish-npm.yml`):
+  dispatch manual com `dist-tag next` → push da tag `vX.Y.ZZ` → promoção a `latest`.
+- Toda versão precisa de entrada no `CHANGELOG.md`. Regras completas em `AGENTS.md`.
+
+## Licença
+
+[MIT](LICENSE) © Dan Hachuel

package/backend/main.py

@@ -0,0 +1,466 @@
+"""LeadMaster — API FastAPI (100% local).
+
+Rotas da aplicação + serving estático da UI construída (frontend/dist) para o
+modo `npx`, onde um único servidor entrega painel e API na mesma porta.
+"""
+
+import json
+import os
+import platform
+import sys
+import threading
+from contextlib import asynccontextmanager
+from pathlib import Path
+
+from fastapi import FastAPI, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import FileResponse
+from fastapi.staticfiles import StaticFiles
+from pydantic import BaseModel, Field
+
+from services import agents, crm_agent, extractors, llm, storage
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+FRONTEND_DIST = REPO_ROOT / "frontend" / "dist"
+
+
+def _versao() -> str:
+    env = os.environ.get("LEADMASTER_VERSION")
+    if env:
+        return env
+    try:
+        return json.loads((REPO_ROOT / "package.json").read_text(encoding="utf-8"))["version"]
+    except Exception:
+        return "dev"
+
+
+VERSION = _versao()
+
+
+@asynccontextmanager
+async def lifespan(_app: FastAPI):
+    storage.ensure_seeds()
+    yield
+
+
+app = FastAPI(title="LeadMaster API", version=VERSION, lifespan=lifespan)
+
+app.add_middleware(
+    CORSMiddleware,
+    # A UI local (npx) roda same-origin; em modo dev o Vite sobe em 5055 e pode
+    # auto-incrementar (5056, 5057...) quando a porta está ocupada — por isso
+    # aceitamos qualquer porta em localhost/127.0.0.1.
+    allow_origin_regex=r"https?://(localhost|127\.0\.0\.1)(:\d+)?",
+    allow_methods=["*"],
+    allow_headers=["*"],
+)
+
+
+# ---------------------------------------------------------------------------
+# Models
+# ---------------------------------------------------------------------------
+
+class LeadIn(BaseModel):
+    nome: str = Field(min_length=1)
+    telefone: str = ""
+    email: str = ""
+    fonte: str = "Manual"
+    etapa: str = "leads"
+    cnpj: str = ""
+    empresa: str = ""
+    endereco: str = ""
+    cidade: str = ""
+    observacoes: str = ""
+    score: int | None = None
+    tags: list[str] = []
+
+
+class LeadsImportIn(BaseModel):
+    leads: list[dict]
+
+
+class CampaignIn(BaseModel):
+    nome: str = Field(min_length=1)
+    canal: str = "texto"
+    template: str = "texto"
+    lead_ids: list[str] = []
+
+
+class GoogleMapsIn(BaseModel):
+    palavra_chave: str = Field(min_length=2)
+    localizacao: str = Field(min_length=2)
+    max_resultados: int = 100
+
+
+class InstagramIn(BaseModel):
+    profile_url: str = Field(min_length=6)
+
+
+class CnpjIn(BaseModel):
+    cnpj: str = Field(min_length=8)
+
+
+class CnpjSearchIn(BaseModel):
+    cnae: str = Field(min_length=2)
+    uf: str = Field(min_length=2)
+    quantidade: int = 20
+
+
+class ChatIn(BaseModel):
+    mensagens: list[dict]
+
+
+class TemplateTestIn(BaseModel):
+    template: str
+    lead_id: str | None = None
+
+
+class WebhookTestIn(BaseModel):
+    url: str = Field(min_length=8)
+
+
+class IntegracaoTestIn(BaseModel):
+    url: str
+
+
+# ---------------------------------------------------------------------------
+# Sistema
+# ---------------------------------------------------------------------------
+
+@app.get("/api/health")
+def health():
+    return {
+        "status": "ok",
+        "versao": VERSION,
+        "home": str(storage.get_home()),
+        "storage": str(storage.storage_dir()),
+    }
+
+
+@app.get("/api/doctor")
+def doctor():
+    integracoes = {
+        "llm_configurado": llm.configurado(),
+        "openoutreach": agents.disparo_configurado(),
+        "pipecat": bool(storage.get_config()["integracoes"]["pipecat"].get("url")),
+    }
+    return {
+        "ok": True,
+        "versao": VERSION,
+        "python": platform.python_version(),
+        "sistema": platform.platform(),
+        "dist_frontend": FRONTEND_DIST.exists(),
+        "storage": str(storage.storage_dir()),
+        "integracoes": integracoes,
+    }
+
+
+@app.post("/api/shutdown")
+def shutdown():
+    threading.Timer(0.6, os._exit, [0]).start()
+    return {"ok": True, "mensagem": "Servidor local encerrando em instantes."}
+
+
+# ---------------------------------------------------------------------------
+# Métricas (Painel)
+# ---------------------------------------------------------------------------
+
+@app.get("/api/metrics")
+def metrics():
+    leads = storage.list_leads()
+    campaigns = storage.list_campaigns()
+    enviadas = sum(int(c.get("enviadas", 0)) for c in campaigns)
+    erros = sum(int(c.get("erros", 0)) for c in campaigns)
+    total_envios = enviadas + erros
+
+    return {
+        "conexao": {
+            "geral": True,  # o backend local responde => conectado
+            "llm": llm.configurado(),
+            "openoutreach": agents.disparo_configurado(),
+        },
+        "taxa_entrega": round(enviadas / total_envios * 100, 1) if total_envios else 100.0,
+        "taxa_erro": round(erros / total_envios * 100, 1) if total_envios else 0.0,
+        "total_enviadas": enviadas,
+        "total_erros": erros,
+        "leads_total": len(leads),
+        "leads_por_etapa": {
+            etapa: sum(1 for l in leads if l.get("etapa") == etapa)
+            for etapa in ("leads", "em_contato", "proposta", "fechado")
+        },
+        "campanhas": {"enviadas": enviadas, "erros": erros, "total": len(campaigns)},
+        "perfil": storage.get_config().get("perfil", {}),
+    }
+
+
+# ---------------------------------------------------------------------------
+# Leads
+# ---------------------------------------------------------------------------
+
+def _validar_etapa(etapa: str) -> str:
+    if etapa not in ("leads", "em_contato", "proposta", "fechado"):
+        raise HTTPException(400, "Etapa inválida. Use: leads, em_contato, proposta ou fechado.")
+    return etapa
+
+
+@app.get("/api/leads")
+def listar_leads():
+    return storage.list_leads()
+
+
+@app.post("/api/leads", status_code=201)
+def criar_lead(lead_in: LeadIn):
+    lead = lead_in.model_dump()
+    lead["id"] = storage._novo_id()
+    lead["etapa"] = _validar_etapa(lead.get("etapa", "leads"))
+    lead["score"] = lead.get("score") if lead.get("score") is not None else crm_agent.calcular_completude(lead)
+    storage.add_lead(lead)
+    agents.disparar_webhook("lead.criado", {"lead_id": lead["id"], "nome": lead["nome"]})
+    return lead
+
+
+@app.patch("/api/leads/{lead_id}")
+def atualizar_lead(lead_id: str, patch: dict):
+    if patch.get("etapa"):
+        _validar_etapa(patch["etapa"])
+    atualizado = storage.update_lead(lead_id, patch)
+    if not atualizado:
+        raise HTTPException(404, "Lead não encontrado.")
+    if patch.get("etapa"):
+        agents.disparar_webhook("lead.etapa", {"lead_id": lead_id, "etapa": patch["etapa"]})
+    return atualizado
+
+
+@app.delete("/api/leads/{lead_id}")
+def remover_lead(lead_id: str):
+    if not storage.delete_lead(lead_id):
+        raise HTTPException(404, "Lead não encontrado.")
+    return {"ok": True}
+
+
+@app.post("/api/leads/import")
+def importar_leads(dados: LeadsImportIn):
+    for lead in dados.leads:
+        lead["etapa"] = _validar_etapa(lead.get("etapa", "leads"))
+    return storage.import_leads(dados.leads)
+
+
+@app.post("/api/leads/{lead_id}/enrich")
+def enriquecer_lead(lead_id: str):
+    resultado = crm_agent.enriquecer_lead(lead_id)
+    if not resultado.get("ok"):
+        raise HTTPException(404, resultado.get("mensagem", "Lead não encontrado."))
+    return resultado
+
+
+# ---------------------------------------------------------------------------
+# CRM (agente)
+# ---------------------------------------------------------------------------
+
+@app.get("/api/crm/sugestoes")
+def sugestoes_crm():
+    return crm_agent.sugerir_movimentacoes()
+
+
+@app.post("/api/crm/sugestoes/aplicar")
+def aplicar_sugestao(dados: dict):
+    lead_id, para = dados.get("lead_id"), dados.get("para")
+    if not lead_id or not para:
+        raise HTTPException(400, "Informe lead_id e para.")
+    atualizado = storage.update_lead(lead_id, {"etapa": _validar_etapa(para)})
+    if not atualizado:
+        raise HTTPException(404, "Lead não encontrado.")
+    agents.disparar_webhook("lead.etapa", {"lead_id": lead_id, "etapa": para, "via": "agente_crm"})
+    return {"ok": True, "lead": atualizado}
+
+
+# ---------------------------------------------------------------------------
+# Campanhas / Disparos
+# ---------------------------------------------------------------------------
+
+@app.get("/api/campaigns")
+def listar_campanhas():
+    return storage.list_campaigns()
+
+
+@app.post("/api/campaigns", status_code=201)
+def criar_campanha(campaign_in: CampaignIn):
+    campaign = campaign_in.model_dump()
+    campaign["id"] = storage._novo_id()
+    campaign.update({"status": "rascunho", "total": len(campaign["lead_ids"]), "enviadas": 0, "erros": 0, "eventos": [], "criado_em": storage.now_iso()})
+    storage.upsert_campaign(campaign)
+    return campaign
+
+
+@app.post("/api/campaigns/{campaign_id}/start")
+def iniciar_campanha(campaign_id: str):
+    resultado = agents.iniciar_campanha(campaign_id)
+    if not resultado.get("ok"):
+        raise HTTPException(400, resultado["mensagem"])
+    return resultado
+
+
+@app.post("/api/campaigns/{campaign_id}/pause")
+def pausar_campanha(campaign_id: str):
+    return agents.pausar_campanha(campaign_id)
+
+
+@app.post("/api/campaigns/{campaign_id}/stop")
+def parar_campanha(campaign_id: str):
+    return agents.parar_campanha(campaign_id)
+
+
+@app.delete("/api/campaigns/{campaign_id}")
+def remover_campanha(campaign_id: str):
+    if not storage.delete_campaign(campaign_id):
+        raise HTTPException(404, "Campanha não encontrada.")
+    return {"ok": True}
+
+
+# ---------------------------------------------------------------------------
+# Extratores
+# ---------------------------------------------------------------------------
+
+@app.post("/api/extract/google-maps")
+def extrair_google_maps(dados: GoogleMapsIn):
+    try:
+        return extractors.extrair_google_maps(dados.palavra_chave, dados.localizacao, dados.max_resultados)
+    except extractors.ExtratorNaoConfigurado as e:
+        raise HTTPException(400, str(e))
+    except extractors.ExtratorErro as e:
+        raise HTTPException(502, str(e))
+
+
+@app.post("/api/extract/instagram")
+def extrair_instagram(dados: InstagramIn):
+    try:
+        return extractors.extrair_instagram(dados.profile_url)
+    except extractors.ExtratorNaoConfigurado as e:
+        raise HTTPException(400, str(e))
+    except extractors.ExtratorErro as e:
+        raise HTTPException(502, str(e))
+
+
+@app.post("/api/extract/cnpj")
+def consultar_cnpj(dados: CnpjIn):
+    try:
+        return extractors.consulta_cnpj(dados.cnpj)
+    except extractors.ExtratorErro as e:
+        raise HTTPException(502, str(e))
+
+
+@app.post("/api/extract/cnpj/search")
+def buscar_cnpj(dados: CnpjSearchIn):
+    try:
+        return extractors.buscar_cnpj_cnae(dados.cnae, dados.uf, dados.quantidade)
+    except extractors.ExtratorErro as e:
+        raise HTTPException(502, str(e))
+
+
+# ---------------------------------------------------------------------------
+# Configuração e integrações
+# ---------------------------------------------------------------------------
+
+@app.get("/api/config")
+def obter_config():
+    return storage.redact_config(storage.get_config())
+
+
+@app.put("/api/config")
+def salvar_config(patch: dict):
+    storage.update_config(patch)
+    return storage.redact_config(storage.get_config())
+
+
+@app.post("/api/config/test/llm")
+def testar_llm():
+    return llm.testar_conexao()
+
+
+@app.post("/api/config/test/integracao")
+def testar_integracao(dados: IntegracaoTestIn):
+    import httpx
+
+    try:
+        r = httpx.get(dados.url, timeout=4)
+        return {"ok": True, "status_http": r.status_code}
+    except httpx.HTTPError as e:
+        return {"ok": False, "mensagem": f"Sem resposta de {dados.url}: {e}"}
+
+
+@app.get("/api/integrations/status")
+def status_integracoes():
+    return {
+        "llm": llm.configurado(),
+        "openoutreach": agents.disparo_configurado(),
+        "pipecat": bool(storage.get_config()["integracoes"]["pipecat"].get("url")),
+    }
+
+
+# ---------------------------------------------------------------------------
+# Agentes
+# ---------------------------------------------------------------------------
+
+@app.get("/api/agents/templates")
+def obter_templates():
+    return agents.obter_templates()
+
+
+@app.put("/api/agents/templates")
+def salvar_templates(patch: dict):
+    return agents.salvar_templates(patch)
+
+
+@app.post("/api/agents/templates/test")
+def testar_template(dados: TemplateTestIn):
+    return agents.testar_template(dados.template, dados.lead_id)
+
+
+@app.post("/api/agents/attendance/chat")
+def atendimento_chat(dados: ChatIn):
+    return agents.atendimento_chat(dados.mensagens)
+
+
+# ---------------------------------------------------------------------------
+# Webhook
+# ---------------------------------------------------------------------------
+
+@app.get("/api/webhook")
+def obter_webhook():
+    return storage.get_config().get("webhook", {})
+
+
+@app.put("/api/webhook")
+def salvar_webhook(patch: dict):
+    config = storage.get_config()
+    webhook = config.get("webhook", {})
+    webhook.update({k: v for k, v in patch.items() if k in ("url", "eventos")})
+    storage.update_config({"webhook": webhook})
+    return webhook
+
+
+@app.post("/api/webhook/test")
+def testar_webhook(dados: WebhookTestIn):
+    return agents.testar_webhook(dados.url)
+
+
+# ---------------------------------------------------------------------------
+# UI estática (modo npx / produção)
+# ---------------------------------------------------------------------------
+
+if FRONTEND_DIST.exists():
+    app.mount("/assets", StaticFiles(directory=FRONTEND_DIST / "assets"), name="assets")
+
+    @app.get("/", include_in_schema=False)
+    def index():
+        return FileResponse(FRONTEND_DIST / "index.html")
+
+    @app.get("/{full_path:path}", include_in_schema=False)
+    def spa(full_path: str):
+        # Rotas de API inexistentes devolvem 404 JSON (não a página do SPA).
+        if full_path.startswith("api/") or full_path == "api":
+            raise HTTPException(404, f"Rota /{full_path} não existe.")
+        alvo = FRONTEND_DIST / full_path
+        if full_path and alvo.is_file():
+            return FileResponse(alvo)
+        return FileResponse(FRONTEND_DIST / "index.html")