cdp-edge 2.5.3 → 2.5.5

package/docs/installation.md

@@ -1,155 +0,0 @@
-# CDP Edge — Instalação em Projetos de Clientes
-
-Como integrar o CDP Edge em qualquer projeto para que Claude Code, VS Code, Cursor e outras IDEs com IA o reconheçam automaticamente.
-
----
-
-## Estrutura recomendada
-
-```
-meu-projeto-cliente/          ← abrir esta pasta no Claude Code / VS Code
-├── CLAUDE.md                 ← ⭐ faz o Claude Code ativar o CDP Edge automaticamente
-├── .cursorrules              ← (opcional) para Cursor IDE
-├── cdp-edge/                 ← CDP Edge instalado aqui
-│   ├── extracted-skill/
-│   ├── server-edge-tracker/
-│   ├── templates/
-│   └── docs/
-├── src/                      ← código do projeto do cliente
-└── ...
-```
-
----
-
-## Passo 1 — Instalar o CDP Edge na pasta do projeto
-
-```bash
-# Dentro da pasta do projeto do cliente:
-cd meu-projeto-cliente
-
-# Opção A — clonar o CDP Edge como subpasta
-git clone https://github.com/ricardosoli777/CDP-Edge-Premium cdp-edge
-
-# Opção B — copiar manualmente
-# Copiar a pasta CDP-Edge inteira e renomear para cdp-edge/
-```
-
----
-
-## Passo 2 — Criar o CLAUDE.md na raiz do projeto
-
-Copiar o template de ativação:
-
-```bash
-cp cdp-edge/templates/install/CLAUDE.md ./CLAUDE.md
-```
-
-Editar o `CLAUDE.md` e substituir `[NOME DO PROJETO]` pelo nome real do projeto.
-
-**Por que isso funciona:**
-O Claude Code lê o `CLAUDE.md` da raiz do diretório aberto automaticamente. Quando encontra a instrução de leitura do `master-orchestrator.md`, ativa o sistema imediatamente na abertura da sessão.
-
----
-
-## Passo 3 — Abrir o projeto no Claude Code
-
-```bash
-# Na pasta do projeto (não dentro do cdp-edge):
-claude .
-```
-
-O Claude Code vai:
-1. Ler o `CLAUDE.md` da raiz
-2. Encontrar a instrução de ativação do CDP Edge
-3. Carregar o `master-orchestrator.md`
-4. Exibir a mensagem de boas-vindas automaticamente
-
----
-
-## Para VS Code com extensão Claude
-
-O mesmo mecanismo funciona. O `CLAUDE.md` é lido pela extensão Claude Code no VS Code quando você abre a pasta do projeto.
-
-```bash
-code meu-projeto-cliente/
-```
-
----
-
-## Para Cursor IDE
-
-Criar adicionalmente um `.cursorrules` na raiz:
-
-```bash
-cp cdp-edge/templates/install/CLAUDE.md .cursorrules
-```
-
-O Cursor lê `.cursorrules` automaticamente e aplica as instruções ao agente AI.
-
----
-
-## Para qualquer outra IDE com AI
-
-Qualquer IDE que suporte arquivos de instrução (`.aidioms`, `system-prompt.md`, etc.) pode usar o mesmo conteúdo do `CLAUDE.md` adaptado para o formato da IDE.
-
----
-
-## Verificar se funcionou
-
-Ao abrir o projeto no Claude Code, você deve ver imediatamente:
-
-```
-👋 Olá! Bem-vindo ao CDP Edge — Quantum Tracking.
-
-Sou o seu Orquestrador de Rastreamento. Vou configurar toda a
-infraestrutura de tracking server-side para o seu projeto...
-```
-
-Se não aparecer automaticamente, digitar:
-
-```
-/cdp
-```
-
-ou simplesmente:
-
-```
-ative o master orchestrator do cdp edge
-```
-
----
-
-## Se o CDP Edge estiver em um caminho diferente
-
-Editar o `CLAUDE.md` na raiz e ajustar o path:
-
-```markdown
-<!-- Padrão: -->
-Leia o arquivo: `cdp-edge/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-
-<!-- Se instalado em outro lugar: -->
-Leia o arquivo: `ferramentas/cdp/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-```
-
----
-
-## Estrutura de múltiplos projetos (workspace compartilhado)
-
-Se você trabalha com vários clientes e quer uma instalação única do CDP Edge:
-
-```
-workspace/
-├── cdp-edge/                 ← instalação única compartilhada
-├── cliente-1/
-│   ├── CLAUDE.md             ← aponta para ../cdp-edge/...
-│   └── src/
-├── cliente-2/
-│   ├── CLAUDE.md             ← aponta para ../cdp-edge/...
-│   └── src/
-```
-
-No `CLAUDE.md` de cada cliente, usar path relativo:
-
-```markdown
-Leia o arquivo: `../cdp-edge/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-```

package/docs/quick-start.md

@@ -1,185 +0,0 @@
-# CDP Edge — Quick Start
-> Do zero ao primeiro evento em produção.
-
----
-
-## Pré-requisitos
-
-| Ferramenta | Instalar |
-|---|---|
-| Node.js 18+ | nodejs.org |
-| Wrangler CLI | `npm install -g wrangler` |
-| Conta Cloudflare | cloudflare.com (plano gratuito suficiente) |
-| Conta Meta (Pixel + token CAPI) | business.facebook.com |
-
----
-
-## 1. Autenticar no Cloudflare
-
-```bash
-wrangler login
-```
-
----
-
-## 2. Criar o banco D1
-
-```bash
-wrangler d1 create cdp-edge-db
-```
-
-Copie o `database_id` retornado e cole no `wrangler.toml`:
-
-```toml
-[[d1_databases]]
-binding      = "DB"
-database_name = "cdp-edge-db"
-database_id  = "COLE_O_ID_AQUI"
-```
-
----
-
-## 3. Aplicar o schema
-
-```bash
-cd server-edge-tracker
-
-wrangler d1 execute cdp-edge-db --file=schema.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v2.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v3.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v4.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v5.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
-```
-
----
-
-## 4. Configurar secrets
-
-```bash
-wrangler secret put META_ACCESS_TOKEN
-wrangler secret put GA4_API_SECRET
-wrangler secret put TIKTOK_ACCESS_TOKEN
-```
-
-Para WhatsApp CTWA (opcional):
-```bash
-wrangler secret put WA_WEBHOOK_VERIFY_TOKEN
-wrangler secret put WHATSAPP_TOKEN
-wrangler secret put WHATSAPP_PHONE_NUMBER_ID
-```
-
----
-
-## 5. Atualizar variáveis públicas no wrangler.toml
-
-```toml
-[vars]
-META_PIXEL_ID      = "SEU_PIXEL_ID"
-GA4_MEASUREMENT_ID = "G-XXXXXXXXXX"
-TIKTOK_PIXEL_ID    = "CXXXXXXXXXXXXXXX"
-SITE_DOMAIN        = "seudominio.com.br"
-```
-
----
-
-## 6. Deploy
-
-```bash
-wrangler deploy
-```
-
-O Worker ficará disponível em:
-```
-https://server-edge-tracker.SEU-USUARIO.workers.dev
-```
-
----
-
-## 7. Testar o Worker
-
-```bash
-# Health check
-curl https://server-edge-tracker.SEU-USUARIO.workers.dev/health
-
-# Evento de teste
-curl -X POST https://server-edge-tracker.SEU-USUARIO.workers.dev/track \
-  -H "Content-Type: application/json" \
-  -d '{
-    "event": "PageView",
-    "url": "https://seudominio.com.br/",
-    "email": "teste@exemplo.com"
-  }'
-```
-
-Resposta esperada: `{"success":true}`
-
----
-
-## 8. Instalar o SDK no site
-
-```html
-<!-- No <head> de todas as páginas -->
-<script>
-  window.CDP_CONFIG = {
-    endpoint: 'https://server-edge-tracker.SEU-USUARIO.workers.dev/track',
-    pixelId: 'SEU_PIXEL_ID'
-  };
-</script>
-<script src="/js/cdpTrack.js" type="module" async></script>
-```
-
-O SDK inicializa automaticamente e dispara `PageView` ao carregar.
-
----
-
-## 9. Verificar no Meta Events Manager
-
-```
-Meta Business Suite
-  → Gerenciador de Eventos
-  → Seu Pixel
-  → Atividade de Teste
-  → Filtrar por "Servidor"
-```
-
-Você deve ver o `PageView` chegando com `action_source: website`.
-
----
-
-## 10. (Opcional) Conectar domínio próprio
-
-Para máxima eficácia (cookie first-party no domínio do cliente):
-
-```
-Cloudflare Dashboard → DNS → Add record
-  Type:   CNAME
-  Name:   track
-  Target: server-edge-tracker.SEU-USUARIO.workers.dev
-  Proxy:  ✅ (nuvem laranja)
-```
-
-Adicionar ao `wrangler.toml`:
-```toml
-[[routes]]
-pattern   = "track.seudominio.com.br/*"
-zone_name = "seudominio.com.br"
-```
-
-```bash
-wrangler deploy
-```
-
-Ver detalhes: `agents/domain-setup-agent.md`
-
----
-
-## Próximos passos
-
-| O que fazer | Onde está |
-|---|---|
-| Configurar WhatsApp CTWA | `agents/whatsapp-ctwa-setup-agent.md` |
-| Ativar R2 audit log | `agents/r2-setup-agent.md` |
-| Configurar gateways de pagamento | `agents/webhook-agent.md` |
-| Ver todos os eventos disponíveis | `docs/events-reference.md` |
-| Ver API do SDK browser | `docs/sdk-reference.md` |