Manual de Resolución de Problemas

Diagnóstico y Solución de Errores Comunes
Guía para administradores y soporte técnico del Sistema de Votaciones SINTRASECOP.

Problemas de Acceso (Usuarios)

"Código de Invitación Inválido"

Síntoma: El usuario intenta registrarse pero recibe un error indicando que el código no es válido.

Causas Probables:

  1. El código fue mal escrito (confusión entre 0 y O, 1 y I).
  2. El código ya fue utilizado anteriormente.
  3. El código no existe en la base de datos.

Solución:

  1. Verifique en el Panel Administrativo > Códigos el estado del código.
  2. Si aparece como Usado: Sí, verifique quién lo usó (el sistema registra el ID del usuario).
  3. Si el código es correcto y no ha sido usado, intente copiar y pegar directamente para evitar errores de digitación.

"Correo ya registrado"

Síntoma: El usuario no puede completar el registro porque el email ya existe.

Solución:

  1. El usuario probablemente ya se registró. Indíquele que use la opción Iniciar Sesión en lugar de Registro.
  2. Si olvidó su contraseña, debe usar la opción Recuperar Contraseña.

"No llega el correo de recuperación"

Causas Probables:

  1. Problema con el servicio de correo (SendGrid).
  2. El correo cayó en SPAM.
  3. El correo ingresado no existe en el sistema.

Solución:

  1. Pedir al usuario que revise la carpeta de Spam/Correo no deseado.
  2. Verificar en los logs del servidor si hay errores de envío SMTP.

Problemas de Votación

"No puedo seleccionar ningún candidato"

Síntoma: Los botones de "Votar" están deshabilitados o no aparecen.

Causas:

  1. El usuario ya votó anteriormente.
  2. La votación ha sido cerrada por el administrador.

Solución:

  1. Verifique el estado del usuario en la base de datos (ha_votado = 1).
  2. Confirme que el proceso electoral sigue activo.

"Error al verificar el voto"

Síntoma: Al ingresar el hash de verificación, el sistema dice que no se encuentra.

Solución:

  1. Asegúrese de copiar el hash completo (64 caracteres) sin espacios extra al inicio o final.
  2. Si el usuario perdió el hash, no hay forma de recuperarlo por diseño de seguridad (anonimato), pero el administrador puede confirmar si el usuario ya figura como "Votante" en el sistema.

Errores del Sistema (Técnico)

Error de Conexión a Base de Datos (ECONNREFUSED)

Mensaje en consola: Error: connect ECONNREFUSED 127.0.0.1:3306

Solución:

  1. Verifique que el servicio de MySQL esté corriendo.
  2. Revise las credenciales en el archivo .env.
  3. Confirme que el puerto DB_PORT es correcto (por defecto 3306, pero XAMPP/MAMP suelen usar otros).

Error 500 al generar PDF

Síntoma: El sistema falla al intentar descargar reportes PDF.

Solución:

  1. Verifique que la librería pdfkit o jspdf esté instalada correctamente.
  2. Revise los logs del servidor para ver el stack trace específico.
  3. A veces, caracteres especiales en los nombres de candidatos pueden romper la generación del PDF. Intente sanitizar los nombres en la base de datos.