@danhachuel/leadmaster 0.1.24 → 0.1.26

package/CHANGELOG.md

@@ -37,6 +37,52 @@ 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
+
+- **Modal de Detalhes do Lead no CRM (clique no card):**
+  - Rota `PUT /api/crm/leads/{lead_id}` — edição de `nome`, `telefone` e `email`
+    (todos opcionais no payload); nome vazio → **400** (prevenção de erros),
+    lead inexistente → **404**, payload sem campos editáveis → **400**.
+  - Card do Kanban passa a abrir os detalhes no **clique simples** (antes era
+    duplo clique); flag global suprime o clique disparado no pointerup após um
+    drag, então abrir detalhes e arrastar convivem sem conflito.
+  - Modal "Detalhes do Lead" exibe **todos os dados** — inclusive `extras`
+    (Site, Endereço, Avaliação, Seguidores, Username, Bio), tags, fonte e data
+    de criação — com **inputs de edição** para Nome/Telefone/E-mail pré-preenchidos
+    (vermelho + mensagem se o nome for apagado), textarea de observações e botão
+    **"Salvar Alterações"** grande em gradiente (Fitts + von Restorff), com
+    **spinner** durante o salvamento (Zeigarnik), toast de sucesso e
+    **atualização automática** do Kanban. O "Fechar" (X) permanece sutil.
+- **5 novos testes pytest** (`backend/tests/test_lead_edit_routes.py`): edição
+  completa, edição parcial (campos omitidos preservados), 404, nome vazio (400)
+  e payload sem campos editáveis (400).
+
 ## [0.1.24] — 2026-11-09
 
 ### Corrigido

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,71 @@ 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).
+
+    Payload aceita qualquer subconjunto de {nome, telefone, email, ...}; o nome,
+    quando presente, não pode ficar vazio (prevenção de erros).
+    """
+    if "nome" in dados and not str(dados.get("nome") or "").strip():
+        raise HTTPException(400, "O nome do lead não pode ficar vazio.")
+    patch = {k: v for k, v in dados.items() if k in ("nome", "telefone", "email")}
+    if not patch:
+        raise HTTPException(400, "Nenhum campo editável informado (nome, telefone, email).")
+    atualizado = storage.update_lead(lead_id, patch)
+    if not atualizado:
+        raise HTTPException(404, "Lead não encontrado.")
+    return atualizado
+
+
 # ---------------------------------------------------------------------------
 # Campanhas / Disparos
 # ---------------------------------------------------------------------------

package/backend/tests/test_lead_edit_routes.py

@@ -0,0 +1,63 @@
+"""Testes da edição do lead — PUT /api/crm/leads/{lead_id}.
+
+Edição de nome/telefone/email (todos opcionais), persistência, 404 para ID
+inexistente e bloqueio de nome vazio (prevenção de erros).
+"""
+
+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 _criar_lead(client):
+    return client.post("/api/crm/leads", json={"nome": "Lead Original", "telefone": "(11) 90000-0000", "email": "a@b.com"}).json()
+
+
+def test_editar_campos_principais(client):
+    lead = _criar_lead(client)
+    r = client.put(
+        f"/api/crm/leads/{lead['id']}",
+        json={"nome": "Lead Editado", "telefone": "(21) 98888-7777", "email": "novo@empresa.com"},
+    )
+    assert r.status_code == 200
+    corpo = r.json()
+    assert corpo["nome"] == "Lead Editado"
+    assert corpo["telefone"] == "(21) 98888-7777"
+    assert corpo["email"] == "novo@empresa.com"
+    # Persistido no leads.json (a listagem reflete a edição).
+    salvo = [l for l in client.get("/api/crm/leads").json() if l["id"] == lead["id"]][0]
+    assert salvo["nome"] == "Lead Editado"
+
+
+def test_editar_parcial(client):
+    lead = _criar_lead(client)
+    r = client.put(f"/api/crm/leads/{lead['id']}", json={"email": "parcial@x.com"})
+    assert r.status_code == 200
+    assert r.json()["email"] == "parcial@x.com"
+    assert r.json()["nome"] == "Lead Original"  # campos omitidos permanecem
+
+
+def test_editar_inexistente_404(client):
+    r = client.put("/api/crm/leads/nao-existe", json={"nome": "X"})
+    assert r.status_code == 404
+
+
+def test_nome_vazio_bloqueado(client):
+    lead = _criar_lead(client)
+    r = client.put(f"/api/crm/leads/{lead['id']}", json={"nome": "   "})
+    assert r.status_code == 400
+    assert "vazio" in r.json()["detail"]
+
+
+def test_payload_sem_campos_editaveis(client):
+    lead = _criar_lead(client)
+    r = client.put(f"/api/crm/leads/{lead['id']}", json={"etapa": "fechado"})
+    assert r.status_code == 400

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