@danhachuel/leadmaster 0.1.7 → 0.1.8

package/CHANGELOG.md

@@ -6,6 +6,28 @@ O formato é baseado no [Keep a Changelog](https://keepachangelog.com/pt-BR/1.1.
 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.08] — 2026-11-08
+
+### Adicionado
+
+- **Módulo CRM Kanban implementado conforme especificação:**
+  - Rotas: `GET /api/crm/leads`, `POST /api/crm/leads` (criação manual) e
+    `PUT /api/crm/leads/{lead_id}/etapa` (movimentação ao soltar o card) —
+    persistência no `leads.json` local (seeds de demonstração mantidos).
+  - Kanban com **@dnd-kit/core + @dnd-kit/sortable** (multi-contêiner):
+    arrastar entre colunas persiste via API; reordenação visual dentro da
+    coluna; soltar fora das colunas reverte o movimento.
+  - Colunas: **Novos Leads → Em Contato → Proposta → Fechado**.
+  - Card mostra Nome, Telefone, Fonte e **Data de Criação**.
+  - Botão **"Adicionar Lead"** (gradiente) com modal de criação (campos
+    avançados em accordion).
+  - UX: card inteiro arrastável (Fitts); **opacity 0.5** no card arrastado e
+    **borda tracejada indigo** na coluna de destino (Zeigarnik); colunas
+    brancas com sombra suave (padrão do Dashboard).
+- **7 novos testes pytest** para as rotas do CRM (`backend/tests/test_crm_routes.py`):
+  listagem, criação, persistência, validação, movimentação, 404 e etapas
+  inválidas — isolados com `LEADMASTER_HOME` temporário.
+
 ## [0.1.07] — 2026-11-08
 
 ### Adicionado

package/backend/main.py

@@ -295,6 +295,42 @@ def aplicar_sugestao(dados: dict):
     return {"ok": True, "lead": atualizado}
 
 
+# ---------------------------------------------------------------------------
+# CRM — Kanban (leads por etapa)
+# ---------------------------------------------------------------------------
+
+@app.get("/api/crm/leads")
+def crm_listar_leads():
+    """Todos os leads (persistidos em leads.json) — usado pelo quadro Kanban."""
+    return storage.list_leads()
+
+
+@app.post("/api/crm/leads", status_code=201)
+def crm_criar_lead(lead_in: LeadIn):
+    """Cria um lead manualmente pelo modal 'Adicionar Lead' do CRM."""
+    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.put("/api/crm/leads/{lead_id}/etapa")
+def crm_mover_lead(lead_id: str, dados: dict):
+    """Move um lead de coluna no Kanban (drag-and-drop)."""
+    etapa = dados.get("etapa")
+    if not etapa:
+        raise HTTPException(400, "Informe a etapa de destino.")
+    _validar_etapa(etapa)
+    atualizado = storage.update_lead(lead_id, {"etapa": etapa})
+    if not atualizado:
+        raise HTTPException(404, "Lead não encontrado.")
+    agents.disparar_webhook("lead.etapa", {"lead_id": lead_id, "etapa": etapa, "via": "kanban"})
+    return atualizado
+
+
 # ---------------------------------------------------------------------------
 # Campanhas / Disparos
 # ---------------------------------------------------------------------------

package/backend/tests/test_crm_routes.py

@@ -0,0 +1,64 @@
+"""Testes das rotas do CRM Kanban (backend/main.py).
+
+Usam TestClient do FastAPI com LEADMASTER_HOME em diretório temporário, para
+nunca tocar nos dados reais do usuário. Rodam iguais no CI (Linux) e local.
+"""
+
+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_listar_leads(client):
+    r = client.get("/api/crm/leads")
+    assert r.status_code == 200
+    corpo = r.json()
+    assert isinstance(corpo, list) and len(corpo) >= 1  # seeds de demonstração
+
+
+def test_criar_lead(client):
+    r = client.post("/api/crm/leads", json={"nome": "Padaria Teste", "telefone": "(11) 90000-0000", "fonte": "Manual"})
+    assert r.status_code == 201
+    lead = r.json()
+    assert lead["id"]
+    assert lead["etapa"] == "leads"
+    # Confirma persistência no JSON local
+    lista = client.get("/api/crm/leads").json()
+    assert any(l["id"] == lead["id"] for l in lista)
+
+
+def test_criar_lead_sem_nome_invalido(client):
+    r = client.post("/api/crm/leads", json={"nome": ""})
+    assert r.status_code == 422  # validação do modelo Pydantic
+
+
+def test_mover_lead_entre_colunas(client):
+    criado = client.post("/api/crm/leads", json={"nome": "Lead Móvel"}).json()
+    r = client.put(f"/api/crm/leads/{criado['id']}/etapa", json={"etapa": "proposta"})
+    assert r.status_code == 200
+    assert r.json()["etapa"] == "proposta"
+
+
+def test_mover_lead_inexistente(client):
+    r = client.put("/api/crm/leads/nao-existe/etapa", json={"etapa": "fechado"})
+    assert r.status_code == 404
+
+
+def test_mover_lead_etapa_invalida(client):
+    criado = client.post("/api/crm/leads", json={"nome": "Lead X"}).json()
+    r = client.put(f"/api/crm/leads/{criado['id']}/etapa", json={"etapa": "nao_existe"})
+    assert r.status_code == 400
+
+
+def test_mover_lead_sem_etapa(client):
+    criado = client.post("/api/crm/leads", json={"nome": "Lead Y"}).json()
+    r = client.put(f"/api/crm/leads/{criado['id']}/etapa", json={})
+    assert r.status_code == 400