cdp-edge 1.19.0 → 1.21.0

package/dist/commands/setup.js

@@ -1,138 +1,353 @@
-/**
- * Setup Wizard - Wrapper para invocar CDP Edge Skill
+/**
+ * CDP Edge Setup Wizard — Guiado e não-técnico
  *
- * O CLI é apenas um disparador. A skill (Master Orchestrator) faz tudo.
+ * Coleta os dados do projeto do cliente e gera:
+ *  • Comandos wrangler secret put prontos para copiar
+ *  • URLs de webhook com domínio preenchido
+ *  • Checklist de próximos passos para o agente
  */
 
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 import ora from 'ora';
+import { writeFileSync } from 'fs';
+import { join } from 'path';
 
 function printBanner() {
   console.log('');
-  console.log(chalk.white.bold('  CDP Edge Setup Wizard'));
-  console.log('');
-  console.log(chalk.cyan(' ██████╗██████╗ ██████╗     ███████╗██████╗  ██████╗ ███████╗'));
-  console.log(chalk.cyan('██╔════╝██╔══██╗██╔══██╗    ██╔════╝██╔══██╗██╔════╝ ██╔════╝'));
-  console.log(chalk.cyan('██║     ██║  ██║██████╔╝    █████╗  ██║  ██║██║  ███╗█████╗  '));
-  console.log(chalk.cyan('██║     ██║  ██║██╔═══╝     ██╔══╝  ██║  ██║██║   ██║██╔══╝  '));
-  console.log(chalk.cyan('╚██████╗██████╔╝██║         ███████╗██████╔╝╚██████╔╝███████╗'));
-  console.log(chalk.cyan(' ╚═════╝╚═════╝ ╚═╝         ╚══════╝╚═════╝  ╚═════╝╚══════╝'));
-  console.log('');
-  console.log(chalk.gray('  Customer Data Platform on the Edge · Global Edge Tracking · v2.0.3'));
-  console.log('');
-  console.log(chalk.gray('═'.repeat(68)));
+  console.log(chalk.cyan('  ╔═══════════════════════════════════════╗'));
+  console.log(chalk.cyan('  ║') + chalk.white.bold('      CDP Edge — Setup Wizard          ') + chalk.cyan('║'));
+  console.log(chalk.cyan('  ║') + chalk.gray('   Configuração Guiada de Tracking     ') + chalk.cyan('║'));
+  console.log(chalk.cyan('  ╚═══════════════════════════════════════╝'));
   console.log('');
 }
 
+function sep(label = '') {
+  if (label) {
+    console.log('\n' + chalk.gray('── ') + chalk.cyan.bold(label) + chalk.gray(' ' + '─'.repeat(Math.max(0, 40 - label.length))));
+  } else {
+    console.log(chalk.gray('─'.repeat(50)));
+  }
+}
+
 export async function runSetupWizard(dir = '.') {
   printBanner();
 
-  // === MENSAGEM INICIAL ===
+  console.log(chalk.cyan('  Vou te fazer algumas perguntas simples.'));
+  console.log(chalk.cyan('  Não precisa saber programar — é só preencher os dados.\n'));
+  console.log(chalk.gray('  Ao final, vou gerar todos os comandos prontos para instalar.\n'));
 
-  console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-  console.log(chalk.green.bold('  ✅ CDP Edge INSTALADO COM SUCESSO!'));
-  console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+  // ── PASSO 1: Dados do projeto ──────────────────────────────────────────────
+  sep('1. Dados do Projeto');
 
-  console.log(chalk.cyan('🎯 O Master Orchestrator controla todo o processo de criação.'));
-  console.log(chalk.cyan('   Ele vai:\n'));
-  console.log(chalk.cyan('   • Fazer as perguntas necessárias'));
-  console.log(chalk.cyan('   • Analisar suas páginas automaticamente'));
-  console.log(chalk.cyan('   • Chamar os agentes especialistas'));
-  console.log(chalk.cyan('   • Gerar todos os arquivos de tracking'));
-  console.log(chalk.cyan('   • Validar o código gerado\n'));
+  const projeto = await inquirer.prompt([
+    {
+      type:     'input',
+      name:     'domain',
+      message:  'Qual o domínio do site? (ex: meusite.com.br)',
+      validate: v => v.trim() ? true : 'Domínio é obrigatório',
+      filter:   v => v.trim().replace(/^https?:\/\//, '').replace(/\/$/, ''),
+    },
+    {
+      type:    'input',
+      name:    'projectName',
+      message: 'Nome do projeto (para identificação):',
+      default: answers => answers.domain.split('.')[0],
+    },
+    {
+      type:    'list',
+      name:    'productType',
+      message: 'Que tipo de produto você vende?',
+      choices: [
+        { name: 'Infoproduto / Curso Online',       value: 'infoproduto' },
+        { name: 'E-commerce físico',                value: 'ecommerce' },
+        { name: 'SaaS / Assinatura',                value: 'saas' },
+        { name: 'Serviço / Consultoria',            value: 'servico' },
+        { name: 'Lead Generation (captação)',       value: 'leadgen' },
+      ],
+    },
+  ]);
 
-  // === MENU DE OPÇÃO ===
+  // ── PASSO 2: Plataforma de vendas ──────────────────────────────────────────
+  sep('2. Plataforma de Vendas / Checkout');
 
-  const menu = await inquirer.prompt([
+  const { plataformas } = await inquirer.prompt([
     {
-      type: 'list',
-      name: 'action',
-      message: 'O que você deseja fazer?',
+      type:    'checkbox',
+      name:    'plataformas',
+      message: 'Quais plataformas de checkout você usa? (espaço para marcar)',
       choices: [
-        { name: '🚀 Iniciar Master Orchestrator (Configuração Completa)', value: 'start' },
-        { name: '📖 Ver documentação', value: 'docs' },
-        { name: '❌ Sair', value: 'exit' }
-      ]
-    }
+        { name: 'Hotmart',  value: 'hotmart',  checked: false },
+        { name: 'Kiwify',   value: 'kiwify',   checked: false },
+        { name: 'Ticto',    value: 'ticto',    checked: false },
+        { name: 'Eduzz',    value: 'eduzz',    checked: false },
+        { name: 'Stripe',   value: 'stripe',   checked: false },
+        { name: 'Nenhuma (apenas formulário de captação)', value: 'none', checked: false },
+      ],
+      validate: v => v.length > 0 ? true : 'Selecione pelo menos uma opção',
+    },
+  ]);
+
+  // ── PASSO 3: Plataformas de anúncios ───────────────────────────────────────
+  sep('3. Plataformas de Anúncios');
+
+  const { adsPlataformas } = await inquirer.prompt([
+    {
+      type:    'checkbox',
+      name:    'adsPlataformas',
+      message: 'Onde você faz anúncios? (espaço para marcar)',
+      choices: [
+        { name: 'Meta Ads (Facebook / Instagram)', value: 'meta',      checked: true },
+        { name: 'Google Ads / YouTube',            value: 'google',    checked: false },
+        { name: 'TikTok Ads',                      value: 'tiktok',    checked: false },
+        { name: 'Pinterest Ads',                   value: 'pinterest', checked: false },
+        { name: 'LinkedIn Ads',                    value: 'linkedin',  checked: false },
+      ],
+      validate: v => v.length > 0 ? true : 'Selecione pelo menos uma plataforma',
+    },
   ]);
 
-  if (menu.action === 'exit') {
-    console.log(chalk.yellow('\n👋 Até logo!\n'));
-    process.exit(0);
-  }
-
-  if (menu.action === 'docs') {
-    console.log(chalk.cyan('\n📚 Documentação:'));
-    console.log('   Acesse: ' + chalk.underline('docs/guia-cloudflare-iniciante.md'));
-    console.log('   Ou visite: ' + chalk.underline('github.com/ricardosoli777/CDP-Edge-Premium'));
-    return;
-  }
-
-  if (menu.action === 'start') {
-    const spinner = ora('Iniciando Master Orchestrator...').start();
-    await sleep(800);
-    spinner.succeed(chalk.green('Master Orchestrator iniciado!'));
-
-    console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-    console.log(chalk.cyan.bold('  ' + chalk.bold('🧠 MASTER ORCHESTRATOR ATIVO')));
-    console.log(chalk.cyan('  Controlando todo o fluxo de criação...'));
-    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
-
-    // === AQUI INVOCARIA A SKILL ===
-    //
-    // Em produção, aqui seria:
-    //
-    // import { spawnMasterOrchestrator } from '../skill-wrapper';
-    // await spawnMasterOrchestrator({ dir, platforms: [] });
-    //
-    // A skill faria:
-    // - Perguntar modo (guiado/livre)
-    // - Perguntar plataformas
-    // - Acessar projeto
-    // - Spawnar Page Analyzer Agent
-    // - Spawnar Browser Agent
-    // - Spawnar Meta Agent, Google Agent, TikTok Agent
-    // - Spawnar Server Agent
-    // - Gerar todos os arquivos
-    // - Validar
-
-    // === DEMONSTRAÇÃO DO QUE ACONTECE ===
-
-    console.log(chalk.yellow.bold('\n🔄 MODO DEMONSTRAÇÃO\n'));
-    console.log(chalk.gray('   Nesta versão, veja o fluxo que a skill executaria:\n'));
-
-    const demoFlow = [
-      '  [1] Perguntar: Como prefere configurar?',
-      '       → Guiado ou Livre',
-      '  [2] Perguntar: Quais plataformas de ads usa?',
-      '       → Meta, Google, TikTok, LinkedIn, Spotify...',
-      '  [3] Acessar: Seu projeto (GitHub ou local)',
-      '  [4] Page Analyzer: Analisar páginas',
-      '       → Detecta tipo de produto, nicho, formulários',
-      '  [5] Browser Agent: Gerar cdpTrack.js',
-      '       → Tracking SDK + micro-events',
-      '  [6] Meta Agent: Gerar Pixel + CAPI',
-      '  [7] Google Agent: Gerar GA4 + Google Ads',
-      '  [8] TikTok Agent: Gerar Pixel + Events API',
-      '  [9] Server Agent: Gerar Worker + D1',
-      '  [10] Validator: Auditar código gerado',
-      '  [11] Entregar: Arquivos no seu projeto',
-      '       → tracking.config.js, cdpTrack.js, worker.js, schema.sql'
-    ];
-
-    demoFlow.forEach(line => console.log(chalk.cyan(line)));
-
-    console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-    console.log(chalk.green.bold('  ✅ SETUP CONCLUÍDO!'));
-    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
-
-    console.log(chalk.cyan('📁 Arquivos gerados: ' + chalk.underline(dir || '.')));
-    console.log(chalk.gray('\nPróximos passos:'));
-    console.log('  1. Configure seus API tokens no Wrangler');
-    console.log('  2. Faça o deploy: ' + chalk.bold('wrangler deploy'));
-    console.log('  3. Configure o domínio no Cloudflare Dashboard');
+  // ── PASSO 4: Credenciais Meta ──────────────────────────────────────────────
+  const creds = {};
+
+  if (adsPlataformas.includes('meta')) {
+    sep('4a. Credenciais — Meta Ads');
+    console.log(chalk.gray('   Onde encontrar: Meta Events Manager → Configurações → Pixel\n'));
+
+    const meta = await inquirer.prompt([
+      {
+        type:     'input',
+        name:     'pixelId',
+        message:  'Meta Pixel ID:',
+        validate: v => v.trim() ? true : 'Pixel ID é obrigatório',
+        filter:   v => v.trim(),
+      },
+      {
+        type:     'password',
+        name:     'accessToken',
+        message:  'Meta Access Token (CAPI):',
+        mask:     '*',
+        validate: v => v.trim() ? true : 'Access Token é obrigatório',
+      },
+      {
+        type:    'input',
+        name:    'testCode',
+        message: 'Meta Test Event Code (opcional, para homologação):',
+        default: '',
+        filter:  v => v.trim(),
+      },
+    ]);
+    creds.meta = meta;
+  }
+
+  if (adsPlataformas.includes('google')) {
+    sep('4b. Credenciais — Google Analytics 4');
+    console.log(chalk.gray('   Onde encontrar: GA4 → Admin → Data Streams → Measurement Protocol\n'));
+
+    const google = await inquirer.prompt([
+      {
+        type:     'input',
+        name:     'measurementId',
+        message:  'GA4 Measurement ID (G-XXXXXXXX):',
+        validate: v => /^G-[A-Z0-9]+$/i.test(v.trim()) ? true : 'Formato: G-XXXXXXXX',
+        filter:   v => v.trim().toUpperCase(),
+      },
+      {
+        type:     'password',
+        name:     'apiSecret',
+        message:  'GA4 API Secret:',
+        mask:     '*',
+        validate: v => v.trim() ? true : 'API Secret é obrigatório',
+      },
+    ]);
+    creds.google = google;
+  }
+
+  if (adsPlataformas.includes('tiktok')) {
+    sep('4c. Credenciais — TikTok');
+    console.log(chalk.gray('   Onde encontrar: TikTok Events Manager → Pixel → Detalhes\n'));
+
+    const tiktok = await inquirer.prompt([
+      {
+        type:     'input',
+        name:     'pixelId',
+        message:  'TikTok Pixel ID:',
+        validate: v => v.trim() ? true : 'Pixel ID é obrigatório',
+        filter:   v => v.trim(),
+      },
+      {
+        type:     'password',
+        name:     'accessToken',
+        message:  'TikTok Access Token:',
+        mask:     '*',
+        validate: v => v.trim() ? true : 'Access Token é obrigatório',
+      },
+    ]);
+    creds.tiktok = tiktok;
+  }
+
+  // ── PASSO 5: Alertas WhatsApp ──────────────────────────────────────────────
+  sep('5. Alertas WhatsApp (opcional)');
+  console.log(chalk.gray('   Receba alertas de erros e match quality direto no WhatsApp.\n'));
+
+  const { wantsWhatsapp } = await inquirer.prompt([
+    {
+      type:    'confirm',
+      name:    'wantsWhatsapp',
+      message: 'Deseja ativar alertas via WhatsApp?',
+      default: true,
+    },
+  ]);
+
+  let whatsapp = {};
+  if (wantsWhatsapp) {
+    console.log(chalk.gray('\n   Como configurar: acesse callmebot.com e adicione o bot no WhatsApp.'));
+    console.log(chalk.gray('   Envie "I allow callmebot to send me messages" para +34 644 35 78 48\n'));
+
+    whatsapp = await inquirer.prompt([
+      {
+        type:     'input',
+        name:     'phone',
+        message:  'Seu número com DDI (ex: +5511999999999):',
+        validate: v => /^\+\d{10,15}$/.test(v.trim()) ? true : 'Formato: +5511999999999',
+        filter:   v => v.trim(),
+      },
+      {
+        type:     'password',
+        name:     'apiKey',
+        message:  'CallMeBot API Key:',
+        mask:     '*',
+        validate: v => v.trim() ? true : 'API Key é obrigatória',
+      },
+    ]);
+  }
+
+  // ── GERAÇÃO DOS OUTPUTS ────────────────────────────────────────────────────
+  const spinner = ora('Gerando configurações...').start();
+  await sleep(600);
+  spinner.succeed('Configurações geradas!');
+
+  const domain = projeto.domain;
+
+  // Monta lista de secrets
+  const secrets = [];
+
+  if (creds.meta) {
+    secrets.push({ key: 'META_PIXEL_ID',      value: creds.meta.pixelId,      platform: 'Meta' });
+    secrets.push({ key: 'META_ACCESS_TOKEN',  value: creds.meta.accessToken,  platform: 'Meta' });
+    if (creds.meta.testCode) {
+      secrets.push({ key: 'META_TEST_CODE',   value: creds.meta.testCode,     platform: 'Meta (homologação)' });
+    }
+  }
+
+  if (creds.google) {
+    secrets.push({ key: 'GA4_MEASUREMENT_ID', value: creds.google.measurementId, platform: 'Google' });
+    secrets.push({ key: 'GA4_API_SECRET',     value: creds.google.apiSecret,     platform: 'Google' });
+  }
+
+  if (creds.tiktok) {
+    secrets.push({ key: 'TIKTOK_PIXEL_ID',      value: creds.tiktok.pixelId,     platform: 'TikTok' });
+    secrets.push({ key: 'TIKTOK_ACCESS_TOKEN',  value: creds.tiktok.accessToken, platform: 'TikTok' });
   }
+
+  if (whatsapp.phone) {
+    secrets.push({ key: 'CALLMEBOT_PHONE',   value: whatsapp.phone,  platform: 'WhatsApp' });
+    secrets.push({ key: 'CALLMEBOT_API_KEY', value: whatsapp.apiKey, platform: 'WhatsApp' });
+  }
+
+  secrets.push({ key: 'SITE_DOMAIN', value: domain, platform: 'Worker' });
+
+  // Webhooks
+  const webhookUrls = {};
+  const webhookSecrets = [];
+  if (plataformas.includes('hotmart')) {
+    webhookUrls.hotmart = `https://${domain}/webhook/hotmart`;
+    webhookSecrets.push({ key: 'WEBHOOK_SECRET_HOTMART', platform: 'Hotmart', note: 'Gere uma senha forte qualquer' });
+  }
+  if (plataformas.includes('kiwify')) {
+    webhookUrls.kiwify = `https://${domain}/webhook/kiwify`;
+    webhookSecrets.push({ key: 'WEBHOOK_SECRET_KIWIFY', platform: 'Kiwify', note: 'Gere uma senha forte qualquer' });
+  }
+  if (plataformas.includes('ticto')) {
+    webhookUrls.ticto = `https://${domain}/webhook/ticto`;
+    webhookSecrets.push({ key: 'WEBHOOK_SECRET_TICTO', platform: 'Ticto', note: 'Chave HMAC configurada no painel Ticto' });
+  }
+
+  // ── EXIBIR RESULTADO ───────────────────────────────────────────────────────
+  console.log('\n');
+  sep('CONFIGURAÇÃO PRONTA');
+
+  console.log(chalk.green.bold('\n  Projeto: ') + chalk.white(projeto.projectName));
+  console.log(chalk.green.bold('  Domínio: ') + chalk.white(domain));
+  console.log(chalk.green.bold('  Produto: ') + chalk.white(projeto.productType));
+  console.log(chalk.green.bold('  Ads:     ') + chalk.white(adsPlataformas.join(', ')));
+
+  // Comandos de secrets
+  sep('Comandos para configurar os secrets');
+  console.log(chalk.gray('  Execute dentro da pasta server-edge-tracker:\n'));
+
+  for (const s of secrets) {
+    const masked = s.value.length > 4 ? s.value.slice(0, 4) + '*'.repeat(Math.min(s.value.length - 4, 8)) : '****';
+    console.log(chalk.cyan(`  wrangler secret put ${s.key}`));
+    console.log(chalk.gray(`  # ${s.platform} — valor: ${masked}\n`));
+  }
+
+  if (webhookSecrets.length > 0) {
+    console.log(chalk.yellow('  # Secrets de webhook (gere senhas e configure abaixo + no painel da plataforma):'));
+    for (const ws of webhookSecrets) {
+      console.log(chalk.cyan(`  wrangler secret put ${ws.key}`));
+      console.log(chalk.gray(`  # ${ws.platform}: ${ws.note}\n`));
+    }
+  }
+
+  // URLs de webhook
+  if (Object.keys(webhookUrls).length > 0) {
+    sep('URLs de Webhook para configurar nas plataformas');
+    for (const [plat, url] of Object.entries(webhookUrls)) {
+      console.log(chalk.green.bold(`  ${plat.charAt(0).toUpperCase() + plat.slice(1)}:`));
+      console.log(chalk.white(`    ${url}\n`));
+    }
+  }
+
+  // Checklist
+  sep('Próximos passos');
+  const steps = [
+    'Executar todos os wrangler secret put acima',
+    'Executar as migrations D1 (schema.sql → migrate-v7.sql)',
+    'Executar: wrangler deploy',
+    ...(Object.keys(webhookUrls).length > 0 ? ['Configurar as URLs de webhook nas plataformas de venda'] : []),
+    'Configurar Worker Route no Cloudflare: ' + domain + '/*',
+    'Testar o endpoint: https://' + domain + '/health',
+    ...(adsPlataformas.includes('meta') && creds.meta?.testCode ? ['Testar eventos no Meta Events Manager com o Test Event Code'] : []),
+  ];
+
+  steps.forEach((step, i) => {
+    console.log(chalk.cyan(`  [${i + 1}] `) + chalk.white(step));
+  });
+
+  // Salvar config (sem tokens reais)
+  const configOutput = {
+    generatedAt:  new Date().toISOString(),
+    domain,
+    projectName:  projeto.projectName,
+    productType:  projeto.productType,
+    adsPlataformas,
+    checkoutPlataformas: plataformas,
+    webhookUrls,
+    secretKeys:   secrets.map(s => s.key),
+    whatsappAlertsEnabled: !!whatsapp.phone,
+  };
+
+  const outputPath = join(dir, 'cdp-edge-setup.json');
+  try {
+    writeFileSync(outputPath, JSON.stringify(configOutput, null, 2), 'utf8');
+    console.log(chalk.gray(`\n  Configuração salva em: ${outputPath} (sem tokens)\n`));
+  } catch {
+    // não crítico se não conseguir salvar
+  }
+
+  sep();
+  console.log(chalk.green.bold('\n  Setup concluído! Passe os comandos acima para o agente instalar.\n'));
 }
 
 function sleep(ms) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.19.0",
+  "version": "1.21.0",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",

package/server-edge-tracker/migrate-v7.sql

@@ -0,0 +1,64 @@
+-- CDP Edge — Migration v7
+-- Tabelas para: LTV Model (regressão logística) + Match Quality Log
+-- Idempotente: todos os CREATE usam IF NOT EXISTS
+
+-- ── LTV Model Weights ─────────────────────────────────────────────────────────
+-- Armazena os pesos treinados pelo cron semanal de regressão logística.
+-- O Worker carrega via KV (TTL 7 dias) — query D1 apenas se KV miss.
+CREATE TABLE IF NOT EXISTS ltv_model_weights (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  trained_at   TEXT    NOT NULL DEFAULT (datetime('now')),
+  version      INTEGER NOT NULL DEFAULT 1,
+  is_active    INTEGER NOT NULL DEFAULT 0,
+  sample_size  INTEGER NOT NULL DEFAULT 0,
+  positive_rate REAL,           -- % de samples com label=1 (compra)
+  accuracy     REAL,            -- acurácia no conjunto de treino
+  weights_json TEXT    NOT NULL  -- JSON: {"bias": n, "features": {"utm_fb": w, ...}}
+);
+
+CREATE INDEX IF NOT EXISTS idx_ltv_weights_active  ON ltv_model_weights(is_active);
+CREATE INDEX IF NOT EXISTS idx_ltv_weights_trained ON ltv_model_weights(trained_at DESC);
+
+-- ── Match Quality Log ─────────────────────────────────────────────────────────
+-- Registra a qualidade dos dados enviados ao Meta CAPI por evento.
+-- Sem PII — apenas flags booleanos.
+CREATE TABLE IF NOT EXISTS match_quality_log (
+  id                   INTEGER PRIMARY KEY AUTOINCREMENT,
+  logged_at            TEXT    NOT NULL DEFAULT (datetime('now')),
+  event_name           TEXT    NOT NULL,
+  has_email            INTEGER NOT NULL DEFAULT 0,
+  has_phone            INTEGER NOT NULL DEFAULT 0,
+  has_fbp              INTEGER NOT NULL DEFAULT 0,
+  has_fbc              INTEGER NOT NULL DEFAULT 0,
+  has_external_id      INTEGER NOT NULL DEFAULT 0,
+  was_email_recovered  INTEGER NOT NULL DEFAULT 0,  -- recuperado do Identity Graph
+  was_utm_restored     INTEGER NOT NULL DEFAULT 0   -- via UTM Resurrection
+);
+
+CREATE INDEX IF NOT EXISTS idx_mq_logged ON match_quality_log(logged_at DESC);
+CREATE INDEX IF NOT EXISTS idx_mq_event  ON match_quality_log(event_name, logged_at DESC);
+
+-- ── View: Match Quality Dashboard (últimas 24h) ───────────────────────────────
+CREATE VIEW IF NOT EXISTS v_match_quality_24h AS
+SELECT
+  COUNT(*)                                                          AS total_events,
+  ROUND(AVG(has_email)       * 100, 1)                             AS email_rate_pct,
+  ROUND(AVG(has_phone)       * 100, 1)                             AS phone_rate_pct,
+  ROUND(AVG(has_fbp)         * 100, 1)                             AS fbp_rate_pct,
+  ROUND(AVG(has_fbc)         * 100, 1)                             AS fbc_rate_pct,
+  ROUND(AVG(has_external_id) * 100, 1)                             AS ext_id_rate_pct,
+  ROUND(AVG(was_email_recovered) * 100, 1)                         AS email_recovered_pct,
+  ROUND(AVG(was_utm_restored) * 100, 1)                            AS utm_restored_pct,
+  -- Score composto: email(40%) + fbp(30%) + phone(20%) + fbc(10%)
+  ROUND((AVG(has_email)*0.4 + AVG(has_fbp)*0.3 + AVG(has_phone)*0.2 + AVG(has_fbc)*0.1) * 100, 1) AS composite_score_pct
+FROM match_quality_log
+WHERE logged_at >= datetime('now', '-24 hours');
+
+-- ── ALTER: colunas de auditoria em ltv_ab_tests ───────────────────────────────
+-- Adiciona auto_decided_at se ainda não existir (SQLite não tem IF NOT EXISTS em ALTER)
+-- Protegido por trigger-style: INSERT OR IGNORE não se aplica a ALTER, então usamos
+-- um approach de criação de tabela auxiliar que faz nada se a coluna já existir.
+-- A abordagem mais segura no Cloudflare D1 é tentar e ignorar o erro no app.
+-- Aqui deixamos comentado — o worker.js já lida com campos opcionais:
+-- ALTER TABLE ltv_ab_tests ADD COLUMN auto_decided_at TEXT;
+-- ALTER TABLE ltv_ab_tests ADD COLUMN auto_decided_reason TEXT;

package/server-edge-tracker/modules/dispatch/meta.js

@@ -5,8 +5,17 @@
 
 import { sha256, normalizePhone, normalizeCity } from '../utils.js';
 import { logApiFailure } from '../db.js';
+import { logMatchQuality, autoEnrichPayload } from '../ml/matchquality.js';
 
 export async function sendMetaCapi(env, eventName, payload, request, ctx) {
+  // Auto-enriquecer payload com dados do Identity Graph antes do envio
+  let recovered = { email: false, utm: false };
+  if (env.DB && payload) {
+    const enriched  = await autoEnrichPayload(env, payload);
+    payload         = enriched.payload;
+    recovered       = enriched.recovered;
+  }
+
   const {
     email, phone, firstName, lastName,
     city, state, country,
@@ -69,6 +78,13 @@ export async function sendMetaCapi(env, eventName, payload, request, ctx) {
     requestBody.test_event_code = env.META_TEST_CODE;
   }
 
+  // Logar match quality em background (não bloqueia dispatch)
+  if (env.DB && ctx) {
+    ctx.waitUntil(logMatchQuality(env.DB, eventName, payload, recovered));
+  } else if (env.DB) {
+    logMatchQuality(env.DB, eventName, payload, recovered).catch(() => {});
+  }
+
   const endpoint = `https://graph.facebook.com/v22.0/${env.META_PIXEL_ID}/events`;
 
   try {