cdp-edge 1.21.0 → 1.21.1

package/extracted-skill/tracking-events-generator/agents/devops-agent.md

@@ -113,10 +113,21 @@ wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote
 
 # Fase 4: Fraud Detection
 wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote
+
+# Índices compostos de performance (queries D1)
+wrangler d1 execute cdp-edge-db --file=schema-indexes.sql --remote
+
+# Fase 5: LTV Model (regressão logística) + Match Quality Log
+wrangler d1 execute cdp-edge-db --file=migrate-v7.sql --remote
 ```
 
 Após cada migração: confirmar sucesso antes de prosseguir.
 
+> **Fase 5 cria duas tabelas críticas:**
+> - `ltv_model_weights` — pesos do modelo LTV treinado semanalmente pelo cron
+> - `match_quality_log` — registra flags de qualidade de dados (has_email, has_fbp, etc.) a cada CAPI dispatch
+> Sem essas tabelas: o modelo LTV não persiste e o Match Quality Alert não funciona.
+
 ---
 
 ## PROCEDURE `*rollback`

package/extracted-skill/tracking-events-generator/agents/intelligence-agent.md

@@ -306,6 +306,33 @@ async function checkApiDepreciations(env) {
 
 ---
 
+### MONITORAMENTO AUTOMÁTICO DE MATCH QUALITY (CRON SEMANAL)
+
+O Intelligence Agent monitora a qualidade dos dados enviados ao Meta CAPI a cada execução do cron.
+Os dados são lidos da tabela `match_quality_log` (populada automaticamente pelo Worker a cada dispatch).
+
+**Thresholds obrigatórios — alertar via CallMeBot se:**
+
+| Métrica | Threshold mínimo | Ação automática |
+|---|---|---|
+| `email_rate` | 40% dos eventos com email | Alerta ⚠️ — verificar Identity Graph |
+| `fbp_rate` | 30% dos eventos com cookie fbp | Alerta ⚠️ — verificar cdpTrack.js |
+| `composite_score` | 45% (email×0.4 + fbp×0.3 + phone×0.2 + fbc×0.1) | Alerta 🚨 CRÍTICO |
+
+**O cron semanal executa automaticamente (sem intervenção manual):**
+1. `_trainLtvModel(env)` — re-treina regressão logística com últimos 5000 leads do D1; pesos salvos em `ltv_model_weights` e cache KV invalidado
+2. `_autoDecideAbWinner(env)` — declara winner de A/B LTV se melhoria ≥ 5pp vs controle; alerta WhatsApp automático
+3. `_analyzeMatchQuality(env)` — analisa janela 2h; dispara alertas CallMeBot se abaixo dos thresholds
+4. `syncMetaCustomAudience(env)` — sincroniza leads high_intent com Meta Custom Audience
+
+**Auto-recuperação integrada ao dispatch:**
+- Antes de cada envio ao Meta CAPI, o Worker tenta enriquecer automaticamente o payload consultando o Identity Graph pelo `userId` (recupera email, fbp, fbc, phone ausentes)
+- Resultado de recuperação é logado em `match_quality_log.was_email_recovered`
+
+**Pré-requisito de infraestrutura:** `migrate-v7.sql` deve estar aplicada no D1 (tabelas `ltv_model_weights` + `match_quality_log`).
+
+---
+
 ### CHECK DE NOVOS PARÂMETROS DE EVENT MATCH QUALITY
 
 O Intelligence Agent DEVE buscar novos parâmetros que melhoram a nota de atribuição:

package/extracted-skill/tracking-events-generator/agents/master-orchestrator.md

@@ -1285,7 +1285,7 @@ Spawnar o **Intelligence Agent** para realizar auditoria completa da stack:
 
 **2. Infraestrutura Cloudflare**
 - `wrangler.toml` — bindings D1, KV, Queue, AI estão todos declarados
-- `schema.sql` e migrations — todas as fases (core, segmentation, bidding, ab-ltv, fraud) aplicadas
+- `schema.sql` e migrations — todas as fases aplicadas na ordem: core → segmentation → bidding → ab-ltv → fraud → schema-indexes → **migrate-v7** (LTV model + Match Quality)
 - Worker.js — endpoints ativos correspondem à arquitetura esperada
 
 **3. Conformidade e Qualidade de Sinal**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.21.0",
+  "version": "1.21.1",
   "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/schema-indexes.sql

@@ -46,13 +46,13 @@ CREATE INDEX IF NOT EXISTS idx_profiles_email_updated
 
 -- ── fraud_signals: dashboard e alertas ───────────────────────────────────────
 
--- handleFraudAlerts: filtra por ip + período
-CREATE INDEX IF NOT EXISTS idx_fraud_ip_created
-  ON fraud_signals(ip_address, created_at DESC);
+-- handleFraudAlerts: filtra por ip + período (coluna: detected_at)
+CREATE INDEX IF NOT EXISTS idx_fraud_ip_detected
+  ON fraud_signals(ip_address, detected_at DESC);
 
 -- handleFraudStats: fraud_score >= threshold ordenado por data
-CREATE INDEX IF NOT EXISTS idx_fraud_score_created
-  ON fraud_signals(fraud_score DESC, created_at DESC);
+CREATE INDEX IF NOT EXISTS idx_fraud_score_detected
+  ON fraud_signals(fraud_score DESC, detected_at DESC);
 
 -- ── ltv_ab_assignments: resultados de A/B test ───────────────────────────────
 
@@ -62,6 +62,6 @@ CREATE INDEX IF NOT EXISTS idx_ab_testid_class
 
 -- ── ml_segment_members: join com leads para bidding ─────────────────────────
 
--- handleBiddingRecommend: segment_id lookup
+-- handleBiddingRecommend: segment_id lookup (coluna: assigned_at)
 CREATE INDEX IF NOT EXISTS idx_seg_members_segid
-  ON ml_segment_members(segment_id, joined_at DESC);
+  ON ml_segment_members(cluster_id, assigned_at DESC);