Guía de Solución de Problemas - Sistema CDA

Opción 1: Instalar Node.js correcto

# Verificar versión requerida
cat package.json | grep '"node"' 

# Instalar Node.js 18+ (recomendado)
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# CentOS/RHEL
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
sudo yum install -y nodejs

# macOS (usando Homebrew)
brew install node@18

# Windows
# Descargar desde https://nodejs.org

Opción 2: Usar NVM (Node Version Manager)

# Instalar NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# Recargar terminal
source ~/.bashrc

# Instalar y usar Node.js 18
nvm install 18
nvm use 18
nvm alias default 18

Opción 1: Limpiar caché y reinstalar

# Limpiar caché de npm
npm cache clean --force

# Eliminar node_modules y package-lock.json
rm -rf node_modules package-lock.json

# Reinstalar dependencias
npm install

Opción 2: Problemas de permisos

# Cambiar propietario de npm (Linux/macOS)
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) /usr/local/lib/node_modules

# O usar npx (sin instalación global)
npx npm install

Opción 1: Cambiar permisos

# Dar permisos al directorio
sudo chown -R $USER:$USER /path/to/sistema-marketing-recordatorios
chmod -R 755 /path/to/sistema-marketing-recordatorios

Opción 2: Usar directorio alternativo

# Clonar en directorio con permisos
cd ~
git clone https://github.com/cda-colombia/sistema-marketing-recordatorios.git
cd sistema-marketing-recordatorios
npm install

Paso 1: Verificar si el servidor está corriendo

# Verificar procesos de Node.js
ps aux | grep node

# Verificar puerto en uso
netstat -tlnp | grep :4321
# o en macOS/Linux moderno
ss -tlnp | grep :4321

Paso 2: Iniciar el servidor

# Iniciar servidor de desarrollo
npm run dev

# Verificar que inicie correctamente
# Debería mostrar: "Local: http://localhost:4321/"

Paso 1: Verificar credenciales por defecto

# Conectar a base de datos
mysql -u app_notificaciones -p notificaciones_automotrices

# Verificar usuario admin
SELECT email, password_hash FROM usuarios WHERE rol_id = 1;

Paso 2: Verificar configuración JWT

# Verificar .env
cat .env | grep JWT

# Asegurar que JWT_SECRET tenga 32+ caracteres
# JWT_SECRET=clave_secreta_de_al_menos_32_caracteres

Paso 3: Limpiar cookies y caché

En el navegador:

1. Abrir DevTools (F12)
2. Ir a Application → Storage
3. Limpiar Local Storage, Session Storage y Cookies
4. Recargar página (Ctrl+F5)

Paso 1: Verificar MySQL está corriendo

# Linux (systemd)
systemctl status mysql
systemctl start mysql

# Linux (init.d)
service mysql status
service mysql start

# macOS (brew)
brew services list | grep mysql
brew services start mysql

# Windows
# Ir a Services → MySQL → Start

Paso 2: Verificar credenciales en .env

# Verificar configuración
cat .env | grep DB_

# Probar conexión manual
mysql -u TU_USUARIO -p -h localhost notificaciones_automotrices

Paso 1: Importar schema completo

# Importar schema SQL
mysql -u app_notificaciones -p notificaciones_automotrices < schema.sql

# Verificar tablas creadas
mysql -u app_notificaciones -p notificaciones_automotrices -e "SHOW TABLES;"

Paso 1: Verificar API Key

# Verificar configuración
cat .env | grep SENDGRID

# Probar API Key manualmente
curl -X GET "https://api.sendgrid.com/v3/user/account" \
  -H "Authorization: Bearer TU_API_KEY"

Paso 2: Generar nueva API Key

1. Inicia sesión en SendGrid
2. Ve a Settings → API Keys
3. Crea nueva API Key con permisos:
   • Mail Send: Full Access
   • Template Access: Read Access
4. Copia la nueva API Key y actualiza .env

Paso 1: Verificar cola de notificaciones

-- Verificar estado de notificaciones
SELECT 
    estado,
    COUNT(*) as total,
    MAX(creado_en) as ultimo
FROM cola_notificaciones 
GROUP BY estado;

Paso 2: Procesar cola manualmente

# Procesar notificaciones pendientes
curl -X POST http://localhost:4321/api/notificaciones/procesar \
  -H "Authorization: Bearer TU_ADMIN_TOKEN"

# Verificar respuesta
# Debería mostrar: processed, sent, failed counts

Paso 1: Monitorear recursos del sistema

# Uso de CPU y memoria
top -p $(pgrep -f "node.*4321")

# Uso de disco
df -h

# Uso de memoria
free -h

# Conexiones de red
netstat -an | grep :4321 | wc -l

Paso 2: Optimizar consultas SQL

-- Identificar consultas lentas
SELECT 
    query_time,
    lock_time,
    rows_sent,
    rows_examined,
    sql_text
FROM mysql.slow_log 
ORDER BY query_time DESC 
LIMIT 10;