cdp-edge 2.0.4 → 2.0.5

package/dist/commands/install.js

@@ -32,7 +32,7 @@ function printBanner() {
   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.4'));
+  console.log(chalk.gray('  Customer Data Platform on the Edge · Global Edge Tracking · v2.0.5'));
   console.log('');
   console.log(chalk.gray('═'.repeat(68)));
   console.log('');

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.4'));
-  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/extracted-skill/tracking-events-generator/INTEGRACAO-COMPLETA.md

@@ -592,3 +592,92 @@ Para suporte, consulte:
 
 *CDP Edge Premium Tracking Intelligence - Integração Completa (Quantum Tier)*
 *Versão 1.0.0 - Atualizado em 2026-03-27*
+
+---
+
+## Pipeline de Melhoria Contínua Automática (Fase 5)
+
+A Fase 5 não adiciona novos eventos de tracking — ela fecha o ciclo de dados para que cada evento coletado melhore automaticamente a qualidade dos próximos.
+
+### Arquitetura do pipeline
+
+```
+Browser (cdpTrack.js)
+    │
+    └─ POST /track
+            │
+            ├─ [Auto-Enrich] Antes do dispatch Meta CAPI:
+            │       Worker consulta user_profiles por userId
+            │       → recupera email/fbp/fbc ausentes do perfil
+            │       → evento vai para Meta com Advanced Matching completo
+            │
+            ├─ [Dispatch Meta CAPI]
+            │       → Grava match_quality_log (has_email, has_fbp, etc.)
+            │
+            ├─ [LTV Prediction]
+            │       → Usa ltv_model_weights (se modelo treinado disponível)
+            │       → Fallback para heurística
+            │
+            └─ [D1 Writes]
+                    → leads, user_profiles, match_quality_log
+
+Cron semanal (Worker scheduled)
+    │
+    ├─ Treina regressão logística → ltv_model_weights (is_active=1)
+    │       → cached em KV para ~0ms no próximo /track
+    │
+    ├─ Analisa match_quality_log (janela 2h)
+    │       → email_rate < 40%   → alerta CallMeBot
+    │       → fbp_rate < 30%     → alerta CallMeBot
+    │       → composite < 45%    → alerta CallMeBot
+    │
+    ├─ Verifica experimentos A/B LTV
+    │       → variação bate controle por ≥5pp → auto-winner declarado
+    │       → alerta WhatsApp com prompt ativado
+    │
+    └─ Export Customer Match
+            → leads high_intent → GET /export/customer-match
+            → CSV para Google Ads (SHA-256 hashed)
+```
+
+### Novas tabelas D1 criadas na Fase 5
+
+| Tabela | Migration | Conteúdo |
+|---|---|---|
+| `ltv_model_weights` | `migrate-v7.sql` | Pesos do modelo treinado (trained_at, is_active, accuracy, weights_json) |
+| `match_quality_log` | `migrate-v7.sql` | Flags por evento: has_email, has_fbp, has_phone, has_fbc, was_email_recovered |
+
+**View:** `v_match_quality_24h` — agrega match quality das últimas 24h para consulta rápida.
+
+### Migration completa atualizada (incluindo Fase 5)
+
+```bash
+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
+wrangler d1 execute cdp-edge-db --file=schema-bidding.sql --remote
+wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote
+wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote
+wrangler d1 execute cdp-edge-db --file=schema-indexes.sql --remote
+wrangler d1 execute cdp-edge-db --file=migrate-v7.sql --remote
+```
+
+### Endpoints novos para monitoramento
+
+| Endpoint | O que monitora |
+|---|---|
+| `GET /api/fraud/stats` | Fraude 24h + qualidade de sinal |
+| `GET /api/segmentation/list` | Clusters ML ativos com métricas de LTV |
+| `GET /api/bidding/status` | Bids recomendados por segmento × plataforma |
+| `GET /api/ltv/ab-test/results` | Acurácia por variação de prompt LTV |
+| `GET /export/customer-match` | Export CSV de leads high-intent para Google Ads |
+
+### Impacto esperado no funil
+
+| Componente | Mecanismo | Resultado |
+|---|---|---|
+| Advanced Matching Meta | Auto-Enrich recupera email/fbp de sessões anteriores | EMQ sobe → atribuição mais precisa |
+| LTV Score | Modelo treinado em dados reais do funil | Bids mais precisos → menor CPA |
+| Match Quality Alerts | Degradação detectada automaticamente | Fix em horas, não em dias |
+| A/B Auto-Winner | Melhor prompt LTV ativado automaticamente | LTV scores mais precisos sem revisão manual |
+| Customer Match | Leads high-intent exportados semanalmente | Audiência Google sempre atualizada |