# 🚀 Guia Rápido - Sistema de Parcelas com PIX

## ⚡ Início Rápido (3 Passos)

### 1️⃣ Execute no Supabase SQL Editor
```sql
CREATE TABLE IF NOT EXISTS venda_parcelas (
    id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
    venda_id UUID NOT NULL REFERENCES vendas(id) ON DELETE CASCADE,
    numero_parcela INTEGER NOT NULL,
    valor DECIMAL(10,2) NOT NULL,
    data_vencimento DATE NOT NULL,
    status TEXT DEFAULT 'pendente' CHECK (status IN ('pendente', 'pago', 'vencida', 'cancelada')),
    data_pagamento TIMESTAMP WITH TIME ZONE,
    pix_payment_id TEXT,
    pix_qr_code TEXT,
    pix_qr_code_base64 TEXT,
    observacoes TEXT,
    created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
    UNIQUE(venda_id, numero_parcela)
);

CREATE INDEX IF NOT EXISTS idx_venda_parcelas_venda ON venda_parcelas(venda_id);
CREATE INDEX IF NOT EXISTS idx_venda_parcelas_status ON venda_parcelas(status);
CREATE INDEX IF NOT EXISTS idx_venda_parcelas_vencimento ON venda_parcelas(data_vencimento);

CREATE TRIGGER update_venda_parcelas_updated_at 
BEFORE UPDATE ON venda_parcelas 
FOR EACH ROW 
EXECUTE FUNCTION update_updated_at_column();

ALTER TABLE venda_parcelas ENABLE ROW LEVEL SECURITY;
CREATE POLICY "Enable all operations for authenticated users" ON venda_parcelas FOR ALL USING (true);
```

### 2️⃣ Reinicie o Servidor
```bash
# Ctrl+C para parar
npm start
```

### 3️⃣ Teste!
- Crie uma venda parcelada (3x por exemplo)
- Visualize a venda (ícone 👁️)
- Veja as 3 parcelas com valores individuais
- Gere PIX de cada parcela separadamente

## 🎯 O Que Foi Implementado

### ✅ Nova Mensagem de WhatsApp Automática
Quando você registra uma venda, o cliente recebe:

**Se for À Vista:**
```
Olá João Silva! 👋
Sua compra foi registrada com sucesso! 💙

Confira os detalhes abaixo:
📅 Data da compra: 18/10/2025
💰 Valor total: R$ 150,00
💳 Pagamento: À vista

Agradecemos pela sua preferência! 😊
Conte sempre com a Liberi Kids - Moda Infantil 👕👗
```

**Se for Parcelado:**
```
Olá João Silva! 👋
Sua compra foi registrada com sucesso! 💙

Confira os detalhes abaixo:
📅 Data da compra: 18/10/2025
💰 Valor total: R$ 150,00
💳 Pagamento: 3x de R$ 50,00 cada

Agradecemos pela sua preferência! 😊
Conte sempre com a Liberi Kids - Moda Infantil 👕👗
```

### ✅ Visualização de Parcelas Individuais

Na tela de detalhes da venda, você verá:

```
┌────────────────────────────────────┐
│ 💳 Parcelas Individuais            │
├────────────────────────────────────┤
│ ┌──────────────────────────────┐  │
│ │ Parcela 1/3        🕐 Pendente│  │
│ │ 💰 Valor: R$ 50,00            │  │
│ │ 📅 Vencimento: 18/11/2025     │  │
│ │ [Gerar PIX] 💳                │  │
│ └──────────────────────────────┘  │
│                                    │
│ ┌──────────────────────────────┐  │
│ │ Parcela 2/3        🕐 Pendente│  │
│ │ 💰 Valor: R$ 50,00            │  │
│ │ 📅 Vencimento: 18/12/2025     │  │
│ │ [Gerar PIX] 💳                │  │
│ └──────────────────────────────┘  │
│                                    │
│ ┌──────────────────────────────┐  │
│ │ Parcela 3/3        ✅ Pago    │  │
│ │ 💰 Valor: R$ 50,00            │  │
│ │ 📅 Vencimento: 18/01/2026     │  │
│ │ ✅ Pago em: 17/01/2026 14:30  │  │
│ └──────────────────────────────┘  │
└────────────────────────────────────┘
```

### ✅ PIX Individual por Parcela

Quando você clica em "Gerar PIX":
1. Sistema gera QR Code específico para aquela parcela
2. Valor exato da parcela (não o total)
3. Você pode enviar por WhatsApp
4. Cliente recebe:
   ```
   Olá João Silva! 💙
   
   Segue o PIX para pagamento da *Parcela 2*:
   
   💰 Valor: R$ 50,00
   📅 Vencimento: 18/12/2025
   
   👇 Escaneie o QR Code abaixo ou copie o código PIX para pagar:
   [QR CODE IMAGE]
   ```

## 🎨 Cores dos Status

- 🟢 **Verde** = Parcela Paga
- 🟡 **Amarelo** = Parcela Pendente  
- 🔴 **Vermelho** = Parcela Vencida

## 📱 Fluxo de Trabalho Completo

```
1. Cliente faz compra
   ↓
2. Você registra venda parcelada (ex: 3x)
   ↓
3. Cliente recebe WhatsApp automático
   "Compra registrada: 3x de R$ 50,00"
   ↓
4. Quando vencer parcela 1:
   - Você abre a venda
   - Clica "Gerar PIX" na parcela 1
   - Envia PIX por WhatsApp
   ↓
5. Cliente paga via PIX
   ↓
6. Status muda para "Pago" ✅
   ↓
7. Repete para parcelas 2 e 3
```

## 🔥 Recursos Avançados

### Mensagem por Parcela
Cada parcela tem mensagem específica:
- Valor exato da parcela
- Número da parcela (1/3, 2/3, etc.)
- Data de vencimento específica

### Rastreamento Individual
- Cada parcela tem seu ID único
- PIX vinculado à parcela específica
- Histórico de pagamento por parcela

### Integração com Alertas
O sistema se integra com alertas WhatsApp:
- 3 dias antes do vencimento
- No dia do vencimento
- 3 dias após vencimento

Variáveis disponíveis:
- `{cliente}` = Nome do cliente
- `{valor}` = Valor da parcela
- `{quando}` = Data vencimento
- `{parcela}` = Número da parcela

## 💡 Dicas de Uso

### ✅ Boas Práticas
1. **Gere o PIX próximo ao vencimento** - PIX tem validade
2. **Envie lembrete 3 dias antes** - Cliente tem tempo de se organizar
3. **Marque como pago manualmente** - Se receber por outro meio
4. **Use observações** - Anote detalhes importantes

### ⚠️ Evite
1. ❌ Gerar múltiplos PIX para mesma parcela
2. ❌ Alterar valor após gerar PIX
3. ❌ Deletar venda com parcelas pagas

## 🆘 Solução de Problemas

### "Não vejo as parcelas"
- ✅ Criou a tabela no Supabase?
- ✅ Reiniciou o servidor?
- ✅ A venda é parcelada?

### "Erro ao gerar PIX"
- ✅ MercadoPago configurado?
- ✅ Cliente tem dados cadastrados?
- ✅ Parcela já foi paga?

### "WhatsApp não envia"
- ✅ Evolution API configurada?
- ✅ Cliente tem WhatsApp cadastrado?
- ✅ Instância está conectada?

## 📊 Relatórios Futuros

O sistema está preparado para:
- Dashboard de parcelas a vencer
- Relatório de inadimplência
- Histórico de pagamentos
- Análise de recebimentos

## 🎓 Exemplo Prático

**Cenário:** Venda de R$ 300,00 em 3x

1. **Registro:**
   - Valor Total: R$ 300,00
   - 3 parcelas de R$ 100,00
   - Vencimentos: 18/11, 18/12, 18/01

2. **Cliente Recebe:**
   ```
   Compra registrada!
   💰 Total: R$ 300,00
   💳 3x de R$ 100,00 cada
   ```

3. **No vencimento de cada parcela:**
   - Gera PIX de R$ 100,00
   - Envia para cliente
   - Cliente paga
   - Marca como pago ✅

4. **Resultado:**
   - Controle total dos recebimentos
   - Cliente recebe apenas o que deve
   - Histórico completo registrado

---

## ✨ Pronto para Usar!

Agora você tem controle completo de vendas parceladas com:
- ✅ Parcelas individuais
- ✅ PIX separado por parcela  
- ✅ WhatsApp automático
- ✅ Rastreamento de status
- ✅ Interface visual moderna

**Comece agora criando sua primeira venda parcelada!** 🚀
