📘 Guía de Uso del IPG

Inventario Psicológico Global (IPG) · Versión 4.0

Esta guía explica cómo utilizar la aplicación desde el primer acceso hasta la obtención de informes clínicos profesionales, incluyendo las nuevas funcionalidades de autenticación, pruebas vocacionales e interpretación con inteligencia artificial.

1. Página de inicio

Al abrir la aplicación, encontrará cuatro botones según su perfil:

• ⚕️ Soy Profesional de la Salud: Accede al panel profesional con registro/login por email.
• 🧑‍💻 Soy Paciente (tengo un código): Permite al paciente ingresar el código proporcionado por su profesional.
• 🔬 Investigadores: Muestra información técnica sobre el instrumento, escalas y cómo colaborar.
• 📖 Guía de uso: Este documento.

2. Acceso del profesional (nuevo)

Ahora el acceso profesional requiere registro y login con email y contraseña:

1. Haga clic en “Soy Profesional de la Salud”.
2. Si es su primera vez, use el enlace “Regístrate aquí” y cree una cuenta con su correo electrónico y una contraseña segura.
3. Una vez registrado, inicie sesión con su email y contraseña.
4. El sistema generará un token de sesión válido por 24 horas.

3. Panel profesional

Una vez autenticado, tendrá acceso a las siguientes funcionalidades organizadas en acordeones:

3.1 Selección de módulos a aplicar

Ahora puede elegir entre 6 especialidades que agrupan las escalas clínicas originales y las nuevas pruebas organizacionales/vocacionales:

• Personalizada: Marca/desmarca manualmente cada escala.
• Clínica / Salud Mental: Incluye todas las escalas clínicas (PHQ‑9, GAD‑7, etc.).
• Trabajo / Estrés laboral: Selecciona escalas relevantes para entornos laborales (estrés, liderazgo, clima laboral).
• Infanto‑Juvenil: Escalas adaptadas para adolescentes y niños.
• Trauma y estrés: Escalas como PCL‑5 y CTQ‑5.
• Organizacional / Vocacional: Nuevas pruebas: Holland (intereses vocacionales), PMA (aptitudes mentales), DISC (personalidad laboral), WES (clima laboral) y estilos de liderazgo.

Puede usar los botones “Seleccionar todos” y “Deseleccionar todos” para agilizar la selección.

3.2 Generar código para paciente

1. Presione el botón “Generar nuevo código”.
2. Aparecerá un código de 6 caracteres (ej. LUCYYH) y un enlace completo para el paciente.
3. Comparta ese enlace con el paciente (por WhatsApp, correo, etc.).
4. El código expira en 2 horas si el paciente no lo utiliza. El sistema renueva el tiempo si el paciente guarda progreso.
5. Los módulos seleccionados quedan asociados al código y solo aparecerán en el test del paciente.

3.3 Consultar resultados del paciente

1. En el campo “Código del paciente”, escriba el código del test que desea revisar.
2. Presione “🔍 Cargar resultados”.
3. Si el paciente ya completó el test, se mostrará el informe clínico completo con:
• Tabla con Escala, Puntuación, Severidad (Leve/Moderada/Severa/Extrema) e interpretación clínica.
• Percentil estimado (comparación con población general simulada).
• Recomendaciones clínicas automáticas.
• Narrativa del paciente.
• Gráfico de perfil (radar o barras) para escalas vocacionales (Holland, DISC).
4. Los resultados se almacenan durante 7 días.

3.4 Exportar informes

Una vez cargado un perfil, aparecen varios botones de exportación:

• 📄 PDF Profesional: Genera un PDF idéntico al informe en pantalla (tabla, colores, gráficos).
• 📝 Word: Descarga un archivo .doc con la información estructurada.
• 📊 CSV: Archivo de datos brutos (escala, puntuación, máximo, severidad, percentil) para análisis estadístico.
• 👤 Reporte paciente: Muestra un resumen en lenguaje sencillo, con los niveles de cada escala (Leve, Moderado, Severo, Extremo).
• 🤖 Informe IA NUEVO: Genera una interpretación automática personalizada usando inteligencia artificial. El informe se cachea, por lo que es idéntico para el mismo paciente y no consume recursos repetidamente.

Además, puede agregar notas clínicas en el área de texto, que se incluirán automáticamente en el PDF y Word.

3.5 Anular un test

Si necesita cancelar un test que quedó inconcluso o ya no se utilizará:

1. Ingrese el código en el campo correspondiente.
2. Presione “🗑️ Anular test”.
3. Confirme la acción. El código, cualquier progreso parcial y el informe IA cacheadado se eliminarán permanentemente.

4. Acceso del paciente

El paciente puede realizar el test de dos formas:

• Mediante el enlace directo que el profesional le compartió (ej. https://.../paciente.html?code=LUCYYH). Al abrirlo, ingresará automáticamente.
• Desde la página de inicio, haciendo clic en “Soy Paciente” e ingresando manualmente el código.

Una vez validado el código, se cargarán solo las escalas que el profesional seleccionó. El paciente verá las preguntas reales (no genéricas) y opciones de respuesta según cada tipo de test (ej. “No me gusta / Indiferente / Me gusta” para Holland, opciones Likert para DISC, etc.).

5. Realización del test

5.1 Navegación

• Las preguntas se muestran una por una, con barra de progreso.
• Para avanzar, seleccione una respuesta y presione “Siguiente”. Puede volver atrás con “Anterior”.
• Debe responder todas las preguntas para enviar el test.
• Puede escribir comentarios adicionales en el campo “Comentarios adicionales (opcional)”.

5.2 Pausar y continuar después

El sistema guarda automáticamente el progreso si el paciente cierra el navegador o pierde la conexión. Al reingresar con el mismo código, se recuperarán las respuestas previas. Además, el código se renueva por 2 horas cada vez que se guarda.

5.3 Finalizar el test y recibir informe IA

Una vez respondidas todas las preguntas, presione “✅ Enviar respuestas”. El sistema:

• Calcula las puntuaciones de cada escala.
• Guarda el perfil completo en el Worker (válido por 7 días).
• Invoca al servicio de inteligencia artificial para generar un informe personalizado en lenguaje claro, con advertencia ética y recomendaciones prácticas.
• Muestra el informe al paciente en pantalla.
• El profesional podrá consultar el mismo informe desde su panel usando el botón “🤖 Informe IA”.

6. Seguridad y privacidad

• Los profesionales solo ven los códigos y resultados de los pacientes que ellos mismos generaron.
• Las contraseñas se almacenan hasheadas (SHA‑256) y las sesiones usan tokens aleatorios.
• Los códigos expiran automáticamente tras 2 horas de inactividad o 7 días después de finalizado el test.
• Los datos se almacenan en Cloudflare Workers KV con TTL configurados.
• El profesional es responsable de la custodia de los códigos y de compartir los informes de forma segura.
• No se almacenan datos identificativos del paciente más allá del código temporal.

7. Preguntas frecuentes

¿Olvidé mi contraseña profesional?

Actualmente no hay recuperación de contraseña. Debe crear una nueva cuenta con otro email. En futuras versiones se implementará recuperación.

¿Puedo generar un código sin seleccionar módulos?

Sí, dejará todas las escalas disponibles. Se recomienda seleccionar solo las necesarias para reducir el tiempo de respuesta.

¿El informe IA es siempre el mismo para un mismo paciente?

Sí, se genera una sola vez y se almacena en caché, por lo que el profesional verá el mismo texto cada vez que haga clic en “🤖 Informe IA”.

¿Cuánto cuesta el uso de la IA?

El modelo usado (@cf/meta/llama-3.2-3b-instruct) tiene una capa gratuita suficiente para empezar. El coste por informe es muy bajo (fracciones de centavo). Además el cacheo evita consumos repetidos.

¿Puedo exportar los datos en otros formatos?

Además de PDF, Word y CSV, puede copiar los resultados de la tabla manualmente o integrar la API para exportación automática.

⬅ Volver al inicio