App-Estoque-LiberiKids/INICIO-RAPIDO-ALERTAS.md

⚡ 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:

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:

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

node scripts/enviar-alertas-parcelas.js

Ver se o cron está instalado

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

tail -f logs/alertas-cron.log

Testar Evolution API

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

# 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

crontab -l

Resultado esperado:

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

Teste 3: Logs Sendo Gerados

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:

# 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:

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:

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:

./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:

# 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 ✅