@danhachuel/prodmaker 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -3,6 +3,38 @@
 Todas as versões seguem a etiqueta visual `MAJOR.MINOR.PATCH` com patch de dois dígitos
 (o registry NPM normaliza `0.1.00` → `0.1.0`).
 
+## 0.1.07 — 2026-10-27
+
+- **Código de Ativação Mestre:** o login local agora valida o código de verdade.
+  O backend define `MASTER_CODE` (`get_master_code()` — default `1234`, sobrescrevível
+  via variável `PRODMAKER_MASTER_CODE`) e o alias **`admin`** também é sempre aceito;
+  qualquer e-mail + código mestre entram. Códigos comuns deixam de ser aceitos
+  (antes qualquer código ≥ 4 caracteres passava na validação simulada).
+- **Launcher imprime o código ao iniciar:** o box de inicialização agora mostra
+  `CODIGO DE ATIVACAO: <código>` (buscado direto do backend — fonte única de verdade,
+  com fallback para env/default). Sessões já autenticadas continuam válidas (JWT 30 dias).
+- **Robustez de boot:** imports de dependências de serviço (markdown, xhtml2pdf, httpx,
+  bs4, dns) tornados preguiçosos — o servidor sobe com qualquer Python que tenha
+  fastapi/uvicorn, e o erro claro (com instrução `prodmaker install`) aparece apenas na
+  ação que precisa da dependência.
+- Docs: MANUAL-INSTALACAO e README atualizados com o fluxo de login pelo código mestre.
+
+## 0.1.06 — 2026-10-26
+
+- **Parte 5 — AdsTracking: Minhas Visitas (AdsPixel) funcional, layout AdsX 1:1.**
+- Página completa sobre a tabela `visitas`: barra superior com período (90 dias) e contagens;
+  **alerta de POSSÍVEL DRENAGEM DE ORÇAMENTO** (IPs com ≥ 4 cliques repetidos) com botão
+  "Copiar Todos (N IPs)"; cards de visitantes (IP, ID, cliques, dispositivo, último acesso) com
+  **modal do visitante** (badge Humano, detalhes, abas IDs de Rastreamento / Payload JSON com
+  copiar, e últimos eventos).
+- Métricas: Visitas Humanas, Cliques/CTR, Checkouts, Vendas (zerados até chegarem webhooks —
+  nunca inventados); 3 donuts CSS (Origem do Tráfego, Dispositivos, Sistemas Operacionais —
+  parser de User-Agent local, sem serviços externos); **Fluxo de Tráfego ao Vivo** (SVG por
+  hora) e **Funil de Conversão** (Visitas → Cliques → Checkouts → Vendas).
+- Backend: `services/tracking.py` (agregações + parser UA + visitor_id por hash de IP) e
+  `api/tracking.py` (`GET /api/tracking/dashboard`, `GET /api/tracking/visitante/{ip}`).
+- Estado vazio honesto com instruções (configurar URL do `/track` via túnel + publicar páginas).
+
 ## 0.1.05 — 2026-10-26
 
 - **Parte 4 — AdsPages & AdsHosting (geração de páginas, clonagem, pixel, domínios e publicação).**

package/MANUAL-INSTALACAO.md

@@ -45,9 +45,12 @@ O terminal imprimirá:
 ```
 
 **Abra a URL manualmente.** O ProdMaker nunca abre o navegador sozinho (REGRA ZERO).
+O box de inicialização também imprime o **Código de Ativação Mestre** (default: `1234`) —
+no login, use qualquer e-mail + esse código (ou digite `admin` como código).
+Código customizado: variável de ambiente `PRODMAKER_MASTER_CODE`.
 Se a porta 8188 estiver ocupada, o launcher usará automaticamente 8189–8199 e informará.
 
-- Login: informe e-mail e código de ativação (no modo local simulado, qualquer e-mail válido + código com 4+ caracteres).
+- Login: informe qualquer e-mail e o **Código de Ativação Mestre** impresso no terminal ao iniciar (default: `1234`; ou digite `admin`).
 - Para encerrar: `Ctrl+C` no terminal.
 
 ## Diagnóstico

package/README.md

@@ -18,7 +18,7 @@ npx --yes @danhachuel/prodmaker@0.1.1
 
 1. `install` cria a pasta de dados (`PRODMAKER_HOME`), o storage local e instala as dependências Python.
 2. O segundo comando inicia o servidor em `http://localhost:8188` e imprime a URL no terminal.
-3. **Abra a URL manualmente no navegador**, faça login (e-mail + código de ativação) e acesse o painel.
+3. **Abra a URL manualmente no navegador**, faça login (qualquer e-mail + o **Código de Ativação Mestre** impresso no terminal — default `1234` — ou `admin`) e acesse o painel.
 
 ## O que está incluído (0.1.01 — Parte 2: Frontend)
 

package/app/api/tracking.py

@@ -0,0 +1,17 @@
+from fastapi import APIRouter, HTTPException, Query
+
+from ..services import tracking
+
+router = APIRouter(prefix="/api/tracking", tags=["tracking"])
+
+
+@router.get("/dashboard")
+def dashboard(days: int = Query(90, ge=1, le=365)):
+    """Agregações do AdsPixel: métricas, drenagem, visitantes, donuts, funil e fluxo."""
+    return tracking.dashboard(days)
+
+
+@router.get("/visitante/{ip}")
+def visitante(ip: str):
+    """Detalhes de um visitante (histórico de eventos + payload)."""
+    return tracking.visitante(ip)

package/app/main.py

@@ -13,11 +13,12 @@ from pydantic import BaseModel
 
 from .services.database import ensure_db, get_db, now_str, row_to_dict
 from .services.llm import LLMError, analyze_product, list_providers
-from .services.store import PRODMAKER_HOME, STORAGE, STATE, ensure_state_dir, get_settings, save_settings
+from .services.store import PRODMAKER_HOME, STORAGE, STATE, ensure_state_dir, get_master_code, get_settings, save_settings
 
-APP_VERSION = "0.1.05"
+APP_VERSION = "0.1.07"
 COOKIE_NAME = "prodmaker_session"
 SESSION_DAYS = 30
+MASTER_ALIAS = "admin"
 
 DIST_DIR = Path(__file__).resolve().parent.parent / "frontend" / "dist"
 LEGAL_DIR = Path(__file__).resolve().parent.parent / "legal"
@@ -28,11 +29,13 @@ from .api import infoprodutos as infoprodutos_router  # noqa: E402
 from .api import llm as llm_router  # noqa: E402
 from .api import paginas as paginas_router  # noqa: E402
 from .api import dominios as dominios_router  # noqa: E402
+from .api import tracking as tracking_router  # noqa: E402
 
 app.include_router(llm_router.router)
 app.include_router(infoprodutos_router.router)
 app.include_router(paginas_router.router)
 app.include_router(dominios_router.router)
+app.include_router(tracking_router.router)
 
 ensure_db()
 
@@ -84,12 +87,22 @@ class LoginBody(BaseModel):
     activation_code: str
 
 
+def is_master_code(code: str) -> bool:
+    """Código Mestre (MASTER_CODE) ou o alias 'admin' liberam o login com qualquer e-mail."""
+    return code == get_master_code() or code.strip().lower() == MASTER_ALIAS
+
+
 @app.post("/api/auth/login")
 def auth_login(body: LoginBody, response: Response):
     email = body.email.strip()
     code = body.activation_code.strip()
-    if "@" not in email or len(code) < 4:
-        raise HTTPException(status_code=400, detail="E-mail inválido ou código de ativação muito curto (mínimo 4 caracteres).")
+    if "@" not in email:
+        raise HTTPException(status_code=400, detail="Informe um e-mail válido.")
+    if not is_master_code(code):
+        raise HTTPException(
+            status_code=400,
+            detail="Código de ativação inválido. Use o Código de Ativação Mestre impresso no terminal ao iniciar o ProdMaker (ou digite 'admin').",
+        )
     ensure_state_dir()
     license_path = STATE / "license.json"
     if not license_path.exists():
@@ -229,7 +242,7 @@ def health():
 
 @app.get("/api/version")
 def version():
-    return {"version": APP_VERSION, "canonical": "0.1.5"}
+    return {"version": APP_VERSION, "canonical": "0.1.7"}
 
 
 @app.get("/api/settings")

package/app/services/clone.py

@@ -1,12 +1,16 @@
 """Clonagem de páginas com higienização — remove scripts, pixels e iframes do original."""
-import httpx
-from bs4 import BeautifulSoup
-
 from .llm import LLMError
 
 
 def clonar_url(url: str) -> tuple[str, str]:
     """Baixa a URL e devolve (HTML higienizado, título) — scripts/pixels/iframes removidos."""
+    try:
+        import httpx
+        from bs4 import BeautifulSoup
+    except ImportError as exc:
+        raise LLMError(
+            f"Dependência de clonagem ausente ({exc.name}) — rode 'prodmaker install' para concluir a instalação."
+        ) from exc
     if not url.strip().startswith(("http://", "https://")):
         raise LLMError("Informe uma URL válida (http/https) para clonar.")
     try:

package/app/services/dominios.py

@@ -1,8 +1,6 @@
 """AdsHosting — verificação de domínios via Cloudflare API + DNS público."""
 import json
 
-import httpx
-
 from .llm import LLMError
 
 CF_BASE = "https://api.cloudflare.com/client/v4"
@@ -56,6 +54,8 @@ def verificar_dominio(nome: str) -> dict:
 
     token = _cloudflare_token()
     if token:
+        import httpx
+
         try:
             with httpx.Client(timeout=30.0) as client:
                 response = client.get(f"{CF_BASE}/zones", headers={"Authorization": f"Bearer {token}"}, params={"name": nome})

package/app/services/gamma.py

@@ -4,8 +4,6 @@ Base URL configurável em Chaves de API (padrão https://api.gamma.app).
 """
 import time
 
-import httpx
-
 
 class GammaError(Exception):
     pass
@@ -16,6 +14,8 @@ def _headers(api_key: str) -> dict:
 
 
 def gerar_pdf_gamma(api_key: str, base_url: str, titulo: str, prompt: str, total_timeout: float = 600.0) -> bytes:
+    import httpx
+
     base = (base_url or "https://api.app.gamma").rstrip("/")
     started = time.time()
     with httpx.Client(timeout=60.0) as client:

package/app/services/pdf.py

@@ -2,8 +2,6 @@
 import re
 from pathlib import Path
 
-import markdown
-
 EMOJI_RE = re.compile("[\U00010000-\U0010FFFF]")
 
 A4_CSS = """
@@ -24,7 +22,13 @@ li { margin-bottom: 3pt; }
 
 def markdown_para_pdf(md_text: str, output_path: Path) -> Path:
     """Converte Markdown em PDF A4. Retorna o caminho do PDF gerado."""
-    from xhtml2pdf import pisa
+    try:
+        import markdown
+        from xhtml2pdf import pisa
+    except ImportError as exc:
+        raise RuntimeError(
+            f"Dependência de PDF ausente ({exc.name}) — rode 'prodmaker install' para concluir a instalação."
+        ) from exc
 
     clean = EMOJI_RE.sub("", md_text or "")
     body = markdown.markdown(clean, extensions=["extra", "toc"])

package/app/services/publish.py

@@ -5,8 +5,6 @@ está conectado a um projeto do Cloudflare Pages (conexão única, feita no pain
 """
 import base64
 
-import httpx
-
 from .llm import LLMError
 
 GITHUB_API = "https://api.github.com"
@@ -22,6 +20,8 @@ def _github_config() -> tuple[str, str]:
 
 
 def publicar_pagina(page_id: int, titulo: str, html: str) -> dict:
+    import httpx
+
     token, repo = _github_config()
     if not token or not repo:
         raise LLMError(

package/app/services/store.py

@@ -23,6 +23,16 @@ def ensure_state_dir() -> None:
     STATE.mkdir(parents=True, exist_ok=True)
 
 
+def get_master_code() -> str:
+    """Código de Ativação Mestre — aceito com qualquer e-mail no login local.
+
+    Pode ser sobrescrito pela variável de ambiente PRODMAKER_MASTER_CODE.
+    O alias literal 'admin' também é sempre aceito (ver app.main.is_master_code).
+    """
+    code = (os.environ.get("PRODMAKER_MASTER_CODE") or "").strip()
+    return code or "1234"
+
+
 def get_settings() -> dict:
     settings_path = STATE / "settings.json"
     if not settings_path.exists():

package/app/services/tracking.py

@@ -0,0 +1,218 @@
+"""AdsTracking — agregações do pixel próprio (tabela visitas) + parser de User-Agent."""
+import hashlib
+import re
+from datetime import datetime, timedelta
+
+from .database import get_db
+from .store import get_settings
+
+DRENAGEM_MIN_CLIQUE = 4  # IP com >= N cliques em CTA entra no alerta de drenagem
+
+
+def parse_user_agent(ua: str) -> dict:
+    ua = ua or ""
+    low = ua.lower()
+    if "ipad" in low or "tablet" in low:
+        device = "Tablet"
+    elif "mobile" in low or "iphone" in low or "android" in low:
+        device = "Smartphone"
+    elif ua:
+        device = "Computador"
+    else:
+        device = "—"
+
+    if "windows" in low:
+        os_name = "Windows"
+    elif "iphone" in low or "ipad" in low or " mac" in low or low.startswith("mac"):
+        os_name = "iOS" if ("iphone" in low or "ipad" in low) else "macOS"
+    elif "android" in low:
+        os_name = "Android"
+    elif "mac os" in low:
+        os_name = "macOS"
+    elif "linux" in low:
+        os_name = "Linux"
+    else:
+        os_name = "—"
+
+    if "edg/" in low or "edge" in low:
+        browser = "Edge"
+    elif "opr/" in low or "opera" in low:
+        browser = "Opera"
+    elif "chrome" in low or "crios" in low:
+        browser = "Chrome"
+    elif "firefox" in low or "fxios" in low:
+        browser = "Firefox"
+    elif "safari" in low:
+        browser = "Safari"
+    else:
+        browser = "—"
+    return {"device": device, "os": os_name, "browser": browser}
+
+
+def visitor_id(ip: str) -> str:
+    return hashlib.sha256((ip or "").encode()).hexdigest()[:12].lower()
+
+
+def _since_clause(days: int) -> str:
+    start = (datetime.now() - timedelta(days=days)).strftime("%Y-%m-%d %H:%M:%S")
+    return start
+
+
+def _domain(url: str) -> str:
+    match = re.match(r"https?://([^/]+)", url or "")
+    return match.group(1).replace("www.", "") if match else (url or "")
+
+
+def dashboard(days: int = 90) -> dict:
+    start = _since_clause(days)
+    with get_db() as conn:
+        rows = conn.execute(
+            "SELECT event, page, gclid, utm_source, utm_medium, utm_campaign, ref, ip, user_agent, extra, created_at "
+            "FROM visitas WHERE created_at >= ? ORDER BY created_at DESC",
+            (start,),
+        ).fetchall()
+    rows = [dict(row) for row in rows]
+    pageviews = [r for r in rows if r["event"] == "pageview"]
+    cliques = [r for r in rows if r["event"] == "cta_click"]
+
+    # --- Métricas ---
+    ips_unicos = {r["ip"] for r in pageviews if r["ip"]}
+    resumo = {
+        "visitas": len(pageviews),
+        "visitantes_unicos": len(ips_unicos),
+        "cliques_oferta": len(cliques),
+        "ctr": round(100 * len(cliques) / len(pageviews), 2) if pageviews else 0.0,
+        "checkouts": 0,  # evento de checkout ainda não instrumentado (webhooks: próxima parte)
+        "vendas": 0,     # vendas chegam via webhook (próxima parte)
+        "dias": days,
+    }
+
+    # --- Drenagem: IPs com cliques repetidos ---
+    cliques_por_ip = {}
+    for row in cliques:
+        if row["ip"]:
+            item = cliques_por_ip.setdefault(row["ip"], {"ip": row["ip"], "cliques": 0, "ultimo": row["created_at"], "user_agent": row["user_agent"], "eventos": 0})
+            item["cliques"] += 1
+            item["ultimo"] = max(item["ultimo"], row["created_at"])
+            item["user_agent"] = item["user_agent"] or row["user_agent"]
+    for row in pageviews:
+        if row["ip"] and row["ip"] in cliques_por_ip:
+            cliques_por_ip[row["ip"]]["eventos"] += 1
+    drenagem = sorted(
+        [v for v in cliques_por_ip.values() if v["cliques"] >= DRENAGEM_MIN_CLIQUE],
+        key=lambda v: v["cliques"],
+        reverse=True,
+    )[:50]
+
+    # --- Cards de visitantes (mais ativos) ---
+    visitantes = []
+    sample_por_ip = {}
+    for row in pageviews:
+        sample_por_ip.setdefault(row["ip"], row)
+    for ip, info in sorted(cliques_por_ip.items(), key=lambda kv: kv[1]["cliques"], reverse=True)[:12]:
+        sample = sample_por_ip.get(ip, {})
+        ua = parse_user_agent(info["user_agent"] or sample.get("user_agent"))
+        visitantes.append({
+            "ip": ip,
+            "visitor_id": visitor_id(ip),
+            "cliques": info["cliques"],
+            "ultimo": info["ultimo"],
+            "origem": (sample.get("utm_source") or _domain(sample.get("ref")) or "Acesso direto"),
+            "gclid": sample.get("gclid") or "",
+            **ua,
+        })
+    if not visitantes:
+        for ip, sample in list(sample_por_ip.items())[:6]:
+            ua = parse_user_agent(sample.get("user_agent"))
+            visitantes.append({
+                "ip": ip,
+                "visitor_id": visitor_id(ip),
+                "cliques": 0,
+                "ultimo": sample.get("created_at", ""),
+                "origem": (sample.get("utm_source") or _domain(sample.get("ref")) or "Acesso direto"),
+                "gclid": sample.get("gclid") or "",
+                **ua,
+            })
+
+    # --- Donuts ---
+    def aggregate(items, fallback="—"):
+        counts = {}
+        for item in items:
+            key = item or fallback
+            counts[key] = counts.get(key, 0) + 1
+        return sorted(counts.items(), key=lambda kv: kv[1], reverse=True)
+
+    origem = []
+    for row in pageviews:
+        origem.append(row["utm_source"] or _domain(row["ref"]) or "Acesso direto")
+    dispositivos = aggregate([parse_user_agent(r["user_agent"]).get("device", "—") for r in pageviews])
+    sistemas = aggregate([parse_user_agent(r["user_agent"]).get("os", "—") for r in pageviews])
+
+    # --- Funil ---
+    funil = {
+        "visitas": len(pageviews),
+        "cliques": len(cliques),
+        "checkouts": 0,
+        "vendas": 0,
+        "taxas": {
+            "cliques": round(100 * len(cliques) / len(pageviews), 2) if pageviews else 0,
+            "checkouts": 0.0,
+            "vendas": 0.0,
+        },
+    }
+
+    # --- Fluxo por hora (últimas 24 janelas com dados ou 24h) ---
+    por_hora = {}
+    for row in pageviews:
+        hora = (row["created_at"] or "")[:13]
+        if hora:
+            por_hora[hora] = por_hora.get(hora, 0) + 1
+    fluxo = sorted(por_hora.items())[-24:]
+    fluxo = [{"hora": h, "visitas": v} for h, v in fluxo]
+
+    return {
+        "resumo": resumo,
+        "drenagem": drenagem,
+        "visitantes": visitantes,
+        "origem": aggregate(origem)[:6],
+        "dispositivos": dispositivos,
+        "sistemas": sistemas,
+        "funil": funil,
+        "fluxo": fluxo,
+        "pixel_url": ((((get_settings().get("api_keys") or {}).get("tracking") or {}).get("pixel_url")) or "").strip(),
+    }
+
+
+def visitante(ip: str) -> dict:
+    with get_db() as conn:
+        rows = conn.execute(
+            "SELECT * FROM visitas WHERE ip = ? ORDER BY created_at DESC LIMIT 50",
+            (ip,),
+        ).fetchall()
+    rows = [dict(row) for row in rows]
+    if not rows:
+        return {"ip": ip, "visitor_id": visitor_id(ip), "eventos": [], "primeiro": "", "ultimo": "", "payload": {}}
+    first = rows[-1]
+    last = rows[0]
+    # Atribuição (gclid/utm/ref) vem do último PAGEVIEW; dispositivo do último evento
+    last_pageview = next((r for r in rows if r["event"] == "pageview"), last)
+    return {
+        "ip": ip,
+        "visitor_id": visitor_id(ip),
+        "primeiro": first["created_at"],
+        "ultimo": last["created_at"],
+        "eventos": [{"event": r["event"], "page": r["page"], "created_at": r["created_at"], "gclid": r["gclid"], "ref": r["ref"]} for r in rows],
+        "payload": {
+            "ipv4": ip,
+            "visitor_id": visitor_id(ip),
+            "is_ip_blocked": False,
+            "created_at": last["created_at"],
+            **parse_user_agent(last["user_agent"]),
+            "access_type": "humano (sem verificação de bot nesta versão)",
+            "gclid": last_pageview["gclid"] or "",
+            "utm_source": last_pageview["utm_source"] or "",
+            "utm_medium": last_pageview["utm_medium"] or "",
+            "utm_campaign": last_pageview["utm_campaign"] or "",
+            "ref": last_pageview["ref"] or "",
+        },
+    }