chore: sincroniza projeto para gitea
This commit is contained in:
Tiago
272
INICIO-RAPIDO-ALERTAS.md
Normal file
272
INICIO-RAPIDO-ALERTAS.md
Normal file
@@ -0,0 +1,272 @@
|
||||
# ⚡ 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** ✅
|
||||
Reference in New Issue
Block a user