@danhachuel/leadmaster 0.1.25 → 0.1.26

package/CHANGELOG.md

@@ -37,6 +37,30 @@ 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.26] — 2026-11-09
+
+### Adicionado
+
+- **Busca no CRM e exportação CSV:**
+  - `GET /api/crm/leads/export`: gera CSV de todos os leads com **BOM UTF-8**
+    (`\ufeff`, para o Excel em português não quebrar acentos), delimiter `;`,
+    `Content-Type: text/csv; charset=utf-8` e
+    `Content-Disposition: attachment; filename="leads_leadmaster.csv"`. Campos
+    de `extras` são **achatados** como colunas `extras_<chave>` (união das
+    chaves existentes) e listas (tags) viram células separadas por `; `.
+  - Frontend: **barra de busca larga** no topo do CRM com filtragem local
+    instantânea por **Nome, Telefone ou Email** + botão de limpar; **botão
+    "Exportar CSV"** em estilo **neutro** (outline — não compete com o
+    "Adicionar Lead" em gradiente, von Restorff) que baixa o arquivo via blob;
+    busca sem resultados mostra aviso amigável *"Nenhum lead encontrado para
+    '...'"* (Zeigarnik).
+- **Corrigido (pego pelos novos testes):** o modelo `LeadIn` descartava o campo
+  `extras` — leads criados manualmente perdiam site/avaliação. Agora o POST de
+  leads preserva `extras`.
+- **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_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