# Monitoreo, Alertas y Backups

Esta guía deja una base simple y suficiente para operar `Concursando con Amor` en producción sobre DigitalOcean.

## 1. Uptime externo

Usa `UptimeRobot` o `Better Stack` y monitorea estas URLs:

- `https://sorteos.fundacioncreciendoconamor.cl/`
- `https://sorteos.fundacioncreciendoconamor.cl/login`
- `https://sorteos.fundacioncreciendoconamor.cl/api/health`

Config recomendada:

- Intervalo: `1 minuto`
- Reintentos antes de alertar: `2`
- Alertas por: correo + Telegram o WhatsApp empresarial

## 2. Endpoint de salud

La app expone:

- `GET /api/health`

Devuelve:

- estado general
- conectividad con base de datos
- presencia de variables críticas
- tiempo de respuesta

Si `/api/health` responde `503`, el servidor o la configuración requieren revisión.

## 3. Logs

## Opción mínima

Si usas PM2:

```bash
pm2 logs concursandoconamor
pm2 monit
```

Archivos típicos:

- `/root/.pm2/logs/concursandoconamor-out.log`
- `/root/.pm2/logs/concursandoconamor-error.log`

## Opción recomendada

Centraliza logs con:

- `Better Stack Logs`, o
- `Grafana Loki + Promtail`

Alertar si aparecen repetidamente estos textos:

- `Mercado Pago webhook error`
- `Flow webhook error`
- `Error al enviar email`
- `Healthcheck error`
- `PrismaClientInitializationError`

## 4. Alertas mínimas recomendadas

Configura alertas para:

- sitio caído 2 minutos
- `/api/health` en `503`
- errores `5xx` repetidos
- uso de disco mayor a `80%`
- memoria RAM alta sostenida
- renovación SSL fallida
- fallos de SMTP

## 5. Backups PostgreSQL

## Si usas PostgreSQL administrado por DigitalOcean

Activa:

- backups automáticos diarios
- retención mínima de 7 días
- alertas por espacio y conexiones

## Si usas PostgreSQL en Docker / VM

Crea un backup diario con `cron`:

```bash
mkdir -p /var/backups/concursandoconamor
```

Script sugerido:

```bash
#!/usr/bin/env bash
set -euo pipefail

BACKUP_DIR="/var/backups/concursandoconamor"
TS="$(date +%Y-%m-%d_%H-%M-%S)"

pg_dump "$DATABASE_URL" | gzip > "$BACKUP_DIR/concursandoconamor_$TS.sql.gz"
find "$BACKUP_DIR" -type f -name "*.sql.gz" -mtime +7 -delete
```

Cron diario a las 03:00:

```bash
0 3 * * * /usr/local/bin/backup-concursandoconamor.sh >> /var/log/backup-concursandoconamor.log 2>&1
```

Importante:

- prueba restauración al menos una vez
- copia los backups fuera del servidor si el servidor también guarda la DB

## 6. SMTP y entregabilidad

Verifica en Resend o tu proveedor:

- dominio validado
- SPF configurado
- DKIM configurado
- idealmente DMARC

Prueba entrega a:

- Gmail
- Outlook

Y revisa:

- bandeja principal
- spam

## 7. Webhooks de pago

Confirma en producción:

- `MP_WEBHOOK_SECRET` correcto
- `FLOW_API_URL` correcto
- webhook de Mercado Pago apuntando al dominio real
- webhook de Flow apuntando al dominio real
- HTTPS válido

## 8. Checklist de salida a producción

- `pm2 status` o contenedor OK
- `https://sorteos.fundacioncreciendoconamor.cl/api/health` responde `200`
- login admin funcional
- 2FA admin activo
- compra con Flow probada
- compra con Mercado Pago probada
- correo de prueba recibido
- backup probado
- SSL activo
- monitoreo externo activo
