🚀 CDP Edge - Quantum Tracking

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

v1.1.0 — 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).

🏗️ ARQUITETURA QUANTUM (CLOUDFARE NATIVE)

O CDP Edge não é um "script de rastreio", é uma Content Delivery Network (CDN) com inteligência de dados acoplada.

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]
    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]

🖱 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:

🧠 Núcleo de Inteligência

🚀 Despachantes de Plataforma

🛡️ Módulos Enterprise (Premium)

💻 INSTALAÇÃO E USO (POWERShell)

Opção 1: Instalar Globalmente

# 1. Instalar o pacote
npm install -g cdp-edge

# 2. Verificar instalação
cdp-edge --version

# 3. Executar
cdp-edge

Opção 2: Usar via npx (sem instalar)

# Executar direto
npx cdp-edge

📋 COMANDOS DISPONÍVEIS

Comando Único (Wizard Interativo)

# Inicia wizard completo no diretório atual
cdp-edge

# Ou em outro diretório
cdp-edge "C:\caminho\do\projeto"

Comandos Específicos

1. Setup Completo

# Configuração interativa completa
cdp-edge setup

# Setup em diretório específico
cdp-edge setup "C:\meu-projeto"

O que faz:

• Pergunta plataformas (Meta, TikTok, GA4, etc.)
• Pergunta tipo de produto (lead, checkout, webinar, etc.)
• Analisa arquivos do projeto
• Gera código de tracking (Browser + Server)
• Cria schema D1 SQL
• Gera configuração Wrangler

2. Analisar Páginas

# Analisar diretório atual
cdp-edge analyze .

# Analisar projeto específico
cdp-edge analyze "C:\caminho\do\projeto"

O que faz:

• Lê todos os arquivos HTML/JS
• Detecta CTAs e formulários
• Identifica nicho do negócio
• Sugere micro-eventos comportamentais

3. Gerar Infraestrutura Server

# Gerar Worker + D1 no diretório atual
cdp-edge server .

# Gerar em diretório específico
cdp-edge server "C:\meu-worker-cloudflare"

Arquivos gerados:

• worker.js - Cloudflare Worker completo
• schema.sql - Schema D1 para persistência
• wrangler.toml - Configuração do Wrangler

4. Validar Tracking Existente

# Validar arquivo específico
cdp-edge validate "C:\meu-projeto\tracking.js"

O que verifica:

• Presença de event_id (deduplicação)
• Hashing SHA256 para PII (e-mail, telefone)
• Detecção de GTM/Stape (avisa para migrar)
• Conformidade com APIs mais recentes

5. Guia de Infraestrutura

# Mostra guia passo a passo do zero ao deploy
cdp-edge infra

Cobre:

• Criação de conta Cloudflare
• Instalação Wrangler CLI
• Configuração D1 Database
• Setup de secrets (API tokens)
• Deploy via wrangler deploy
• Configuração de domínio e rotas

🔄 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

CDP Edge/
├── README.md                        # Você está aqui. A bíblia do sistema.
├── CLAUDE.md                        # Guia de desenvolvimento e padrões.
├── extracted-skill/                 # O motor da IA (Agentes e Knowledge Base).
│   └── tracking-events-generator/
│       ├── agents/                  # 35+ agentes especialistas
│       ├── models/                  # Checklists de cenários de negócio
│       ├── cdpTrack.js              # SDK Browser (window.cdpTrack)
│       └── knowledge-base.md        # Enciclopédia de APIs e Schemas
├── 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)
└── templates/                       # Templates por cenário de negócio

📚 EXEMPLOS DE USO POWERShell

Cenário 1: Setup Completo para Landing Page

# 1. Navegar para o projeto
cd "C:\Users\comer\meus-projetos\landing-page-lead"

# 2. Executar setup
cdp-edge setup

# 3. Responder perguntas do wizard
# - Plataformas: [ ] Meta (Facebook/Instagram)
# - Tipo: Lead Capture (Formulário)
# - Server-side: [x] Sim

# 4. Arquivos gerados automaticamente:
#    - cdpTrack.js (Browser SDK)
#    - tracking.config.js
#    - worker.js (Cloudflare Worker)
#    - schema.sql (D1 Database)

Cenário 2: Apenas Infraestrutura Cloudflare

# 1. Criar diretório para o Worker
New-Item -Path "C:\meu-worker-cloudflare" -ItemType Directory
cd "C:\meu-worker-cloudflare"

# 2. Gerar infraestrutura
cdp-edge server .

# 3. Deploy com Wrangler
wrangler deploy

# 4. Configurar secrets
wrangler secret put META_ACCESS_TOKEN
wrangler secret put TIKTOK_ACCESS_TOKEN

Cenário 3: Validar Código Existe

# 1. Validar arquivo de tracking
cdp-edge validate "C:\meu-projeto\tracking.js"

# 2. Ver relatório
# Status: PASS
# Score:  85/100
#
# ⚠️  Avisos:
#   └─ Hashing não detectado para PII

Cenário 4: Análise de Projeto

# 1. Analisar projeto completo
cdp-edge analyze "C:\meu-projeto-web"

# 2. Resultado
# 📊 Eventos detectados:
#   leads: 2
#   purchases: 1
#   views: 3
#   custom: 0
#
# 🎯 Nicho identificado: E-commerce (SaaS)

⚡ COMANDOS RÁPIDOS (CLI)

🔧 SOLUÇÃO DE PROBLEMAS

Erro: "cdp-edge não é reconhecido"

# Solução 1: Instalar globalmente
npm install -g cdp-edge

# Solução 2: Usar npx
npx cdp-edge

# Solução 3: Verificar PATH
$env:Path -split ';' | Where-Object { $_ -like '*node*' }

Erro: "Permissão negada ao escrever arquivos"

# Executar PowerShell como Administrador
# 1. Clique com botão direito no PowerShell
# 2. "Executar como administrador"

Erro: "Módulo não encontrado"

# Limpar cache npm
npm cache clean --force

# Reinstalar pacote
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.

📞 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."

© 2026 CDP Edge Premium. Todos os direitos reservados.