cdp-edge 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +153 -306
- package/bin/cdp-edge.js +71 -61
- package/contracts/agent-versions.json +682 -0
- package/contracts/api-versions.json +372 -368
- package/contracts/types.ts +81 -0
- package/dist/commands/analyze.js +52 -52
- package/dist/commands/infra.js +54 -54
- package/dist/commands/install.js +26 -3
- package/dist/commands/server.js +174 -174
- package/dist/commands/setup.js +332 -100
- package/dist/commands/validate.js +248 -84
- package/dist/index.js +12 -12
- package/dist/sdk/cdpTrack.js +2095 -0
- package/dist/sdk/cdpTrack.min.js +64 -0
- package/dist/sdk/install-snippet.html +10 -0
- package/docs/whatsapp-ctwa.md +5 -4
- package/extracted-skill/tracking-events-generator/INTEGRACAO-COMPLETA.md +89 -0
- package/extracted-skill/tracking-events-generator/MELHORIAS-IMPLEMENTADAS.md +101 -0
- package/extracted-skill/tracking-events-generator/advanced-matching.js +364 -364
- package/extracted-skill/tracking-events-generator/agents/ab-ltv-agent.md +196 -0
- package/extracted-skill/tracking-events-generator/agents/ab-testing-agent.md +1 -1
- package/extracted-skill/tracking-events-generator/agents/attribution-agent.md +41 -41
- package/extracted-skill/tracking-events-generator/agents/bidding-agent.md +347 -0
- package/extracted-skill/tracking-events-generator/agents/bing-agent.md +40 -50
- package/extracted-skill/tracking-events-generator/agents/browser-tracking.md +174 -74
- package/extracted-skill/tracking-events-generator/agents/code-guardian-agent.md +1 -1
- package/extracted-skill/tracking-events-generator/agents/compliance-agent.md +25 -5
- package/extracted-skill/tracking-events-generator/agents/dashboard-agent.md +10 -10
- package/extracted-skill/tracking-events-generator/agents/database-agent.md +43 -42
- package/extracted-skill/tracking-events-generator/agents/debug-agent.md +22 -22
- package/extracted-skill/tracking-events-generator/agents/devops-agent.md +232 -0
- package/extracted-skill/tracking-events-generator/agents/domain-setup-agent.md +23 -9
- package/extracted-skill/tracking-events-generator/agents/email-agent.md +28 -1
- package/extracted-skill/tracking-events-generator/agents/evo-crm-agent.md +244 -0
- package/extracted-skill/tracking-events-generator/agents/fingerprint-agent.md +206 -1
- package/extracted-skill/tracking-events-generator/agents/fraud-detection-agent.md +143 -0
- package/extracted-skill/tracking-events-generator/agents/google-agent.md +128 -2
- package/extracted-skill/tracking-events-generator/agents/intelligence-agent.md +191 -31
- package/extracted-skill/tracking-events-generator/agents/lead-scoring-agent.md +282 -0
- package/extracted-skill/tracking-events-generator/agents/linkedin-agent.md +145 -34
- package/extracted-skill/tracking-events-generator/agents/localization-agent.md +1 -1
- package/extracted-skill/tracking-events-generator/agents/ltv-predictor-agent.md +5 -5
- package/extracted-skill/tracking-events-generator/agents/master-feedback-loop.md +81 -21
- package/extracted-skill/tracking-events-generator/agents/master-orchestrator.md +428 -190
- package/extracted-skill/tracking-events-generator/agents/match-quality-agent.md +304 -0
- package/extracted-skill/tracking-events-generator/agents/memory-agent.json +25 -109
- package/extracted-skill/tracking-events-generator/agents/memory-agent.md +190 -15
- package/extracted-skill/tracking-events-generator/agents/meta-agent.md +10 -2
- package/extracted-skill/tracking-events-generator/agents/ml-clustering-agent.md +749 -0
- package/extracted-skill/tracking-events-generator/agents/page-analyzer.md +21 -4
- package/extracted-skill/tracking-events-generator/agents/performance-agent.md +41 -31
- package/extracted-skill/tracking-events-generator/agents/performance-optimization-agent.md +18 -8
- package/extracted-skill/tracking-events-generator/agents/pinterest-agent.md +14 -6
- package/extracted-skill/tracking-events-generator/agents/premium-tracking-intelligence-agent.md +7 -7
- package/extracted-skill/tracking-events-generator/agents/r2-setup-agent.md +16 -8
- package/extracted-skill/tracking-events-generator/agents/reddit-agent.md +15 -7
- package/extracted-skill/tracking-events-generator/agents/security-enterprise-agent.md +157 -48
- package/extracted-skill/tracking-events-generator/agents/server-tracking.md +35 -35
- package/extracted-skill/tracking-events-generator/agents/spotify-agent.md +15 -7
- package/extracted-skill/tracking-events-generator/agents/tiktok-agent.md +73 -2
- package/extracted-skill/tracking-events-generator/agents/tracking-plan-agent.md +104 -9
- package/extracted-skill/tracking-events-generator/agents/utm-agent.md +322 -0
- package/extracted-skill/tracking-events-generator/agents/validator-agent.md +13 -9
- package/extracted-skill/tracking-events-generator/agents/webhook-agent.md +112 -4
- package/extracted-skill/tracking-events-generator/agents/whatsapp-agent.md +58 -5
- package/extracted-skill/tracking-events-generator/agents/whatsapp-ctwa-setup-agent.md +26 -18
- package/extracted-skill/tracking-events-generator/agents/youtube-agent.md +152 -37
- package/extracted-skill/tracking-events-generator/anti-blocking.js +285 -285
- package/extracted-skill/tracking-events-generator/cdpTrack.js +642 -641
- package/extracted-skill/tracking-events-generator/contracts/api-versions.json +14 -10
- package/extracted-skill/tracking-events-generator/engagement-scoring.js +226 -226
- package/extracted-skill/tracking-events-generator/evals/evals.json +235 -235
- package/extracted-skill/tracking-events-generator/integration-test.js +497 -497
- package/extracted-skill/tracking-events-generator/knowledge-base.md +172 -0
- package/extracted-skill/tracking-events-generator/micro-events.js +992 -992
- package/extracted-skill/tracking-events-generator/models/lancamento-imobiliario.md +344 -0
- package/extracted-skill/tracking-events-generator/models/pinterest/conversions-api-template.js +144 -144
- package/extracted-skill/tracking-events-generator/models/pinterest/event-mappings.json +48 -48
- package/extracted-skill/tracking-events-generator/models/pinterest/tag-template.js +28 -28
- package/extracted-skill/tracking-events-generator/models/quiz-funnel.md +83 -19
- package/extracted-skill/tracking-events-generator/models/reddit/conversions-api-template.js +205 -205
- package/extracted-skill/tracking-events-generator/models/reddit/event-mappings.json +56 -56
- package/extracted-skill/tracking-events-generator/models/reddit/pixel-template.js +19 -19
- package/extracted-skill/tracking-events-generator/models/scenarios/behavior-engine.js +425 -425
- package/extracted-skill/tracking-events-generator/route-intent-capture.js +222 -0
- package/extracted-skill/tracking-events-generator/tracking.config.js +3 -3
- package/package.json +89 -75
- package/scripts/build-sdk.js +106 -0
- package/server-edge-tracker/.client.env.example +14 -0
- package/server-edge-tracker/INSTALAR.md +222 -23
- package/server-edge-tracker/SEGMENTATION-DOCS.md +513 -0
- package/server-edge-tracker/config/utm-mapping.json +64 -0
- package/server-edge-tracker/deploy-client.cjs +76 -0
- package/server-edge-tracker/index.ts +1230 -0
- package/server-edge-tracker/migrate-v7.sql +64 -0
- package/server-edge-tracker/modules/db.ts +710 -0
- package/server-edge-tracker/modules/dispatch/crm.ts +382 -0
- package/server-edge-tracker/modules/dispatch/ga4.ts +72 -0
- package/server-edge-tracker/modules/dispatch/meta.ts +143 -0
- package/server-edge-tracker/modules/dispatch/platforms.ts +255 -0
- package/server-edge-tracker/modules/dispatch/tiktok.ts +107 -0
- package/server-edge-tracker/modules/dispatch/whatsapp.ts +296 -0
- package/server-edge-tracker/modules/intelligence.ts +589 -0
- package/server-edge-tracker/modules/ml/bidding.ts +247 -0
- package/server-edge-tracker/modules/ml/fraud.ts +302 -0
- package/server-edge-tracker/modules/ml/logistic.ts +226 -0
- package/server-edge-tracker/modules/ml/ltv.ts +531 -0
- package/server-edge-tracker/modules/ml/matchquality.ts +232 -0
- package/server-edge-tracker/modules/ml/quiz.ts +343 -0
- package/server-edge-tracker/modules/ml/roas.ts +255 -0
- package/server-edge-tracker/modules/ml/segmentation.ts +407 -0
- package/server-edge-tracker/modules/nurture.ts +257 -0
- package/server-edge-tracker/modules/utils.ts +311 -0
- package/server-edge-tracker/modules/utm/utm-enricher.ts +231 -0
- package/server-edge-tracker/schema-ab-ltv.sql +97 -0
- package/server-edge-tracker/schema-bidding.sql +86 -0
- package/server-edge-tracker/schema-fraud.sql +90 -0
- package/server-edge-tracker/schema-indexes.sql +67 -0
- package/server-edge-tracker/schema-ltv-feedback.sql +11 -0
- package/server-edge-tracker/schema-quiz.sql +52 -0
- package/server-edge-tracker/schema-sales-engine.sql +113 -0
- package/server-edge-tracker/schema-segmentation.sql +219 -0
- package/server-edge-tracker/schema-utm.sql +82 -0
- package/server-edge-tracker/schema.sql +281 -265
- package/server-edge-tracker/types.ts +275 -0
- package/server-edge-tracker/wrangler.toml +140 -85
- package/templates/lancamento-imobiliario.md +344 -0
- package/templates/multi-step-checkout.md +3 -4
- package/templates/pinterest/conversions-api-template.js +144 -144
- package/templates/pinterest/event-mappings.json +48 -48
- package/templates/pinterest/tag-template.js +28 -28
- package/templates/quiz-funnel.md +83 -19
- package/templates/reddit/conversions-api-template.js +205 -205
- package/templates/reddit/event-mappings.json +56 -56
- package/templates/reddit/pixel-template.js +12 -39
- package/templates/scenarios/behavior-engine.js +45 -22
- package/docs/PixelBuilder-Documentacao-Completa (2).docx +0 -0
- package/docs/installation.md +0 -155
- package/docs/quick-start.md +0 -185
- package/extracted-skill/tracking-events-generator/agents/crm-integration-agent.md +0 -1419
- package/extracted-skill/tracking-events-generator/agents/intelligence-scheduling.md +0 -643
- package/server-edge-tracker/worker.js +0 -2574
package/README.md
CHANGED
|
@@ -1,367 +1,214 @@
|
|
|
1
|
-
# 🚀 CDP Edge
|
|
2
|
-
|
|
1
|
+
# 🚀 CDP Edge — Quantum Tracking Enterprise
|
|
3
2
|
**Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
|
|
4
3
|
|
|
5
|
-
> **
|
|
6
|
-
|
|
7
|
-
- **Precisão Máxima**: Meta CAPI v22.0+, GA4 MP e TikTok Events API v1.3.
|
|
8
|
-
- **Identity Graph**: Persistência de leads e eventos via Cloudflare D1.
|
|
9
|
-
- **Anti-Adblock**: Endpoint Same-Domain indetectável.
|
|
10
|
-
- **Human-Behavior Engine**: Score de engajamento (0-100) em tempo real.
|
|
11
|
-
- **Queue Retry**: Zero perda de conversão — eventos com falha reenfileirados automaticamente.
|
|
12
|
-
- **Geo Intelligence**: Cidade, estado e CEP em todos os eventos (Workers Paid).
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
## 🏗️ ARQUITETURA QUANTUM (CLOUDFARE NATIVE)
|
|
17
|
-
|
|
18
|
-
O CDP Edge não é um "script de rastreio", é uma **Content Delivery Network (CDN)** com inteligência de dados acoplada.
|
|
19
|
-
|
|
20
|
-
```mermaid
|
|
21
|
-
graph TD
|
|
22
|
-
User((Usuário)) -->|Interação| SDK[cdpTrack SDK + Behavior Engine]
|
|
23
|
-
SDK -->|Edge Fetch| Worker[Cloudflare Worker Agent]
|
|
24
|
-
Worker -->|Identity Graph| D1[(D1 SQL Database)]
|
|
25
|
-
Worker -->|Background Job| Queue[Cloudflare Queues]
|
|
26
|
-
Queue -->|Server Dispatch| Meta[Meta CAPI v22.0]
|
|
27
|
-
Queue -->|Server Dispatch| Google[GA4 / Google Ads]
|
|
28
|
-
Queue -->|Server Dispatch| TikTok[TikTok API v1.3]
|
|
29
|
-
D1 -->|Retention Reports| Dash[Dashboard Agent]
|
|
30
|
-
```
|
|
31
|
-
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
## 🖱 CATÁLOGO DE AGENTES ESPECIALISTAS
|
|
35
|
-
|
|
36
|
-
O sistema é composto por mais de 30 agentes coordenados pelo **Master Orchestrator**. Cada um possui uma função técnica específica:
|
|
37
|
-
|
|
38
|
-
### 🧠 Núcleo de Inteligência
|
|
39
|
-
| Agente | Função |
|
|
40
|
-
|---|---|
|
|
41
|
-
| **Master Orchestrator** | Coordenação central de especialistas e validação Quantum Tier. |
|
|
42
|
-
| **Page Analyzer** | Mapeamento automático de CTAs, Forms e Nicho do site. |
|
|
43
|
-
| **Validator Agent** | Auditoria de código, segurança e conformidade de APIs. |
|
|
44
|
-
| **Memory Agent** | Gestão de contexto e checkpoints técnicos da sessão. |
|
|
45
|
-
| **Intelligence Agent** | Monitoramento de atualizações de API (Meta v22.0+, etc). |
|
|
46
|
-
|
|
47
|
-
### 🚀 Despachantes de Plataforma
|
|
48
|
-
| Agente | Especialidade |
|
|
49
|
-
|---|---|
|
|
50
|
-
| **Meta Agent** | Facebook Pixel + CAPI (EMQ Max). |
|
|
51
|
-
| **Google Agent** | GA4 + Google Ads Server-Side. |
|
|
52
|
-
| **TikTok Agent** | TikTok Pixel + Events API v1.3. |
|
|
53
|
-
| **Plataformas Ads** | Pinterest, Reddit, Bing, LinkedIn, Spotify. |
|
|
54
|
-
| **Browser Agent** | Geração do SDK `cdpTrack.js` lightweight. |
|
|
55
|
-
|
|
56
|
-
### 🛡️ Módulos Enterprise (Premium)
|
|
57
|
-
| Agente | Função |
|
|
58
|
-
|---|---|
|
|
59
|
-
| **Attribution Agent** | Atribuição Multi-Touch de alta fidelidade. |
|
|
60
|
-
| **Security Agent** | Rate Limiting, Criptografia AES-256 e Bot Defense. |
|
|
61
|
-
| **Compliance Agent** | Gestão de LGPD e GDPR (Consent Mode v2). |
|
|
62
|
-
| **Performance Opt.** | Otimização de Caches e Queries D1 SQL. |
|
|
63
|
-
| **CRM Integration** | Sincronia D1 ↔ HubSpot/Salesforce via CRM Agent. |
|
|
4
|
+
> **v2.5.5** — Integração EVO CRM (OAuth2) + Sync Total de Agentes (27 de Abril de 2026) 🔧
|
|
64
5
|
|
|
65
6
|
---
|
|
66
7
|
|
|
67
|
-
## 💻 INSTALAÇÃO
|
|
68
|
-
|
|
69
|
-
### Instalar Globalmente
|
|
8
|
+
## 💻 INSTALAÇÃO
|
|
70
9
|
|
|
71
10
|
```bash
|
|
11
|
+
npx cdp-edge install
|
|
12
|
+
# ou
|
|
72
13
|
npm install -g cdp-edge
|
|
73
|
-
cdp-edge --
|
|
14
|
+
cdp-edge install . --name "Nome do Projeto"
|
|
74
15
|
```
|
|
75
16
|
|
|
76
17
|
---
|
|
77
18
|
|
|
78
|
-
##
|
|
79
|
-
|
|
80
|
-
### `install` — Instalar CDP Edge em um projeto cliente
|
|
81
|
-
|
|
82
|
-
**O comando principal.** Configura o CDP Edge em qualquer projeto e habilita o `/cdp` no Claude Code.
|
|
83
|
-
|
|
84
|
-
```bash
|
|
85
|
-
# Instalar no diretório atual
|
|
86
|
-
cdp-edge install .
|
|
87
|
-
|
|
88
|
-
# Instalar em outro diretório
|
|
89
|
-
cdp-edge install ./meu-projeto
|
|
90
|
-
|
|
91
|
-
# Com nome do projeto
|
|
92
|
-
cdp-edge install ./meu-projeto --name "Landing Page XYZ"
|
|
93
|
-
|
|
94
|
-
# Incluir .cursorrules para Cursor IDE
|
|
95
|
-
cdp-edge install ./meu-projeto --cursor
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
**O que cria na raiz do projeto:**
|
|
99
|
-
|
|
100
|
-
| Arquivo/Pasta | Função |
|
|
101
|
-
|---|---|
|
|
102
|
-
| `cdp-edge/` | Skill completa (agentes, SDK, worker, templates, docs) |
|
|
103
|
-
| `.claude/commands/cdp.md` | Habilita `/cdp` no Claude Code |
|
|
104
|
-
| `CLAUDE.md` | Auto-ativação ao abrir sessão |
|
|
105
|
-
| `.cursorrules` | Integração Cursor IDE (flag `--cursor`) |
|
|
106
|
-
|
|
107
|
-
**Fluxo após install:**
|
|
19
|
+
## 🤖 MANIFESTO: EU, CDP EDGE
|
|
108
20
|
|
|
109
|
-
|
|
110
|
-
# 1. Criar e instalar
|
|
111
|
-
mkdir meu-projeto
|
|
112
|
-
cdp-edge install ./meu-projeto
|
|
113
|
-
|
|
114
|
-
# 2. Abrir no Claude Code
|
|
115
|
-
claude ./meu-projeto
|
|
21
|
+
*Eu não sou um simples "script de pixel". Eu sou uma arquitetura **Enterprise Tier 10** nascida e construída 100% nativa na infraestrutura da Cloudflare.*
|
|
116
22
|
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
23
|
+
Quando um evento de Lead bate no endpoint `/track`:
|
|
24
|
+
1. **Fraud Gate:** Bloqueio bots silenciosamente antes de qualquer processamento (~2ms via KV)
|
|
25
|
+
2. **Quiz Scoring Engine:** Classifico as respostas do quiz com Granite 4.0 Micro — `comprador | interessado | curioso | perdido`
|
|
26
|
+
3. **A/B LTV Testing:** Sorteio de prompt via KV Cache em ~0ms
|
|
27
|
+
4. **LTV Predictor:** Machine Learning para qualificar intenção e gerar valor preditivo em BRL
|
|
28
|
+
5. **Nurture Scheduler:** Agendar sequência de follow-up baseada na qualificação (background)
|
|
29
|
+
6. **CAPI Dispatch:** Meta/GA4/TikTok recebem payload limpo com LTV e intention injetados
|
|
30
|
+
7. **Sales Engine:** Semanalmente, calculo ROAS real por campanha e atualizo o seed de Lookalike com compradores confirmados
|
|
120
31
|
|
|
121
32
|
---
|
|
122
33
|
|
|
123
|
-
|
|
34
|
+
## 🏗️ ARQUITETURA QUANTUM ENTERPRISE
|
|
124
35
|
|
|
125
|
-
#### `setup` — Wizard interativo
|
|
126
|
-
|
|
127
|
-
```bash
|
|
128
|
-
cdp-edge setup
|
|
129
|
-
cdp-edge setup ./meu-projeto
|
|
130
36
|
```
|
|
37
|
+
POST /track (QuizComplete)
|
|
38
|
+
│
|
|
39
|
+
├─ [1] 🛡️ Fraud Gate (KV blocklist + velocity) ~2ms
|
|
40
|
+
├─ [2] 🤖 Quiz Scoring Engine (Granite 4.0 Micro) → comprador/interessado/curioso/perdido
|
|
41
|
+
├─ [3] 🔮 A/B LTV Sorting (KV cache ~0ms)
|
|
42
|
+
├─ [4] 🧮 LTV Prediction (Granite 4.0 Micro) — intent qualificado → High LTV
|
|
43
|
+
├─ [5] 💾 D1 Writes background (quiz_sessions + leads + nurture_sequences)
|
|
44
|
+
└─ [6] 📡 CAPI paralelo (Meta v22.0 + GA4 + TikTok v1.3)
|
|
131
45
|
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
---
|
|
139
|
-
|
|
140
|
-
#### `analyze` — Analisar páginas
|
|
141
|
-
|
|
142
|
-
```bash
|
|
143
|
-
cdp-edge analyze .
|
|
144
|
-
cdp-edge analyze ./meu-projeto
|
|
46
|
+
Cron semanal (Intelligence Agent):
|
|
47
|
+
├─ ROAS Feedback — cruza leads × purchases por campanha → bid recommendation
|
|
48
|
+
├─ Nurture Queue — envia D+1/D+3/D+7 para leads qualificados
|
|
49
|
+
├─ Lookalike Seed — compradores confirmados → Meta Custom Audience
|
|
50
|
+
├─ LTV Model Training — regressão logística com dados reais
|
|
51
|
+
└─ A/B LTV Auto-winner — declara vencedor quando amostra suficiente
|
|
145
52
|
```
|
|
146
53
|
|
|
147
|
-
**O que faz:**
|
|
148
|
-
- Detecta CTAs e formulários
|
|
149
|
-
- Identifica nicho do negócio
|
|
150
|
-
- Sugere micro-eventos comportamentais
|
|
151
|
-
|
|
152
54
|
---
|
|
153
55
|
|
|
154
|
-
|
|
56
|
+
## 📊 BANCO DE DADOS D1 — 31 Tabelas + 12 VIEWs
|
|
155
57
|
|
|
156
|
-
```bash
|
|
157
|
-
cdp-edge server .
|
|
158
|
-
cdp-edge server ./meu-worker
|
|
159
58
|
```
|
|
59
|
+
CORE TRACKING ML & INTELLIGENCE SALES ENGINE
|
|
60
|
+
────────────── ───────────────────── ──────────────────
|
|
61
|
+
leads ml_segments roas_reports
|
|
62
|
+
events ml_segment_members nurture_sequences
|
|
63
|
+
sessions bid_recommendations lookalike_seeds
|
|
64
|
+
webhook_events ltv_ab_tests quiz_sessions
|
|
65
|
+
api_failures ltv_ab_variations
|
|
66
|
+
device_graph ltv_ab_assignments
|
|
67
|
+
user_profiles fraud_signals
|
|
68
|
+
intelligence_logs fraud_alerts
|
|
69
|
+
messaging_history match_quality_logs
|
|
70
|
+
automation_rules utm_mappings
|
|
71
|
+
edge_fingerprints
|
|
160
72
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
```bash
|
|
171
|
-
cdp-edge validate tracking.js
|
|
73
|
+
VIEWS (12)
|
|
74
|
+
──────────────────────────────────────────────────────────────────
|
|
75
|
+
v_active_segments v_active_bid_recs
|
|
76
|
+
v_ab_test_performance v_fraud_dashboard
|
|
77
|
+
v_quiz_qualification_summary v_quiz_dimension_impact
|
|
78
|
+
v_roas_latest v_nurture_pending
|
|
79
|
+
v_nurture_stats v_quiz_session_summary
|
|
80
|
+
v_leads_segmented v_ltv_feedback
|
|
172
81
|
```
|
|
173
82
|
|
|
174
|
-
**O que verifica:**
|
|
175
|
-
- `event_id` para deduplicação
|
|
176
|
-
- SHA256 para PII (e-mail, telefone)
|
|
177
|
-
- Detecção de GTM/Stape
|
|
178
|
-
- Conformidade com APIs
|
|
179
|
-
|
|
180
83
|
---
|
|
181
84
|
|
|
182
|
-
|
|
85
|
+
## 🧠 CATÁLOGO DE MÓDULOS ML
|
|
183
86
|
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
87
|
+
| Módulo | Arquivo | Função |
|
|
88
|
+
|---|---|---|
|
|
89
|
+
| **Quiz Scoring** | `modules/ml/quiz.ts` | Análise dimensional automática das respostas |
|
|
90
|
+
| **LTV Prediction** | `modules/ml/ltv.ts` | Score 0-100 + valor BRL via Granite + A/B test |
|
|
91
|
+
| **Fraud Gate** | `modules/ml/fraud.ts` | Detecção de bots e fraude na borda |
|
|
92
|
+
| **ML Clustering** | `modules/ml/segmentation.ts` | K-means vetorial com bge-m3 embeddings |
|
|
93
|
+
| **Bidding ML** | `modules/ml/bidding.ts` | Recomendação de bid por segmento × plataforma |
|
|
94
|
+
| **ROAS Feedback** | `modules/ml/roas.ts` | ROAS real por campanha, alimenta bidding |
|
|
95
|
+
| **Match Quality** | `modules/ml/matchquality.ts` | Score de qualidade de dados para CAPI |
|
|
96
|
+
| **Logistic** | `modules/ml/logistic.ts` | Regressão logística para LTV model treinável |
|
|
97
|
+
| **Nurture Engine** | `modules/nurture.ts` | Sequências automáticas pós-qualificação |
|
|
187
98
|
|
|
188
99
|
---
|
|
189
100
|
|
|
190
|
-
##
|
|
191
|
-
|
|
192
|
-
1. **FASE 0 — Checkpoint:** Sincronização de contexto via Memory Agent.
|
|
193
|
-
2. **FASE 1 — Análise:** Detecção automática de nicho e estrutura da página.
|
|
194
|
-
3. **FASE 2 — Mapeamento:** Identificação de CTAs, Forms e Gateways de venda.
|
|
195
|
-
4. **FASE 3 — Geração:** Código paralelo para Browser (`cdpTrack`), Worker e D1 SQL.
|
|
196
|
-
5. **FASE 4 — Auditoria:** Validação rigorosa e correções automáticas (Validator).
|
|
197
|
-
6. **FASE 5 — Deploy:** Publicação instantânea via `wrangler deploy`.
|
|
198
|
-
|
|
199
|
-
---
|
|
101
|
+
## 🧠 CATÁLOGO DE AGENTES
|
|
200
102
|
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
│ ├── worker.js # Handler principal + Queue consumer
|
|
214
|
-
│ ├── schema.sql # D1 Schema (Identity Graph)
|
|
215
|
-
│ └── wrangler.toml # Bindings: D1 + Queue + KV + AI
|
|
216
|
-
├── bin/ # CLI Executável (cdp-edge)
|
|
217
|
-
├── dist/commands/ # Implementação dos comandos CLI
|
|
218
|
-
│ └── install.js # cdp-edge install
|
|
219
|
-
├── templates/
|
|
220
|
-
│ ├── install/
|
|
221
|
-
│ │ ├── CLAUDE.md # Template de auto-ativação para projetos
|
|
222
|
-
│ │ └── .claude/commands/
|
|
223
|
-
│ │ └── cdp.md # Define /cdp no Claude Code
|
|
224
|
-
│ ├── vsl-page.md # Template VSL / vídeo de vendas
|
|
225
|
-
│ └── afiliado-sem-landing.md # Template bridge page afiliado
|
|
226
|
-
└── docs/
|
|
227
|
-
├── quick-start.md # Do zero ao deploy
|
|
228
|
-
├── events-reference.md # Catálogo completo de eventos
|
|
229
|
-
├── sdk-reference.md # API pública do cdpTrack.js
|
|
230
|
-
└── installation.md # Instalar CDP Edge em projetos clientes
|
|
231
|
-
```
|
|
103
|
+
| Categoria | Agente | Função |
|
|
104
|
+
|---|---|---|
|
|
105
|
+
| Orquestração | `master-orchestrator.md` | Coordena todo o setup |
|
|
106
|
+
| Análise | `page-analyzer.md` | Detecta CTAs, forms e nicho |
|
|
107
|
+
| Plataformas | `meta-agent.md`, `google-agent.md`, `tiktok-agent.md`... | Especialistas por plataforma |
|
|
108
|
+
| Infra | `server-tracking.md`, `devops-agent.md` | Arquitetura Cloudflare |
|
|
109
|
+
| Enterprise | `ml-clustering-agent.md` | Segmentação dinâmica ML |
|
|
110
|
+
| Enterprise | `bidding-agent.md` | Bids ML por segmento |
|
|
111
|
+
| Enterprise | `ab-ltv-agent.md` | A/B testing de prompts LTV |
|
|
112
|
+
| Enterprise | `fraud-detection-agent.md` | Detecção de fraude na borda |
|
|
113
|
+
| Infraestrutura | `evo-crm-agent.md` | Roteamento de leads p/ EVO CRM (OAuth2) |
|
|
114
|
+
| Monitoramento | `intelligence-agent.md` | Cron — ROAS, Nurture, Lookalike, LTV training |
|
|
232
115
|
|
|
233
116
|
---
|
|
234
117
|
|
|
235
|
-
##
|
|
236
|
-
|
|
237
|
-
### Cenário 1: Novo projeto com Claude Code
|
|
238
|
-
|
|
239
|
-
```bash
|
|
240
|
-
# 1. Criar projeto e instalar CDP Edge
|
|
241
|
-
mkdir landing-page-lead
|
|
242
|
-
cdp-edge install ./landing-page-lead --name "Landing Page Lead"
|
|
118
|
+
## 📋 TODOS OS ENDPOINTS
|
|
243
119
|
|
|
244
|
-
|
|
245
|
-
|
|
120
|
+
### Core
|
|
121
|
+
| Rota | Método | Função |
|
|
122
|
+
|---|---|---|
|
|
123
|
+
| `/track` | POST | Evento principal — Fraud Gate → Quiz Scoring → LTV → CAPI |
|
|
124
|
+
| `/health` | GET | Smoke test D1 + KV + AI |
|
|
125
|
+
| `/webhook/ticto` | POST | Purchase webhook (HMAC) |
|
|
126
|
+
| `/webhook/whatsapp` | POST | Webhook Meta WhatsApp → CRM (Evolution/EVO) |
|
|
127
|
+
| `/export/customer-match` | GET | Export leads para Google Ads |
|
|
128
|
+
| `/validate-install` | GET | Diagnóstico pós-deploy |
|
|
246
129
|
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
|
|
250
|
-
|
|
130
|
+
### ML Clustering (Fase 1)
|
|
131
|
+
| Rota | Método | Função |
|
|
132
|
+
|---|---|---|
|
|
133
|
+
| `/api/segmentation/cluster` | POST | K-means vetorial (bge-m3 + Granite) |
|
|
134
|
+
| `/api/segmentation/list` | GET | Segmentos ativos |
|
|
135
|
+
| `/api/segmentation/outliers` | GET | Outliers comportamentais |
|
|
136
|
+
| `/api/segmentation/update` | PUT | Atualiza metadados |
|
|
137
|
+
|
|
138
|
+
### Bidding (Fase 2)
|
|
139
|
+
| Rota | Método | Função |
|
|
140
|
+
|---|---|---|
|
|
141
|
+
| `/api/bidding/recommend` | POST | Bid por segmento × plataforma |
|
|
142
|
+
| `/api/bidding/history` | GET | Histórico de recomendações |
|
|
143
|
+
| `/api/bidding/status` | GET | Snapshot atual |
|
|
144
|
+
|
|
145
|
+
### A/B LTV (Fase 3)
|
|
146
|
+
| Rota | Método | Função |
|
|
147
|
+
|---|---|---|
|
|
148
|
+
| `/api/ltv/ab-test/create` | POST | Cria experimento |
|
|
149
|
+
| `/api/ltv/ab-test/list` | GET | Lista experimentos |
|
|
150
|
+
| `/api/ltv/ab-test/results` | GET | Accuracy por variação |
|
|
151
|
+
| `/api/ltv/ab-test/winner` | POST | Declara vencedor |
|
|
251
152
|
|
|
252
|
-
###
|
|
153
|
+
### Fraud (Fase 4)
|
|
154
|
+
| Rota | Método | Função |
|
|
155
|
+
|---|---|---|
|
|
156
|
+
| `/api/fraud/stats` | GET | Dashboard 24h |
|
|
157
|
+
| `/api/fraud/alerts` | GET | Log de sinais |
|
|
158
|
+
| `/api/fraud/blocklist` | GET | IPs bloqueados |
|
|
159
|
+
| `/api/fraud/blocklist/add` | POST | Bloquear |
|
|
160
|
+
| `/api/fraud/blocklist/remove` | DELETE | Desbloquear |
|
|
161
|
+
|
|
162
|
+
---
|
|
163
|
+
|
|
164
|
+
## 🚀 DEPLOY COMPLETO
|
|
253
165
|
|
|
254
166
|
```bash
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
wrangler
|
|
261
|
-
|
|
262
|
-
|
|
167
|
+
cd server-edge-tracker
|
|
168
|
+
|
|
169
|
+
# Schemas D1 (ordem correta — todos idempotentes)
|
|
170
|
+
wrangler d1 execute cdp-edge-db --file=schema.sql --remote
|
|
171
|
+
wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
|
|
172
|
+
wrangler d1 execute cdp-edge-db --file=schema-segmentation.sql --remote
|
|
173
|
+
wrangler d1 execute cdp-edge-db --file=schema-bidding.sql --remote
|
|
174
|
+
wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote
|
|
175
|
+
wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote
|
|
176
|
+
wrangler d1 execute cdp-edge-db --file=schema-indexes.sql --remote
|
|
177
|
+
wrangler d1 execute cdp-edge-db --file=migrate-v7.sql --remote
|
|
178
|
+
wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote
|
|
179
|
+
wrangler d1 execute cdp-edge-db --file=schema-utm.sql --remote
|
|
180
|
+
wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote
|
|
181
|
+
wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
|
|
182
|
+
|
|
183
|
+
# Secrets (nunca em arquivos — sempre via wrangler secret put)
|
|
263
184
|
wrangler secret put META_ACCESS_TOKEN
|
|
185
|
+
wrangler secret put GA4_API_SECRET
|
|
264
186
|
wrangler secret put TIKTOK_ACCESS_TOKEN
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
|
|
269
|
-
```bash
|
|
270
|
-
cdp-edge validate tracking.js
|
|
187
|
+
wrangler secret put EVO_CRM_BASE_URL
|
|
188
|
+
wrangler secret put EVO_CRM_CLIENT_ID
|
|
189
|
+
wrangler secret put EVO_CRM_CLIENT_SECRET
|
|
190
|
+
wrangler secret put EVO_CRM_INBOX_ID
|
|
271
191
|
|
|
272
|
-
#
|
|
273
|
-
|
|
274
|
-
```
|
|
275
|
-
|
|
276
|
-
### Cenário 4: Análise de Projeto
|
|
277
|
-
|
|
278
|
-
```bash
|
|
279
|
-
cdp-edge analyze ./meu-projeto-web
|
|
280
|
-
|
|
281
|
-
# 📊 Eventos detectados: leads: 2 | purchases: 1 | views: 3
|
|
282
|
-
# 🎯 Nicho identificado: E-commerce
|
|
192
|
+
# Deploy
|
|
193
|
+
wrangler deploy
|
|
283
194
|
```
|
|
284
195
|
|
|
285
196
|
---
|
|
286
197
|
|
|
287
|
-
##
|
|
288
|
-
|
|
289
|
-
| Comando | Descrição |
|
|
290
|
-
|---------|-----------|
|
|
291
|
-
| `cdp-edge install [dir]` | **Instala CDP Edge + habilita /cdp no Claude Code** |
|
|
292
|
-
| `cdp-edge setup [dir]` | Configuração guiada (wizard) |
|
|
293
|
-
| `cdp-edge analyze <dir>` | Análise de páginas |
|
|
294
|
-
| `cdp-edge server <dir>` | Gerar infraestrutura Workers + D1 |
|
|
295
|
-
| `cdp-edge validate <file>` | Auditoria de código |
|
|
296
|
-
| `cdp-edge infra` | Guia Cloudflare |
|
|
297
|
-
| `cdp-edge --help` | Ajuda completa |
|
|
298
|
-
| `cdp-edge --version` | Versão instalada |
|
|
299
|
-
|
|
300
|
-
---
|
|
301
|
-
|
|
302
|
-
## 🔧 SOLUÇÃO DE PROBLEMAS
|
|
303
|
-
|
|
304
|
-
### Erro: "Cannot find module dist/commands/install.js"
|
|
305
|
-
|
|
306
|
-
O npm ainda tem a versão antiga em cache. Instale direto do GitHub para ter a versão mais recente:
|
|
307
|
-
|
|
308
|
-
```bash
|
|
309
|
-
npm uninstall -g cdp-edge
|
|
310
|
-
npm install -g github:ricardosoli777/CDP-Edge-Premium
|
|
311
|
-
cdp-edge --version
|
|
312
|
-
```
|
|
313
|
-
|
|
314
|
-
### Erro: "cdp-edge não é reconhecido"
|
|
198
|
+
## 🗺️ GRAPHIFY — Navegando o Código
|
|
315
199
|
|
|
316
200
|
```bash
|
|
317
|
-
#
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
npm install -g github:ricardosoli777/CDP-Edge-Premium
|
|
201
|
+
/graphify . # gera o mapa
|
|
202
|
+
/graphify query "como funciona o quiz scoring?" # exploração BFS
|
|
203
|
+
/graphify query "nurture engine → meta audience" # exploração DFS
|
|
204
|
+
/graphify path "quiz_answers" "meta capi" # menor caminho
|
|
322
205
|
```
|
|
323
206
|
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
Execute o terminal como Administrador (Windows) ou use `sudo` (Mac/Linux).
|
|
327
|
-
|
|
328
|
-
### Erro: "Módulo não encontrado" (outros módulos)
|
|
329
|
-
|
|
330
|
-
```bash
|
|
331
|
-
npm cache clean --force
|
|
332
|
-
npm uninstall -g cdp-edge
|
|
333
|
-
npm install -g cdp-edge
|
|
334
|
-
```
|
|
335
|
-
|
|
336
|
-
---
|
|
337
|
-
|
|
338
|
-
## 🖱️ HUMAN-BEHAVIOR ENGINE (O MOTOR DE INTENÇÃO)
|
|
339
|
-
|
|
340
|
-
A joia da coroa do CDP Edge. Capturamos o que o usuário **sente** e **faz**, e não apenas onde ele clica.
|
|
341
|
-
|
|
342
|
-
### 🌡️ Engagement Scoring Engine (0-100)
|
|
343
|
-
Cada ação do usuário soma (ou subtrai) pontos em tempo real:
|
|
344
|
-
* **Scroll (25-90%)**: +5 a +15 pontos.
|
|
345
|
-
* **VSL Watch (25-100%)**: +10 a +50 pontos.
|
|
346
|
-
* **Copy Intent**: +20 pontos ao copiar cupons ou chaves PIX.
|
|
347
|
-
* **Form Interaction**: +10 pontos por campo preenchido.
|
|
348
|
-
* **Rage Click**: -10 pontos (sinal de frustração técnica).
|
|
349
|
-
* **Gatilho Hot Lead**: Ao atingir **80 pontos**, disparar `High_Intent_Lead` para as plataformas.
|
|
350
|
-
|
|
351
|
-
### 🎥 VSL & Video Tracker
|
|
352
|
-
Monitoramento nativo de retenção em vídeos YouTube e Vimeo sem necessidade de scripts externos pesados.
|
|
353
|
-
|
|
354
|
-
---
|
|
355
|
-
|
|
356
|
-
## 📞 SUPORTE
|
|
357
|
-
|
|
358
|
-
- **Documentação**: Verifique `CLAUDE.md` para padrões de desenvolvimento
|
|
359
|
-
- **Issues**: https://github.com/ricardosoli777/CDP-Edge-Premium/issues
|
|
360
|
-
- **Releases**: https://github.com/ricardosoli777/CDP-Edge-Premium/releases
|
|
207
|
+
> Changelog completo → [CHANGELOG.md](./CHANGELOG.md)
|
|
361
208
|
|
|
362
209
|
---
|
|
363
210
|
|
|
364
211
|
### **CDP Edge — By Rica Soares**
|
|
365
|
-
> "Dados sem inteligência são apenas ruído. No Quantum Tier, transformamos dados em ROAS."
|
|
212
|
+
> "Dados sem inteligência são apenas ruído. No Quantum Tier Enterprise, transformamos dados em ROAS."
|
|
366
213
|
|
|
367
214
|
© 2026 CDP Edge Premium. Todos os direitos reservados.
|
package/bin/cdp-edge.js
CHANGED
|
@@ -1,61 +1,71 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
|
|
3
|
-
/**
|
|
4
|
-
* CDP Edge CLI - Entry Point
|
|
5
|
-
* Sistema multi-agente para tracking digital Quantum Tier
|
|
6
|
-
*/
|
|
7
|
-
|
|
8
|
-
import
|
|
9
|
-
import
|
|
10
|
-
import {
|
|
11
|
-
import {
|
|
12
|
-
import {
|
|
13
|
-
import {
|
|
14
|
-
import {
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
.
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
.
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
.
|
|
41
|
-
.
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
.
|
|
46
|
-
.
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
.
|
|
51
|
-
.
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
.
|
|
56
|
-
.
|
|
57
|
-
.
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* CDP Edge CLI - Entry Point
|
|
5
|
+
* Sistema multi-agente para tracking digital Quantum Tier
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import fs from 'fs';
|
|
9
|
+
import path from 'path';
|
|
10
|
+
import { fileURLToPath } from 'url';
|
|
11
|
+
import { Command } from 'commander';
|
|
12
|
+
import { runSetupWizard } from '../dist/commands/setup.js';
|
|
13
|
+
import { runAnalyze } from '../dist/commands/analyze.js';
|
|
14
|
+
import { runServer } from '../dist/commands/server.js';
|
|
15
|
+
import { runValidate } from '../dist/commands/validate.js';
|
|
16
|
+
import { runInfra } from '../dist/commands/infra.js';
|
|
17
|
+
import { runInstall } from '../dist/commands/install.js';
|
|
18
|
+
|
|
19
|
+
// Ler versão do package.json
|
|
20
|
+
const __dirname = path.dirname(fileURLToPath(import.meta.url));
|
|
21
|
+
const packageJsonPath = path.join(__dirname, '..', 'package.json');
|
|
22
|
+
const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
|
|
23
|
+
const CDP_VERSION = packageJson.version;
|
|
24
|
+
|
|
25
|
+
const program = new Command();
|
|
26
|
+
|
|
27
|
+
program
|
|
28
|
+
.name('cdp-edge')
|
|
29
|
+
.description('CDP Edge Quantum Tier - Sistema multi-agente para tracking digital Cloudflare Native')
|
|
30
|
+
.version(CDP_VERSION);
|
|
31
|
+
|
|
32
|
+
// Comando padrão (wizard interativo)
|
|
33
|
+
program
|
|
34
|
+
.argument('[dir]', 'Diretório do projeto', '.')
|
|
35
|
+
.action(runSetupWizard);
|
|
36
|
+
|
|
37
|
+
// Comandos específicos
|
|
38
|
+
program
|
|
39
|
+
.command('setup [dir]')
|
|
40
|
+
.description('Configuração completa com wizard interativo')
|
|
41
|
+
.action(runSetupWizard);
|
|
42
|
+
|
|
43
|
+
program
|
|
44
|
+
.command('analyze <dir>')
|
|
45
|
+
.description('Analisa páginas e detecta eventos de tracking')
|
|
46
|
+
.action(runAnalyze);
|
|
47
|
+
|
|
48
|
+
program
|
|
49
|
+
.command('server <dir>')
|
|
50
|
+
.description('Gera apenas infraestrutura Cloudflare Workers + D1')
|
|
51
|
+
.action(runServer);
|
|
52
|
+
|
|
53
|
+
program
|
|
54
|
+
.command('validate <url>')
|
|
55
|
+
.description('Diagnóstico pós-deploy — verifica se o tracking está funcionando de ponta a ponta')
|
|
56
|
+
.option('--worker <url>', 'URL do Worker se diferente do site (ex: https://worker.meusite.workers.dev)')
|
|
57
|
+
.action(runValidate);
|
|
58
|
+
|
|
59
|
+
program
|
|
60
|
+
.command('infra')
|
|
61
|
+
.description('Mostra guia de setup de infraestrutura Cloudflare')
|
|
62
|
+
.action(runInfra);
|
|
63
|
+
|
|
64
|
+
program
|
|
65
|
+
.command('install [dir]')
|
|
66
|
+
.description('Instala o CDP Edge em um projeto cliente e habilita /cdp no Claude Code')
|
|
67
|
+
.option('-n, --name <name>', 'Nome do projeto')
|
|
68
|
+
.option('--cursor', 'Criar .cursorrules para Cursor IDE')
|
|
69
|
+
.action(runInstall);
|
|
70
|
+
|
|
71
|
+
program.parse(process.argv);
|