# ⚡ Início Rápido - Sistema de Alertas

## 🚨 Problema Atual

**Sua venda de 20/10 com vencimento em 24/10 NÃO recebeu alertas porque o sistema automático não estava instalado.**

---

## ✅ Solução em 3 Passos

### PASSO 1: Enviar Alertas Atrasados (AGORA)

Para enviar **imediatamente** os alertas da venda de 20/10 e outras parcelas vencidas:

```bash
cd /home/tiago/Downloads/app_estoque_v1.0.0
node scripts/enviar-alertas-atrasados.js
```

Isso irá:
1. Listar todas as parcelas vencidas ou vencendo hoje
2. Perguntar se deseja enviar
3. Gerar PIX para cada parcela
4. Enviar via WhatsApp
5. Mostrar resultado de cada envio

**Tempo:** 2-5 minutos

---

### PASSO 2: Instalar Cron (Para Futuro)

Para que os alertas sejam enviados **automaticamente às 09:00 todos os dias**:

```bash
cd /home/tiago/Downloads/app_estoque_v1.0.0
chmod +x scripts/instalar-cron-alertas.sh
./scripts/instalar-cron-alertas.sh
```

O instalador irá:
1. Configurar execução diária às 09:00
2. Criar diretório de logs
3. Perguntar se quer testar agora
4. Mostrar comando para monitorar

**Tempo:** 1-2 minutos

---

### PASSO 3: Verificar Configurações

Abra o painel admin → Configurações e verifique:

**Evolution API:** ✅
- URL da API configurada
- Nome da instância configurado
- API Key configurada

**Mercado Pago:** ✅
- Access Token configurado

**Alertas WhatsApp:** ✅
- Primeiro alerta: ATIVO (3 dias antes)
- Segundo alerta: ATIVO (no dia)
- Alerta pós-vencimento: ATIVO (3 dias após)

**Tempo:** 2-3 minutos

---

## 🎯 Comandos Úteis

### Ver alertas que seriam enviados hoje

```bash
node scripts/enviar-alertas-parcelas.js
```

### Ver se o cron está instalado

```bash
crontab -l | grep alertas
```

Deve mostrar:
```
0 12 * * * TZ='America/Sao_Paulo' /usr/bin/node /caminho/para/enviar-alertas-parcelas.js...
```

### Monitorar logs em tempo real

```bash
tail -f logs/alertas-cron.log
```

### Testar Evolution API

```bash
curl -X GET "SEU_URL/instance/connectionState/SUA_INSTANCIA" \
  -H "apikey: SUA_API_KEY"
```

---

## 📅 Como Vai Funcionar Agora

### Exemplo: Nova venda hoje (24/10)

**Venda:** 24/10/2025  
**Parcela 1 vence:** 24/11/2025

**Timeline automática:**

| Data | Horário | Ação |
|------|---------|------|
| **21/11** | 09:00 | 🔔 Primeiro alerta: "vence em 3 dias" |
| **24/11** | 09:00 | 🔔 Segundo alerta + PIX: "vence hoje" + QR Code |
| **27/11** | 09:00 | 🔔 Alerta pós-venc (se não pago): "venceu há 3 dias" |

---

## 🔍 Verificar se Está Funcionando

### Teste 1: Envio Manual

```bash
# Deve enviar alertas imediatamente
node scripts/enviar-alertas-parcelas.js
```

**Resultado esperado:**
- Lista parcelas pendentes
- Envia alertas apropriados
- Mostra resumo (X alertas enviados)

### Teste 2: Cron Instalado

```bash
crontab -l
```

**Resultado esperado:**
- Mostra linha com `enviar-alertas-parcelas.js`
- Horário: `0 12` (= 09:00 Brasília)

### Teste 3: Logs Sendo Gerados

```bash
ls -lh logs/alertas-cron.log
```

**Resultado esperado:**
- Arquivo existe
- Tamanho aumenta após cada execução

---

## ⚠️ Troubleshooting Rápido

### Erro: "SUPABASE_KEY não configurado"

**Solução:**
```bash
# Criar arquivo .env na raiz
cd /home/tiago/Downloads/app_estoque_v1.0.0
nano .env

# Adicionar:
SUPABASE_URL=https://ydhzylfnpqlxnzfcclla.supabase.co
SUPABASE_ANON_KEY=sua_chave_aqui
```

### Erro: "Evolution API não responde"

**Verificar:**
1. URL está correta? (com https://)
2. Instância está ativa?
3. API Key está correta?
4. Testar no navegador: `https://sua-url/instance/connectionState/sua-instancia`

### Erro: "Nenhuma parcela encontrada"

**Verificar no banco:**
```sql
SELECT * FROM venda_parcelas 
WHERE status = 'pendente' 
AND data_vencimento >= CURRENT_DATE - INTERVAL '30 days';
```

Se não houver parcelas pendentes, está correto!

### Alertas não chegam no WhatsApp

**Verificar:**
1. Cliente tem WhatsApp cadastrado?
2. Número está correto? (apenas números)
3. Evolution está conectada?
4. Teste enviando mensagem manual pelo Chat

---

## 📞 Para a Venda de 20/10 (Problema Atual)

**Execute AGORA:**

```bash
cd /home/tiago/Downloads/app_estoque_v1.0.0
node scripts/enviar-alertas-atrasados.js
```

Isso irá:
1. ✅ Encontrar a parcela com vencimento em 24/10
2. ✅ Gerar PIX
3. ✅ Enviar WhatsApp com PIX
4. ✅ Registrar no histórico

**Depois:**

```bash
./scripts/instalar-cron-alertas.sh
```

Isso garante que **nunca mais** um alerta será esquecido!

---

## ✅ Checklist Final

Após seguir os 3 passos, verifique:

- [ ] Alertas atrasados enviados (script manual executado)
- [ ] Cron instalado (`crontab -l` mostra a linha)
- [ ] Evolution API configurada no admin
- [ ] Mercado Pago configurado no admin
- [ ] Toggles de alertas ATIVOS no admin
- [ ] Teste manual funcionou
- [ ] Logs sendo gerados em `/logs/alertas-cron.log`

Se todos estiverem ✅, sistema está 100% operacional!

---

## 📚 Documentação Completa

Para detalhes técnicos completos:
- `SISTEMA-ALERTAS-AUTOMATICOS.md` - Documentação técnica completa
- `scripts/enviar-alertas-parcelas.js` - Script principal (comentado)
- `scripts/instalar-cron-alertas.sh` - Instalador do cron

---

## 💡 Dica Final

**Monitore os primeiros dias:**

```bash
# Ver se cron executou às 09:00
tail -f logs/alertas-cron.log
```

**Amanhã (25/10) às 09:01**, verifique se:
- Log foi gerado
- Alertas foram enviados (se houver parcelas)
- Tudo funcionou

Se sim, sistema está perfeito! 🎉

---

**Desenvolvido para: Liberi Kids - Moda Infantil** 👗👕  
**Problema resolvido em: 24/10/2025** ✅
