cdp-edge 1.12.0 → 1.14.0

package/README.md

@@ -1,367 +1,283 @@
-# 🚀 CDP Edge - Quantum Tracking
+# 🚀 CDP Edge — Quantum Tracking Enterprise
 
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v1.2.2** — Cloudflare Queue + KV + Workers AI · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
-
-- **Precisão Máxima**: Meta CAPI v22.0+, GA4 MP e TikTok Events API v1.3.
-- **Identity Graph**: Persistência de leads e eventos via Cloudflare D1.
-- **Anti-Adblock**: Endpoint Same-Domain indetectável.
-- **Human-Behavior Engine**: Score de engajamento (0-100) em tempo real.
-- **Queue Retry**: Zero perda de conversão — eventos com falha reenfileirados automaticamente.
-- **Geo Intelligence**: Cidade, estado e CEP em todos os eventos (Workers Paid).
+> **v1.4.0** — Enterprise-Level Intelligence Engine · Cloudflare Workers · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
 
 ---
 
-## 🏗️ ARQUITETURA QUANTUM (CLOUDFARE NATIVE)
+## 📋 CHANGELOG v1.4.0 (9 de Abril de 2026)
+
+### 🆕 Sprint Enterprise — Fases 1 a 4
+
+#### ✅ Fase 1 — ML Clustering (Segmentação Dinâmica)
+- **`POST /api/segmentation/cluster`** — K-means / DBSCAN / Hierarchical via Workers AI
+- **`GET  /api/segmentation/list`** — Segmentos ativos com métricas
+- **`GET  /api/segmentation/outliers`** — Detecção de outliers comportamentais
+- **`PUT  /api/segmentation/update`** — Atualização de metadados de segmento
+- Schema D1: `ml_segments`, `ml_segment_members` + VIEWs otimizadas
+- Agente: `ml-clustering-agent.md`
+
+#### ✅ Fase 2 — Bidding Recommendations (Otimização de Bids ML)
+- **`POST /api/bidding/recommend`** — Bid otimizado por segmento × plataforma (Meta/Google/TikTok), calculado com fórmula `LTV × ROI target / CPA base`
+- **`GET  /api/bidding/history`** — Histórico completo de recomendações
+- **`GET  /api/bidding/status`** — Snapshot atual das recomendações ativas por vertical
+- Schema D1: `bid_recommendations` + VIEW `v_active_bid_recommendations`
+- Agente: `bidding-agent.md`
+
+#### ✅ Fase 3 — A/B Testing de Prompts LTV
+- **`POST /api/ltv/ab-test/create`** — Cria experimento com múltiplas variações de system prompt
+- **`GET  /api/ltv/ab-test/list`** — Lista experimentos com status e progresso
+- **`GET  /api/ltv/ab-test/results`** — Accuracy score por variação + recomendação automática de winner
+- **`POST /api/ltv/ab-test/winner`** — Declara vencedor e retorna o prompt ganador
+- Integração automática: cada evento Lead sorteia a variação ativa e registra o assignment via KV cache
+- Schema D1: `ltv_ab_tests`, `ltv_ab_variations`, `ltv_ab_assignments` + VIEW `v_ab_test_performance`
+- Agente: `ab-ltv-agent.md`
+
+#### ✅ Fase 4 — Fraud Detection Engine
+- **Fraud Gate automático em `/track`** — roda ANTES de qualquer processamento (heurístico puro, ~2ms)
+- Silent drop (retorna 200 falso) — bots não detectam a defesa
+- **`GET  /api/fraud/stats`** — Dashboard de fraude (últimas 24h)
+- **`GET  /api/fraud/alerts`** — Log de sinais detectados com filtros
+- **`GET  /api/fraud/blocklist`** — IPs/fingerprints atualmente bloqueados
+- **`POST /api/fraud/blocklist/add`** — Bloquear IP ou fingerprint (via KV, efeito imediato)
+- **`DELETE /api/fraud/blocklist/remove`** — Remover do blocklist
+- Sinais detectados: bot_score, datacenter IP, velocity attack, email descartável, headless UA, sem Accept-Language
+- Schema D1: `fraud_signals`, `fraud_alerts` + VIEW `v_fraud_dashboard`
+- Agente: `fraud-detection-agent.md`
+
+### 🔧 Fix: `wrangler.toml` atualizado
+- Todos os placeholders (`SEU_D1_DATABASE_ID`, `SEU_KV_NAMESPACE_ID`) substituídos pelos IDs reais da conta Cloudflare
+- D1: `7867d38f-5fa8-4c17-b465-386211422c09`
+- KV: `821b6c1ccb4b475985439b801c1fdbe0`
+
+---
 
-O CDP Edge não é um "script de rastreio", é uma **Content Delivery Network (CDN)** com inteligência de dados acoplada.
+## 🏗️ ARQUITETURA QUANTUM ENTERPRISE (CLOUDFLARE NATIVE)
 
 ```mermaid
 graph TD
     User((Usuário)) -->|Interação| SDK[cdpTrack SDK + Behavior Engine]
-    SDK -->|Edge Fetch| Worker[Cloudflare Worker Agent]
-    Worker -->|Identity Graph| D1[(D1 SQL Database)]
-    Worker -->|Background Job| Queue[Cloudflare Queues]
+    SDK -->|Edge Fetch 1ª via KV blocklist| FraudGate{🛡️ Fraud Gate}
+    FraudGate -->|score ≥ 80: Silent Drop 200| Void[/dev/null]
+    FraudGate -->|score < 80: Permitido| Worker[Cloudflare Worker Agent]
+    Worker -->|Identity Graph + _cdp_uid| D1[(D1 SQL — 21 tabelas)]
+    Worker -->|LTV + A/B Prompt| AI[Workers AI Llama 3.1 8B]
+    Worker -->|Segmento ML| Cluster[ML Clustering Engine]
+    Cluster -->|Bid otimizado| Bidding[Bidding Recommendations]
+    Worker -->|Background| Queue[Cloudflare Queues]
     Queue -->|Server Dispatch| Meta[Meta CAPI v22.0]
     Queue -->|Server Dispatch| Google[GA4 / Google Ads]
     Queue -->|Server Dispatch| TikTok[TikTok API v1.3]
-    D1 -->|Retention Reports| Dash[Dashboard Agent]
+    D1 -->|Reports| Dash[Dashboard Agent]
 ```
 
 ---
 
-## 🖱 CATÁLOGO DE AGENTES ESPECIALISTAS
+## 🧠 CATÁLOGO DE AGENTES ESPECIALISTAS
 
-O sistema é composto por mais de 30 agentes coordenados pelo **Master Orchestrator**. Cada um possui uma função técnica específica:
+O sistema é composto por **43+ agentes** coordenados pelo **Master Orchestrator**:
 
 ### 🧠 Núcleo de Inteligência
 | Agente | Função |
 |---|---|
-| **Master Orchestrator** | Coordenação central de especialistas e validação Quantum Tier. |
-| **Page Analyzer** | Mapeamento automático de CTAs, Forms e Nicho do site. |
-| **Validator Agent** | Auditoria de código, segurança e conformidade de APIs. |
-| **Memory Agent** | Gestão de contexto e checkpoints técnicos da sessão. |
-| **Intelligence Agent** | Monitoramento de atualizações de API (Meta v22.0+, etc). |
+| **Master Orchestrator** | Coordenação central — guia todo o setup do projeto |
+| **Page Analyzer** | Mapeamento automático de CTAs, Forms e nicho do site |
+| **Validator Agent** | Auditoria de código, segurança e conformidade de APIs |
+| **Memory Agent** | Contexto e checkpoints da sessão por projeto |
+| **Intelligence Agent** | Monitoramento de versões de API (Meta v22.0+, etc) |
 
-### 🚀 Despachantes de Plataforma
+### 🚀 Plataformas de Anúncio
 | Agente | Especialidade |
 |---|---|
-| **Meta Agent** | Facebook Pixel + CAPI (EMQ Max). |
-| **Google Agent** | GA4 + Google Ads Server-Side. |
-| **TikTok Agent** | TikTok Pixel + Events API v1.3. |
-| **Plataformas Ads** | Pinterest, Reddit, Bing, LinkedIn, Spotify. |
-| **Browser Agent** | Geração do SDK `cdpTrack.js` lightweight. |
-
-### 🛡️ Módulos Enterprise (Premium)
+| **Meta Agent** | Facebook Pixel + CAPI v22.0 + WhatsApp CTWA |
+| **Google Agent** | GA4 + Google Ads Enhanced Conversions |
+| **TikTok Agent** | TikTok Pixel + Events API v1.3 |
+| **LinkedIn Agent** | Insight Tag + Conversions API v2 |
+| **Pinterest Agent** | Tag + Conversions API v5 |
+| **Reddit Agent** | Pixel + Conversions API v2.0 |
+| **Spotify Agent** | Pixel + Conversions API v1 |
+| **Bing Agent** | UET Tag + Enhanced Conversions |
+
+### 🤖 Enterprise Intelligence (Fase 1–4)
+| Agente | Endpoint Principal | Impacto |
+|---|---|---|
+| **ML Clustering Agent** | `POST /api/segmentation/cluster` | Segmentação K-means/DBSCAN/Hierarchical |
+| **Bidding Agent** | `POST /api/bidding/recommend` | -20% CPA via bid por segmento de LTV |
+| **A/B LTV Agent** | `POST /api/ltv/ab-test/create` | +25% precisão LTV via test de prompts |
+| **Fraud Detection Agent** | Auto em `/track` | Bloqueia click fraud, bots, velocity attacks |
+
+### 🛡️ Módulos Enterprise
 | Agente | Função |
 |---|---|
-| **Attribution Agent** | Atribuição Multi-Touch de alta fidelidade. |
-| **Security Agent** | Rate Limiting, Criptografia AES-256 e Bot Defense. |
-| **Compliance Agent** | Gestão de LGPD e GDPR (Consent Mode v2). |
-| **Performance Opt.** | Otimização de Caches e Queries D1 SQL. |
-| **CRM Integration** | Sincronia D1 ↔ HubSpot/Salesforce via CRM Agent. |
+| **Attribution Agent** | Atribuição Multi-Touch de alta fidelidade |
+| **Security Agent** | Rate Limiting, AES-256 e Bot Defense |
+| **Compliance Agent** | LGPD e GDPR (Consent Mode v2) |
+| **Performance Agent** | Otimização de caches e queries D1 |
 
 ---
 
-## 💻 INSTALAÇÃO E USO
-
-### Instalar Globalmente
+## 📊 BANCO DE DADOS D1 — 21 Tabelas
 
-```bash
-npm install -g cdp-edge
-cdp-edge --version
+```
+CORE TRACKING           ML & INTELLIGENCE        ENTERPRISE SECURITY
+─────────────────        ─────────────────────    ─────────────────────
+leads                   ml_segments               fraud_signals
+events                  ml_segment_members        fraud_alerts
+sessions                bid_recommendations       ltv_ab_tests
+webhook_events          ltv_ab_tests              ltv_ab_variations
+api_failures            ltv_ab_variations         ltv_ab_assignments
+
+VIEWS
+─────────────────────────────────────────────────
+v_active_segments          → Segmentos ML ativos com contagem de membros
+v_active_bid_recs          → Bids ativos por plataforma/vertical
+v_ab_test_performance      → Accuracy por variação de prompt
+v_fraud_dashboard          → Dashboard fraude 24h
 ```
 
 ---
 
-## 📋 COMANDOS DISPONÍVEIS
-
-### `install` — Instalar CDP Edge em um projeto cliente
-
-**O comando principal.** Configura o CDP Edge em qualquer projeto e habilita o `/cdp` no Claude Code.
-
-```bash
-# Instalar no diretório atual
-cdp-edge install .
-
-# Instalar em outro diretório
-cdp-edge install ./meu-projeto
-
-# Com nome do projeto
-cdp-edge install ./meu-projeto --name "Landing Page XYZ"
+## 🔄 FLUXO ENTERPRISE COMPLETO
 
-# Incluir .cursorrules para Cursor IDE
-cdp-edge install ./meu-projeto --cursor
 ```
-
-**O que cria na raiz do projeto:**
-
-| Arquivo/Pasta | Função |
-|---|---|
-| `cdp-edge/` | Skill completa (agentes, SDK, worker, templates, docs) |
-| `.claude/commands/cdp.md` | Habilita `/cdp` no Claude Code |
-| `CLAUDE.md` | Auto-ativação ao abrir sessão |
-| `.cursorrules` | Integração Cursor IDE (flag `--cursor`) |
-
-**Fluxo após install:**
-
-```bash
-# 1. Criar e instalar
-mkdir meu-projeto
-cdp-edge install ./meu-projeto
-
-# 2. Abrir no Claude Code
-claude ./meu-projeto
-
-# 3. Ativar o Orchestrator
-/cdp
+POST /track (evento Lead)
+  │
+  ├─ [1] 🛡️ Fraud Gate (KV blocklist + velocity + heurísticas) ~2ms
+  │         ├─ score < 40  → processa normalmente
+  │         ├─ score 40-79 → processa + loga suspeito (background)
+  │         └─ score ≥ 80  → silent drop 200 + loga (background)
+  │
+  ├─ [2] 🔮 A/B LTV Testing — sorteia variação ativa (KV cache ~0ms)
+  │         └─ passa customSystemPrompt para predictLtv()
+  │
+  ├─ [3] 🧮 LTV Prediction — Workers AI Llama 3.1 8B
+  │         └─ Score 0-100 → class High/Medium/Low → valor em BRL
+  │
+  ├─ [4] 💾 D1 Writes (background via ctx.waitUntil)
+  │         ├─ upsertLtvProfile() → tabela leads
+  │         ├─ recordAbAssignment() → ltv_ab_assignments
+  │         └─ resolveDeviceGraph() → cross-device linking
+  │
+  └─ [5] 📡 CAPI dispatch (Meta + GA4 + TikTok em paralelo)
+            └─ com LTV injetado no value field
 ```
 
 ---
 
-### Outros Comandos
-
-#### `setup` — Wizard interativo
-
-```bash
-cdp-edge setup
-cdp-edge setup ./meu-projeto
-```
-
-**O que faz:**
-- Pergunta plataformas (Meta, TikTok, GA4, etc.)
-- Pergunta tipo de produto (lead, checkout, webinar, etc.)
-- Gera código de tracking (Browser + Server)
-- Cria schema D1 SQL e configuração Wrangler
+## 💻 INSTALAÇÃO E USO
 
----
+> ⚠️ **Importante:** Execute **um comando por vez** e aguarde terminar antes de rodar o próximo.
 
-#### `analyze` — Analisar páginas
+### Passo 1 — Instalar o CLI globalmente
 
 ```bash
-cdp-edge analyze .
-cdp-edge analyze ./meu-projeto
+npm install -g cdp-edge
 ```
 
-**O que faz:**
-- Detecta CTAs e formulários
-- Identifica nicho do negócio
-- Sugere micro-eventos comportamentais
-
----
-
-#### `server` — Gerar infraestrutura Cloudflare
+### Passo 2 — Criar a pasta do projeto
 
 ```bash
-cdp-edge server .
-cdp-edge server ./meu-worker
+cdp-edge install . --name "Nome do Projeto"
 ```
 
-**Arquivos gerados:**
-- `worker.js` — Cloudflare Worker completo
-- `schema.sql` — Schema D1
-- `wrangler.toml` — Configuração Wrangler
-
----
-
-#### `validate` — Auditar tracking existente
+### Passo 3 — Ativar no Claude Code
 
 ```bash
-cdp-edge validate tracking.js
+claude .
 ```
-
-**O que verifica:**
-- `event_id` para deduplicação
-- SHA256 para PII (e-mail, telefone)
-- Detecção de GTM/Stape
-- Conformidade com APIs
-
----
-
-#### `infra` — Guia de infraestrutura Cloudflare
-
-```bash
-cdp-edge infra
+Dentro do Claude Code:
 ```
-
----
-
-## 🔄 CICLO DE VIDA DO SETUP (/setup)
-
-1.  **FASE 0 — Checkpoint:** Sincronização de contexto via Memory Agent.
-2.  **FASE 1 — Análise:** Detecção automática de nicho e estrutura da página.
-3.  **FASE 2 — Mapeamento:** Identificação de CTAs, Forms e Gateways de venda.
-4.  **FASE 3 — Geração:** Código paralelo para Browser (`cdpTrack`), Worker e D1 SQL.
-5.  **FASE 4 — Auditoria:** Validação rigorosa e correções automáticas (Validator).
-6.  **FASE 5 — Deploy:** Publicação instantânea via `wrangler deploy`.
-
----
-
-## 📁 ESTRUTURA DO REPOSITÓRIO
-
-```text
-CDP Edge/
-├── README.md                        # Você está aqui.
-├── CLAUDE.md                        # Guia de desenvolvimento e padrões.
-├── extracted-skill/                 # O motor da IA (Agentes e Knowledge Base).
-│   └── tracking-events-generator/
-│       ├── agents/                  # 39+ agentes especialistas
-│       ├── cdpTrack.js              # SDK Browser (window.cdpTrack)
-│       └── micro-events.js          # Scroll, vídeo, hover, click tracking
-├── server-edge-tracker/             # Cloudflare Worker (Infra de Borda)
-│   ├── worker.js                    # Handler principal + Queue consumer
-│   ├── schema.sql                   # D1 Schema (Identity Graph)
-│   └── wrangler.toml                # Bindings: D1 + Queue + KV + AI
-├── bin/                             # CLI Executável (cdp-edge)
-├── dist/commands/                   # Implementação dos comandos CLI
-│   └── install.js                   # cdp-edge install
-├── templates/
-│   ├── install/
-│   │   ├── CLAUDE.md                # Template de auto-ativação para projetos
-│   │   └── .claude/commands/
-│   │       └── cdp.md               # Define /cdp no Claude Code
-│   ├── vsl-page.md                  # Template VSL / vídeo de vendas
-│   └── afiliado-sem-landing.md      # Template bridge page afiliado
-└── docs/
-    ├── quick-start.md               # Do zero ao deploy
-    ├── events-reference.md          # Catálogo completo de eventos
-    ├── sdk-reference.md             # API pública do cdpTrack.js
-    └── installation.md              # Instalar CDP Edge em projetos clientes
+/cdp
 ```
 
 ---
 
-## 📚 EXEMPLOS DE USO
-
-### Cenário 1: Novo projeto com Claude Code
-
-```bash
-# 1. Criar projeto e instalar CDP Edge
-mkdir landing-page-lead
-cdp-edge install ./landing-page-lead --name "Landing Page Lead"
-
-# 2. Abrir no Claude Code
-claude ./landing-page-lead
-
-# 3. Ativar o Orchestrator
-/cdp
-# → CDP Edge inicia, faz perguntas, gera toda a infraestrutura
-```
-
-### Cenário 2: Apenas Infraestrutura Cloudflare
+## 🚀 DEPLOY COMPLETO (referência)
 
 ```bash
-# 1. Gerar infraestrutura Worker + D1
-cdp-edge server ./meu-worker
+cd server-edge-tracker
 
-# 2. Deploy
-cd meu-worker
-wrangler deploy
+# 1. Schemas D1 (todos em sequência)
+wrangler d1 execute cdp-edge-db --file=schema.sql --remote
+wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
+wrangler d1 execute cdp-edge-db --file=schema-segmentation.sql --remote  # Fase 1
+wrangler d1 execute cdp-edge-db --file=schema-bidding.sql --remote        # Fase 2
+wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote         # Fase 3
+wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote           # Fase 4
 
-# 3. Configurar secrets
+# 2. Secrets
 wrangler secret put META_ACCESS_TOKEN
+wrangler secret put GA4_API_SECRET
 wrangler secret put TIKTOK_ACCESS_TOKEN
-```
-
-### Cenário 3: Validar Código Existente
-
-```bash
-cdp-edge validate tracking.js
-
-# Status: PASS | Score: 85/100
-# ⚠  Hashing não detectado para PII
-```
-
-### Cenário 4: Análise de Projeto
-
-```bash
-cdp-edge analyze ./meu-projeto-web
 
-# 📊 Eventos detectados: leads: 2 | purchases: 1 | views: 3
-# 🎯 Nicho identificado: E-commerce
+# 3. Deploy
+wrangler deploy
 ```
 
 ---
 
-## ⚡ COMANDOS RÁPIDOS (CLI)
+## 🖱️ HUMAN-BEHAVIOR ENGINE
 
-| Comando | Descrição |
-|---------|-----------|
-| `cdp-edge install [dir]` | **Instala CDP Edge + habilita /cdp no Claude Code** |
-| `cdp-edge setup [dir]` | Configuração guiada (wizard) |
-| `cdp-edge analyze <dir>` | Análise de páginas |
-| `cdp-edge server <dir>` | Gerar infraestrutura Workers + D1 |
-| `cdp-edge validate <file>` | Auditoria de código |
-| `cdp-edge infra` | Guia Cloudflare |
-| `cdp-edge --help` | Ajuda completa |
-| `cdp-edge --version` | Versão instalada |
+| Evento | Pontuação |
+|--------|-----------|
+| Scroll 25–90% | +5 a +15 pts |
+| VSL Watch 25–100% | +10 a +50 pts |
+| Copy Intent (cupom, PIX) | +20 pts |
+| Preenchimento de campo | +10 pts |
+| Rage Click | -10 pts |
+| **Hot Lead (80+ pts)** | **Dispara High_Intent_Lead** |
 
 ---
 
-## 🔧 SOLUÇÃO DE PROBLEMAS
-
-### Erro: "Cannot find module dist/commands/install.js"
-
-O npm ainda tem a versão antiga em cache. Instale direto do GitHub para ter a versão mais recente:
-
-```bash
-npm uninstall -g cdp-edge
-npm install -g github:ricardosoli777/CDP-Edge-Premium
-cdp-edge --version
-```
-
-### Erro: "cdp-edge não é reconhecido"
-
-```bash
-# Instalar globalmente
-npm install -g cdp-edge
-
-# Ou instalar direto do repositório
-npm install -g github:ricardosoli777/CDP-Edge-Premium
-```
-
-### Erro: "Permissão negada ao escrever arquivos"
-
-Execute o terminal como Administrador (Windows) ou use `sudo` (Mac/Linux).
-
-### Erro: "Módulo não encontrado" (outros módulos)
-
-```bash
-npm cache clean --force
-npm uninstall -g cdp-edge
-npm install -g cdp-edge
-```
-
----
-
-## 🖱️ HUMAN-BEHAVIOR ENGINE (O MOTOR DE INTENÇÃO)
-
-A joia da coroa do CDP Edge. Capturamos o que o usuário **sente** e **faz**, e não apenas onde ele clica.
-
-### 🌡️ Engagement Scoring Engine (0-100)
-Cada ação do usuário soma (ou subtrai) pontos em tempo real:
-*   **Scroll (25-90%)**: +5 a +15 pontos.
-*   **VSL Watch (25-100%)**: +10 a +50 pontos.
-*   **Copy Intent**: +20 pontos ao copiar cupons ou chaves PIX.
-*   **Form Interaction**: +10 pontos por campo preenchido.
-*   **Rage Click**: -10 pontos (sinal de frustração técnica).
-*   **Gatilho Hot Lead**: Ao atingir **80 pontos**, disparar `High_Intent_Lead` para as plataformas.
-
-### 🎥 VSL & Video Tracker
-Monitoramento nativo de retenção em vídeos YouTube e Vimeo sem necessidade de scripts externos pesados.
+## 📋 TODOS OS ENDPOINTS (referência rápida)
+
+### Core Tracking
+| Rota | Método | Função |
+|---|---|---|
+| `/track` | POST | Evento principal (browser → CAPI) |
+| `/health` | GET | Smoke test completo |
+| `/webhook/hotmart` | POST | Webhook Hotmart Purchase |
+| `/webhook/kiwify` | POST | Webhook Kiwify Purchase |
+| `/webhook/ticto` | POST | Webhook Ticto Purchase |
+
+### Intelligence ML
+| Rota | Método | Função |
+|---|---|---|
+| `/api/segmentation/cluster` | POST | Clustering K-means/DBSCAN |
+| `/api/segmentation/list` | GET | Segmentos ativos |
+| `/api/segmentation/outliers` | GET | Outliers comportamentais |
+| `/api/bidding/recommend` | POST | Bid otimizado por segmento |
+| `/api/bidding/history` | GET | Histórico de bids |
+| `/api/bidding/status` | GET | Status por plataforma |
+
+### A/B Testing LTV
+| Rota | Método | Função |
+|---|---|---|
+| `/api/ltv/ab-test/create` | POST | Criar experimento |
+| `/api/ltv/ab-test/list` | GET | Listar experimentos |
+| `/api/ltv/ab-test/results` | GET | Accuracy por variação |
+| `/api/ltv/ab-test/winner` | POST | Declarar vencedor |
+
+### Fraud Detection
+| Rota | Método | Função |
+|---|---|---|
+| `/api/fraud/stats` | GET | Dashboard 24h |
+| `/api/fraud/alerts` | GET | Log de alertas |
+| `/api/fraud/blocklist` | GET | Lista bloqueada |
+| `/api/fraud/blocklist/add` | POST | Bloquear IP/fingerprint |
+| `/api/fraud/blocklist/remove` | DELETE | Desbloquear |
 
 ---
 
 ## 📞 SUPORTE
 
-- **Documentação**: Verifique `CLAUDE.md` para padrões de desenvolvimento
 - **Issues**: https://github.com/ricardosoli777/CDP-Edge-Premium/issues
 - **Releases**: https://github.com/ricardosoli777/CDP-Edge-Premium/releases
 
 ---
 
 ### **CDP Edge — By Rica Soares**
-> "Dados sem inteligência são apenas ruído. No Quantum Tier, transformamos dados em ROAS."
+> "Dados sem inteligência são apenas ruído. No Quantum Tier Enterprise, transformamos dados em ROAS."
 
 © 2026 CDP Edge Premium. Todos os direitos reservados.

package/docs/whatsapp-ctwa.md

@@ -120,7 +120,7 @@ A coluna `wamid` tem índice UNIQUE — garante que a mesma mensagem não seja p
 2. Menu lateral → **WhatsApp** → **Configuration**
 3. Seção **Webhook** → clique em **Edit**
 4. Preencha:
-   - **Callback URL:** `https://server-edge-tracker.suporte-ed9.workers.dev/webhook/whatsapp`
+   - **Callback URL:** `https://SEU_WORKER.SEU_USUARIO.workers.dev/webhook/whatsapp`
    - **Verify Token:** valor do secret `WA_WEBHOOK_VERIFY_TOKEN`
 5. Clique em **Verify and Save**
 6. Após verificar, clique em **Manage** → ative o campo **`messages`**
@@ -161,7 +161,7 @@ Depois do `Contact` inicial, você pode enviar eventos adicionais conforme o lea
 Exemplo de chamada para registrar uma venda fechada pelo WhatsApp:
 
 ```javascript
-fetch('https://server-edge-tracker.suporte-ed9.workers.dev/track', {
+fetch('https://SEU_WORKER.SEU_USUARIO.workers.dev/track', {
   method: 'POST',
   headers: { 'Content-Type': 'application/json' },
   body: JSON.stringify({