# 📝 Sistema de Textos de Rodapé - Afiliados

## 🎯 Visão Geral

Sistema completo para gerenciar textos personalizados que são exibidos ao final dos links de afiliados (Amazon, Mercado Livre, Shopee).

---

## ✨ Funcionalidades

### 1. **Textos Gerais e Específicos**
- ✅ **Gerais**: Exibidos em todas as plataformas
- ✅ **Específicos**: Apenas na plataforma selecionada (Amazon, Mercado Livre, Shopee)

### 2. **Ordenação Inteligente**
- ✅ Textos específicos aparecem **primeiro**
- ✅ Depois vêm os textos gerais
- ✅ Campo `order` define a sequência dentro de cada grupo

### 3. **Ativar/Desativar**
- ✅ Desative temporariamente sem excluir
- ✅ Toggle rápido na listagem
- ✅ Ideal para testes A/B

### 4. **CRUD Completo**
- ✅ Criar, Editar, Excluir
- ✅ Interface moderna e intuitiva
- ✅ Preview em tempo real

---

## 🔧 Como Usar

### **Acessar o Sistema**
```
URL: /admin/affiliate-footers
```

### **Criar Novo Texto**

1. Clique em **"Novo Texto"**
2. Preencha os campos:
   - **Título**: Identificação interna (ex: "Convite WhatsApp")
   - **Conteúdo**: Texto que será exibido (pode usar emojis e quebras de linha)
   - **Plataforma**: Selecione onde será exibido
   - **Ordem**: Número para sequência (menor = primeiro)
   - **Ativo**: Marque para ativar

3. Clique em **"Salvar Texto"**

---

## 📊 Exemplo Prático

### **Configuração:**

| Título | Conteúdo | Plataforma | Ordem | Ativo |
|--------|----------|------------|-------|-------|
| Convite Prime | "⭐ Se torne Prime..." | Amazon | 1 | ✅ |
| Grupo WhatsApp | "🔍 Grupos de..." | Todas | 99 | ✅ |

### **Resultado na Amazon:**

```
Notebook Gamer

De: R̶$̶ ̶4̶.̶9̶9̶9̶
Por: R$ 3.499

Compre aqui: https://amzn.to/xxxxx

⭐ Se torne Prime e aproveite esse desconto!
👉 https://amazon.com.br/prime

🔍 Grupos de WhatsApp e Telegram:
https://minhaurl.com
```

**Ordem de exibição:**
1. Texto específico Amazon (ordem 1)
2. Texto geral (ordem 99)

---

## 🎨 Plataformas Suportadas

| Plataforma | Status | Identificador |
|------------|--------|---------------|
| **Todas** | ✅ Ativo | `all` |
| **Amazon** | ✅ Ativo | `amazon` |
| **Mercado Livre** | 🚧 Preparado | `mercadolivre` |
| **Shopee** | 🚧 Preparado | `shopee` |

---

## 📝 Exemplos de Textos

### **Texto Geral (todas plataformas):**
```
🔍 Grupos de WhatsApp e Telegram:
https://minhaurl.com

📢 Fique por dentro das melhores ofertas!
```

### **Texto Amazon (específico):**
```
⭐ Se torne Prime e aproveite:
✅ Frete grátis
✅ Descontos exclusivos
✅ Prime Video incluído

👉 https://amazon.com.br/prime
```

### **Texto Mercado Livre (específico):**
```
💎 Seja Meli+ e ganhe:
✅ Frete grátis em milhões de produtos
✅ Cashback em compras
✅ Descontos exclusivos

👉 https://mercadolivre.com.br/meli-mais
```

---

## 🔄 Fluxo de Exibição

```
1. Usuário busca produto na Amazon
   ↓
2. Sistema gera texto do produto
   ↓
3. Busca footers ativos:
   - Footers específicos 'amazon'
   - Footers gerais 'all'
   ↓
4. Ordena:
   - Específicos primeiro (por order ASC)
   - Gerais depois (por order ASC)
   ↓
5. Adiciona ao final do texto
   ↓
6. Retorna texto completo
```

---

## 💾 Estrutura do Banco

### **Tabela: `affiliate_footers`**

| Campo | Tipo | Descrição |
|-------|------|-----------|
| id | bigint | ID único |
| title | string | Título/descrição (interno) |
| content | text | Conteúdo do texto |
| platform | enum | `all`, `amazon`, `mercadolivre`, `shopee` |
| order | integer | Ordem de exibição (0-999) |
| active | boolean | Ativo/Inativo |
| created_at | timestamp | Data de criação |
| updated_at | timestamp | Data de atualização |

---

## 🛠️ Métodos do Model

### **AffiliateFooter::getForPlatform($platform)**
```php
// Retorna footers ativos ordenados para uma plataforma
$footers = AffiliateFooter::getForPlatform('amazon');
```

### **AffiliateFooter::formatForPlatform($platform)**
```php
// Retorna texto formatado pronto para exibição
$text = AffiliateFooter::formatForPlatform('amazon');
// "\n\n⭐ Se torne Prime...\n\n🔍 Grupos de WhatsApp...\n\n"
```

### **Scopes Disponíveis:**
```php
// Apenas ativos
AffiliateFooter::active()->get();

// Para uma plataforma
AffiliateFooter::forPlatform('amazon')->get();

// Ordenados
AffiliateFooter::ordered()->get();

// Combinados
AffiliateFooter::active()->forPlatform('amazon')->ordered()->get();
```

---

## 🔧 Como Funciona no Controller

### **AmazonAffiliateController.php**

```php
private function formatProductText($product, $originalUrl = null)
{
    $text = $product['title'] . "\n\n";
    
    // ... preços, cupons, etc ...
    
    $text .= "Compre aqui: " . $linkToUse;
    
    // ✨ Adicionar footers
    $footers = AffiliateFooter::formatForPlatform('amazon');
    if ($footers) {
        $text .= $footers;
    }
    
    return $text;
}
```

---

## 📂 Arquivos Criados

### **Migration:**
```
database/migrations/2025_10_13_095546_create_affiliate_footers_table.php
```

### **Model:**
```
app/Models/AffiliateFooter.php
```

### **Controller:**
```
app/Http/Controllers/AffiliateFooterController.php
```

### **Views:**
```
resources/views/admin/affiliate-footers/
├── index.blade.php  (Listagem)
├── create.blade.php (Criar)
└── edit.blade.php   (Editar)
```

### **Seeder:**
```
database/seeders/AffiliateFooterSeeder.php
```

---

## 🎯 Rotas

| Método | URL | Ação | Nome |
|--------|-----|------|------|
| GET | `/admin/affiliate-footers` | Listar | `affiliate-footers.index` |
| GET | `/admin/affiliate-footers/create` | Criar | `affiliate-footers.create` |
| POST | `/admin/affiliate-footers` | Salvar | `affiliate-footers.store` |
| GET | `/admin/affiliate-footers/{id}/edit` | Editar | `affiliate-footers.edit` |
| PUT | `/admin/affiliate-footers/{id}` | Atualizar | `affiliate-footers.update` |
| DELETE | `/admin/affiliate-footers/{id}` | Excluir | `affiliate-footers.destroy` |
| POST | `/admin/affiliate-footers/{id}/toggle` | Ativar/Desativar | `affiliate-footers.toggle` |

---

## 🧪 Testes

### **1. Criar Texto Geral**
```
1. Acesse /admin/affiliate-footers
2. Clique em "Novo Texto"
3. Título: "Grupos WhatsApp"
4. Conteúdo: "🔍 Grupos de WhatsApp...\nhttps://link.com"
5. Plataforma: "Todas as Plataformas"
6. Ordem: 99
7. Salvar
```

### **2. Testar na Amazon**
```
1. Acesse /admin/amazon-affiliate
2. Busque um produto
3. Verifique se o texto aparece ao final
```

### **3. Criar Texto Amazon**
```
1. Criar novo texto
2. Plataforma: "Amazon"
3. Verificar que aparece ANTES do texto geral
```

---

## 💡 Dicas de Uso

### **Boas Práticas:**
- ✅ Use textos curtos e diretos
- ✅ Inclua emojis para chamar atenção
- ✅ Sempre teste antes de ativar
- ✅ Use ordem 1-10 para textos prioritários
- ✅ Use ordem 90-99 para textos gerais

### **Ordenação Recomendada:**
```
Ordem 1-10:   Convites específicos (Prime, Meli+)
Ordem 11-20:  Ofertas especiais
Ordem 80-89:  Redes sociais
Ordem 90-99:  Grupos WhatsApp/Telegram
```

### **Quando Desativar:**
- ✅ Teste A/B
- ✅ Promoções temporárias
- ✅ Ajustes de texto

---

## 🚀 Próximas Plataformas

### **Mercado Livre** (em breve)
```php
// Já preparado no código
$footers = AffiliateFooter::formatForPlatform('mercadolivre');
```

### **Shopee** (em breve)
```php
// Já preparado no código
$footers = AffiliateFooter::formatForPlatform('shopee');
```

---

## 🎉 Exemplo Completo

### **Footers Cadastrados:**
1. **Prime (Amazon, ordem 1)**: "⭐ Se torne Prime..."
2. **WhatsApp (Todas, ordem 99)**: "🔍 Grupos de WhatsApp..."

### **Produto Amazon Buscado:**
```
Notebook Gamer Acer Nitro 5

De: R̶$̶ ̶4̶.̶9̶9̶9̶,̶0̶0̶
Por: R$ 3.499,00

🎟️ Cupom disponível: R$ 100,00 OFF ⭐ (Exclusivo Prime)

Compre aqui: https://amzn.to/3KKWPwk

⭐ Se torne Prime e aproveite esse desconto!
👉 https://amazon.com.br/prime

🔍 Grupos de WhatsApp e Telegram:
https://minhaurl.com
```

**Perfeito!** 🎯

---

**Versão**: 1.0  
**Data**: Outubro 2025  
**Status**: ✅ Implementado e Funcional