Guía de Instalación
en VPS

Internet (usuario / navegador)
        ↓  HTTPS :443
    Nginx (reverse proxy + SSL termination)
       ↙                    ↘
Next.js :3000        NestJS :3001
(Frontend UI)           (Backend API)
                            ↓
                  MySQL :3306   Redis :6379

Los puertos 3000, 3001, 3306 y 6379 son
internos al servidor — NO expuestos a internet.

# Subir el archivo
scp opussuite.tar.gz root@IP_DE_TU_VPS:/var/www/

# Conectarse por SSH
ssh root@IP_DE_TU_VPS

# Ir a /var/www
cd /var/www

# Descomprimir
tar -xzf opussuite.tar.gz

# Verificar la estructura
ls -la opussuite/
# Debes ver: backend/ frontend/ nginx/ scripts/ README.md

# Dar permisos de ejecución a los scripts
chmod +x /var/www/opussuite/scripts/*.sh

sudo bash /var/www/opussuite/scripts/install.sh

nano /var/www/opussuite/backend/.env

# ── EMAIL (Resend — https://resend.com, plan gratuito 3000/mes)
RESEND_API_KEY=re_xxxxxxxxxxxxxxxxxxxx
EMAIL_FROM=noreply@tudominio.com

# ── STRIPE (https://stripe.com/es)
STRIPE_SECRET_KEY=sk_live_xxxxxxxxxxxxxxxxxxxx
STRIPE_PUBLISHABLE_KEY=pk_live_xxxxxxxxxxxxxxxxxxxx
STRIPE_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxxxxxxxxx

# ── ALMACENAMIENTO (Cloudflare R2 — gratis hasta 10GB/mes)
STORAGE_PROVIDER=r2
R2_ACCOUNT_ID=tu_account_id
R2_ACCESS_KEY_ID=tu_access_key
R2_SECRET_ACCESS_KEY=tu_secret
R2_BUCKET_NAME=opussuite-assets
R2_PUBLIC_URL=https://assets.tudominio.com

# ── WEB PUSH (genera las claves en el siguiente paso)
VAPID_PUBLIC_KEY=Bxxx...
VAPID_PRIVATE_KEY=xxx...

npx web-push generate-vapid-keys
# Copia las dos claves generadas en el .env

STORAGE_PROVIDER=local
LOCAL_STORAGE_PATH=/var/www/opussuite/uploads
LOCAL_STORAGE_URL=https://tudominio.com/uploads

# Guardar en nano: Ctrl+O, Enter, Ctrl+X

# Reiniciar la aplicación para aplicar los cambios
pm2 restart all

# Verificar que todo arrancó bien
pm2 status

# 1. Estado de los procesos PM2
pm2 status
# Debes ver: opussuite-api (online) y opussuite-web (online)

# 2. Verificar backend responde
curl http://localhost:3001/api/v1/health
# Respuesta esperada: {"status":"ok","timestamp":"..."}

# 3. Verificar frontend responde
curl -I http://localhost:3000
# Respuesta esperada: HTTP/1.1 200 OK

# 4. Verificar MySQL
mysql -u opussuite -p -e "SHOW TABLES;" opussuite_db
# Debes ver 20+ tablas (User, Organization, Client, Project...)

# 5. Verificar Redis
redis-cli ping
# Respuesta esperada: PONG

# 6. Verificar Nginx
nginx -t
systemctl status nginx

# Ver estado en tiempo real
pm2 monit

# Ver logs en vivo (Ctrl+C para salir)
pm2 logs opussuite-api   # Backend
pm2 logs opussuite-web   # Frontend

# Reiniciar sin downtime
pm2 reload all

# Reinicio completo
pm2 restart all

# Ver procesos
pm2 list

# Hacer backup manual ahora
bash /var/www/opussuite/scripts/backup.sh
# Guarda en: /var/backups/opussuite/

# Configurar backup diario automático a las 2am
crontab -e
# Añadir esta línea:
0 2 * * * bash /var/www/opussuite/scripts/backup.sh

# Subir nueva versión del paquete, luego:
bash /var/www/opussuite/scripts/update.sh
# Hace backup automático antes de actualizar

certbot renew --dry-run
# Sin errores = renovación automática funcionando

certbot certificates
# Ver fecha de expiración actual

pm2 logs opussuite-api --lines 50
# Lee el error específico. Causas comunes:
# - Variables .env faltantes o incorrectas
# - Puerto 3001 ocupado por otro proceso
# - Error de conexión a MySQL o Redis

systemctl status mysql
mysql -u opussuite -p opussuite_db
# Si falla: verificar la contraseña en DATABASE_URL del .env

pm2 status        # Verificar que los procesos están online
pm2 restart all   # Si están stopped/errored, reiniciar
nginx -t          # Verificar configuración Nginx
tail -f /var/log/nginx/opussuite-error.log

# Crear swap si el VPS tiene poca RAM
fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
# Volver a compilar
cd /var/www/opussuite/frontend && npm run build

# Verificar que el dominio resuelve a este servidor:
dig +short tudominio.com
# Debe mostrar la IP del VPS

# Intentar manualmente:
certbot --nginx -d tudominio.com -d www.tudominio.com