🚀 CDP Edge — Quantum Tracking Enterprise

Padrão Quantum Tracking: 100% Cloudflare Edge. Sem GTM. Sem Stape. Sem cookies de terceiros.

v1.4.0 — Enterprise-Level Intelligence Engine · Cloudflare Workers · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3

📋 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

🏗️ ARQUITETURA QUANTUM ENTERPRISE (CLOUDFLARE NATIVE)

graph TD
    User((Usuário)) -->|Interação| SDK[cdpTrack SDK + Behavior Engine]
    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 -->|Reports| Dash[Dashboard Agent]

🧠 CATÁLOGO DE AGENTES ESPECIALISTAS

O sistema é composto por 43+ agentes coordenados pelo Master Orchestrator:

🧠 Núcleo de Inteligência

🚀 Plataformas de Anúncio

🤖 Enterprise Intelligence (Fase 1–4)

🛡️ Módulos Enterprise

📊 BANCO DE DADOS D1 — 21 Tabelas

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

🔄 FLUXO ENTERPRISE COMPLETO

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

💻 INSTALAÇÃO E USO

⚠️ Importante: Execute um comando por vez e aguarde terminar antes de rodar o próximo.

Passo 1 — Instalar o CLI globalmente

npm install -g cdp-edge

Passo 2 — Criar a pasta do projeto

cdp-edge install . --name "Nome do Projeto"

Passo 3 — Ativar no Claude Code

claude .

Dentro do Claude Code:

/cdp

🚀 DEPLOY COMPLETO (referência)

cd server-edge-tracker

# 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

# 2. Secrets
wrangler secret put META_ACCESS_TOKEN
wrangler secret put GA4_API_SECRET
wrangler secret put TIKTOK_ACCESS_TOKEN

# 3. Deploy
wrangler deploy

🖱️ HUMAN-BEHAVIOR ENGINE

📋 TODOS OS ENDPOINTS (referência rápida)

Core Tracking

Intelligence ML

A/B Testing LTV

Fraud Detection

📞 SUPORTE

• 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 Enterprise, transformamos dados em ROAS."

© 2026 CDP Edge Premium. Todos os direitos reservados.