@danhachuel/leadmaster 0.1.25 → 0.1.27

package/CHANGELOG.md

@@ -37,6 +37,53 @@ normaliza para a forma canônica (ex.: `0.1.0`).
    falha se `process.stdin.resume();` desaparecer, se `.unref()` aparecer, se o
    ciclo de vida vinculado for removido ou se os handlers globais sumirem.
 
+## [0.1.27] — 2026-11-09
+
+### Corrigido (crítico)
+
+- **Launcher — Dummy Server (keep-alive infalível):** as versões anteriores
+  dependiam de `stdin`/timers; quando o MobaXterm fecha a entrada padrão em EOF
+  (perda de foco/variação de PTY), o event loop do Node esvaziava e o prompt
+  voltava logo após "LeadMaster no ar", derrubando o uvicorn junto. Agora o
+  `cmdStart` cria, **logo após o spawn do Python**, um servidor HTTP inativo
+  (`http.createServer` + `keepAliveServer.listen(0, '127.0.0.1')`) — o socket
+  aberto no sistema operacional segura o processo **independentemente do
+  terminal**; o fluxo principal termina em `await new Promise(() => {})`
+  (congelado para sempre) e `stdin.resume`/`setInterval`/`beforeExit` seguem
+  como camadas secundárias. **Testado ao vivo com stdin em EOF (`< NUL`):**
+  node vivo 1min46s+, health 200, exportação CSV 200 no ar, encerramento
+  limpo, zero órfãos.
+- **AGENTS.md:** regra 1 do launcher passa a ser o Dummy Server (camada
+  principal); regra 2 rebaixa stdin/timers a camadas secundárias.
+- **Gates de regressão reforçados** (`test_launcher_protections.py`): falham se
+  `http.createServer`, `keepAliveServer.listen(0, '127.0.0.1')` ou
+  `await new Promise(() => {})` desaparecerem do corpo do `cmdStart`.
+  Suíte completa: **83 passed**.
+
+## [0.1.26] — 2026-11-09
+
+### Adicionado
+
+- **Busca no CRM e exportação CSV** (registro retro-ativo — publicada sem
+  entrada anterior):
+  - `GET /api/crm/leads/export`: CSV de todos os leads com **BOM UTF-8**
+    (`\ufeff`, Excel em português não quebra acentos), delimitador `;`,
+    `text/csv; charset=utf-8` e
+    `Content-Disposition: attachment; filename="leads_leadmaster.csv"`; campos
+    de `extras` **achatados** como colunas `extras_<chave>` e listas (tags) em
+    células separadas por `; `.
+  - Frontend: **barra de busca larga** no CRM com filtragem local instantânea
+    por **Nome, Telefone ou Email** + botão de limpar (Lei de Fitts); botão
+    **"Exportar CSV"** em estilo **neutro/outline** — não compete com o
+    "Adicionar Lead" em gradiente (von Restorff); busca sem resultados mostra
+    *"Nenhum lead encontrado para '...'"* (Zeigarnik).
+  - **Corrigido:** o modelo `LeadIn` descartava o campo `extras` — leads
+    criados manualmente perdiam site/avaliação. Agora o POST preserva
+    `extras` (`LeadIn.extras: dict`).
+  - **3 novos testes pytest** (`backend/tests/test_leads_export.py`): MIME +
+    disposition + BOM + colunas, achatamento de `extras` e exportação de base
+    vazia (só cabeçalho).
+
 ## [0.1.25] — 2026-11-09
 
 ### Adicionado

package/backend/main.py

@@ -13,7 +13,7 @@ import threading
 from contextlib import asynccontextmanager
 from pathlib import Path
 
-from fastapi import FastAPI, HTTPException
+from fastapi import FastAPI, HTTPException, Response
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import FileResponse
 from fastapi.staticfiles import StaticFiles
@@ -94,6 +94,8 @@ class LeadIn(BaseModel):
     observacoes: str = ""
     score: int | None = None
     tags: list[str] = []
+    extras: dict = {}
+    extras: dict | None = None
 
 
 class LeadsImportIn(BaseModel):
@@ -344,6 +346,53 @@ def crm_mover_lead(lead_id: str, dados: dict):
     return atualizado
 
 
+@app.get("/api/crm/leads/export")
+def crm_exportar_leads_csv():
+    """Exporta todos os leads em CSV (UTF-8 com BOM, amigável ao Excel)."""
+    import csv
+    import io
+
+    leads = storage.list_leads()
+
+    def _valor_celula(valor) -> str:
+        if valor is None:
+            return ""
+        if isinstance(valor, (list, tuple)):
+            return "; ".join(str(v) for v in valor)
+        return str(valor)
+
+    # Colunas fixas + união das chaves de `extras` (achatadas com prefixo).
+    colunas = [
+        "id", "nome", "telefone", "email", "fonte", "etapa", "empresa",
+        "cnpj", "endereco", "cidade", "observacoes", "score", "tags",
+        "criado_em", "atualizado_em",
+    ]
+    extras_keys: list[str] = []
+    for lead in leads:
+        for chave in (lead.get("extras") or {}):
+            coluna = f"extras_{chave}"
+            if coluna not in extras_keys:
+                extras_keys.append(coluna)
+    colunas.extend(sorted(extras_keys))
+
+    buffer = io.StringIO()
+    escritor = csv.writer(buffer, delimiter=";", quoting=csv.QUOTE_MINIMAL)
+    escritor.writerow(colunas)
+    for lead in leads:
+        linha = [_valor_celula(lead.get(coluna)) for coluna in colunas[: len(colunas) - len(extras_keys)]]
+        extras = lead.get("extras") or {}
+        for coluna in sorted(extras_keys):
+            linha.append(_valor_celula(extras.get(coluna[len("extras_"):])))
+        escritor.writerow(linha)
+
+    conteudo = "\ufeff" + buffer.getvalue()  # BOM: Excel em pt-BR lê os acentos
+    return Response(
+        content=conteudo.encode("utf-8"),
+        media_type="text/csv; charset=utf-8",
+        headers={"Content-Disposition": 'attachment; filename="leads_leadmaster.csv"'},
+    )
+
+
 @app.put("/api/crm/leads/{lead_id}")
 def crm_editar_lead(lead_id: str, dados: dict):
     """Edita os dados principais do lead (modal de detalhes do CRM).

package/backend/tests/test_launcher_protections.py

@@ -54,13 +54,18 @@ class TestLauncherProtections:
         assert "já está rodando" not in c
 
     def test_keepalive_no_fluxo_do_start(self):
-        # Gate de FLUXO (regressão da 0.1.21): as proteções precisam existir
-        # dentro do cmdStart — no install, em função morta ou em bloco errado
-        # não valem. A morte prematura do Node devolve o prompt do MobaXterm.
+        # Gate de FLUXO (regressões da 0.1.21/0.1.24): as proteções precisam
+        # existir dentro do cmdStart — no install, em função morta ou em bloco
+        # errado não valem. A morte prematura do Node devolve o prompt do
+        # MobaXterm. A camada PRINCIPAL é o Dummy Server (socket do SO);
+        # setInterval/stdin/beforeExit são secundárias.
         corpo = _corpo_cmd_start()
         assert "spawn(" in corpo  # worker Python é spawnado no start
-        assert "process.stdin.resume();" in corpo  # terminal preso
-        assert "setInterval(() => {}, 1000)" in corpo  # keep-alive
+        assert "http.createServer" in corpo  # Dummy Server: camada principal
+        assert "keepAliveServer.listen(0, '127.0.0.1')" in corpo
+        assert "await new Promise(() => {})" in corpo  # fluxo principal congelado
+        assert "process.stdin.resume();" in corpo  # camada secundária
+        assert "setInterval(() => {}, 1000)" in corpo  # camada secundária
         assert "beforeExit" in corpo  # rede de segurança do event loop
         assert "child.on('exit'" in corpo or 'child.on("exit"' in corpo
         assert "child.on('close'" in corpo or 'child.on("close"' in corpo
@@ -69,10 +74,10 @@ class TestLauncherProtections:
     def test_start_nunca_chama_exit_apos_terminal_preso(self):
         # Após o terminal ser preso, nenhum caminho de sucesso chama
         # process.exit — a saída só ocorre pelo ciclo de vida do filho
-        # (child exit/close) ou por sinais de parada legítima.
+        # (child exit/close) ou por sinais de parada legítima (SIGTERM/SIGBREAK).
         corpo = _corpo_cmd_start()
         pos = corpo.index("process.stdin.resume();")
-        fim_iife = corpo.index("})().catch(")  # catch de erro fatal fica de fora
+        fim_iife = corpo.rindex("process.exit(1);")  # catch de erro fatal, no fim
         assert "process.exit(" not in corpo[pos:fim_iife]
 
     def test_ciclo_de_vida_vinculado(self):

package/backend/tests/test_leads_export.py

@@ -0,0 +1,56 @@
+"""Testes da exportação CSV de leads — GET /api/crm/leads/export.
+
+Valida MIME, Content-Disposition, BOM (acentos no Excel), colunas esperadas e
+presença dos dados dos leads no conteúdo.
+"""
+
+import pytest
+from fastapi.testclient import TestClient
+
+import main
+
+
+@pytest.fixture()
+def client(tmp_path, monkeypatch):
+    monkeypatch.setenv("LEADMASTER_HOME", str(tmp_path))
+    with TestClient(main.app) as c:
+        yield c
+
+
+def test_exportar_csv(client):
+    r = client.get("/api/crm/leads/export")
+    assert r.status_code == 200
+    assert r.headers["content-type"].startswith("text/csv")
+    assert 'attachment; filename="leads_leadmaster.csv"' in r.headers["content-disposition"]
+
+    conteudo = r.content.decode("utf-8-sig")  # remove o BOM para inspecionar
+    assert r.content.startswith(b"\xef\xbb\xbf")  # BOM presente (Excel pt-BR)
+    linhas = [l for l in conteudo.splitlines() if l.strip()]
+    cabecalho = linhas[0].split(";")
+    for coluna in ("id", "nome", "telefone", "email", "fonte", "etapa"):
+        assert coluna in cabecalho
+    # Um lead de demonstração (seed) aparece no conteúdo.
+    assert any("Bella Massa" in l or "Horizonte" in l for l in linhas[1:])
+
+
+def test_exportar_csv_achata_extras(client):
+    # Cria um lead com extras (dados do scraper real).
+    client.post(
+        "/api/crm/leads",
+        json={"nome": "Empresa com Extras", "telefone": "(11) 95555-0000", "extras": {"site": "https://empresa.com", "avaliacao": 4.7}},
+    )
+    r = client.get("/api/crm/leads/export")
+    assert r.status_code == 200
+    conteudo = r.content.decode("utf-8-sig")
+    assert "extras_site" in conteudo.splitlines()[0]
+    assert "https://empresa.com" in conteudo
+
+
+def test_exportar_csv_sem_leads(client):
+    # Base vazia: só o cabeçalho.
+    home = main.storage.storage_dir()
+    (home / "leads.json").write_text("[]", encoding="utf-8")
+    r = client.get("/api/crm/leads/export")
+    assert r.status_code == 200
+    linhas = [l for l in r.content.decode("utf-8-sig").splitlines() if l.strip()]
+    assert len(linhas) == 1  # apenas o cabeçalho