EureqaVisor3D · Manual de usuario

¿Qué es EureqaVisor3D?

EureqaVisor3D es un visor médico interactivo para explorar modelos anatómicos 3D y planificación quirúrgica. El sistema incluye autenticación segura, gestión de roles, cola de procesamiento de casos y trazabilidad completa de acciones.

⚠ Uso previsto: Apoyo a la visualización anatómica experimental. No es un producto sanitario certificado (no MDR, no FDA). No usar como única fuente de decisión clínica.

Iniciar sesión

Accede a /login.html. Introduce tu email y contraseña y pulsa Acceder. Si es tu primera vez, el administrador habrá creado tu cuenta y te habrá comunicado las credenciales.

1

Escribe tu email y contraseña.

2

Pulsa Acceder o Enter.

3

Serás redirigido al panel de control (/dashboard.html).

💡 La sesión dura 24 horas. Si el administrador desactiva tu cuenta, la sesión se invalida de inmediato en el siguiente request.

Contraseña incorrecta o cuenta desactivada

El sistema bloquea temporalmente la IP tras 10 intentos fallidos en 5 minutos. Si tu cuenta ha sido desactivada, contacta con el administrador.

Cerrar sesión

Pulsa Cerrar sesión en el dashboard o en el visor. La sesión se invalida en el servidor y el navegador borra la cookie.

Roles y permisos

Cada usuario tiene un rol que determina qué puede hacer. El administrador puede asignar y cambiar roles desde el dashboard.

Rol	Descripción	Accesos principales
Admin	Administrador del sistema	Todo: usuarios, features, cola, auditoría, backup
Gestor	Coordinador de casos	Cola de procesamiento, todos los casos, subida
Radiólogo	Especialista en imagen	Sus casos, subida de TCs, revisión radiológica
Cirujano	Especialista quirúrgico	Sus casos, comentarios, versiones, mediciones
Invitado	Acceso temporal y limitado	Solo visualización de casos asignados

💡 Los usuarios Invitado tienen una fecha de caducidad. Pasada esa fecha no pueden iniciar sesión.

Panel de control (Dashboard)

Tras iniciar sesión aterrizas en el dashboard (/dashboard.html). También puedes acceder desde el visor pulsando en tu nombre en la esquina superior derecha del panel.

El dashboard muestra pestañas distintas según tu rol:

📋 Cola — Casos en espera de procesamiento (Admin y Gestor)
📁 Casos — Lista de todos tus casos (o todos los del sistema si eres Admin/Gestor)
⬆ Subir caso — Formulario de subida (no disponible para Invitados)
👥 Usuarios — Gestión de cuentas (solo Admin)
⚙ Features — Activar/desactivar funcionalidades por rol (solo Admin)

En la cabecera también encontrarás los enlaces 📋 Auditoría y 💾 Backup (solo Admin).

Subir un caso

Desde el dashboard, pestaña ⬆ Subir caso. También accesible directamente en /subir.html.

Opción A — Caso vacío (flujo recomendado)

1

Tab 📁 Nuevo caso: escribe nombre, identificador de paciente y email del cirujano.

2

Pulsa Crear proyecto vacío. Recibirás un token único del caso.

3

Usa los botones ＋ Añadir modelo 3D y ＋ Añadir TC/RMN para adjuntar archivos cuando estén listos.

Opción B — Subir TC directamente

Tab TC/RMN: arrastra el ZIP de DICOMs o el archivo .nii.gz. El sistema detecta las series automáticamente.

Anonimización de datos DICOM

En el tab TC/RMN aparece la opción Anonimizar datos DICOM. Al activarla, el servidor elimina los siguientes campos del encabezado de cada fichero .dcm antes de guardarlos:

Nombre e identificador del paciente
Fecha de nacimiento, sexo, edad, peso y talla
Nombre de institución, médico referente, operador
ID de estudio y número de acceso
Historial clínico y comentarios del paciente

El proceso es best-effort: si algún fichero DICOM está corrupto o no es estándar, se omite y la subida continúa. Los ficheros STL/OBJ no se ven afectados.

Los casos anonimizados muestran el badge 🔒 Anon en la tabla de casos del dashboard.

⚠ Esta funcionalidad está pendiente de revisión por el equipo Eureqa antes de su uso en producción clínica.

Opción C — Subir mallas 3D

Tab 3D: arrastra archivos STL, OBJ o PLY (uno por estructura anatómica).

Agrupar estructuras automáticamente

Tanto en la subida directa (/subir.html) como en el modal de procesado de la cola (Gestor/Admin) aparece la opción «Agrupar estructuras automáticamente», desactivada por defecto. Al activarla, tras generar el modelo 3D el sistema crea un grupo por cada categoría anatómica detectada (Tumor, Vísceras, Vasos, Huesos, Músculos, Nervioso) con las estructuras correspondientes, ya con transparencia (50% opacidad) para poder verlas superpuestas. Estos grupos aparecen en la sección Grupos del visor y pueden editarse igual que uno creado a mano.

Flujo con cola de procesamiento

Cirujanos y radiólogos suben archivos crudos que quedan en estado Pendiente. El Gestor o Admin revisa la cola y lanza el procesamiento cuando es apropiado.

Cola de procesamiento

Disponible para Admin y Gestor en la pestaña 📋 Cola del dashboard.

Estado	Significado
🟡 Pendiente	Archivos subidos, esperando procesamiento
🔵 Procesando	Generando modelo 3D
✅ Listo	Caso publicado y accesible en el visor
❌ Error	Fallo en el procesamiento — se puede reintentar
🚫 Rechazado	Caso descartado por el gestor

Desde la cola puedes Procesar, Rechazar o Reintentar cada caso. Al procesar, el sistema genera el modelo 3D y notifica al cirujano por email.

Si el estudio subido contiene varias series (habitual cuando alguien externo al equipo sube el estudio completo sin descartar series irrelevantes), el modal de procesado muestra un selector de serie principal — por defecto se sugiere la de más cortes, pero puedes elegir otra antes de procesar.

Abrir un caso en el visor

Desde la pestaña 📁 Casos del dashboard, haz clic en Abrir visor en cualquier caso con estado Listo. El visor se abre en una nueva pestaña.

También puedes recibir un enlace directo con el formato /?s=TOKEN. Ábrelo en cualquier navegador moderno.

⚠ El enlace incluye datos clínicos. No lo publiques en canales públicos. Caduca automáticamente a los 30 días.

En la lista de casos del visor (columna izquierda), al hacer hover sobre un caso aparecen botones ＋3D y ＋TC para añadir contenido adicional.

Navegación 3D

Cámara de rotación libre (trackball, como Meshmixer/Blender): no hay un eje "arriba" fijo, así que se puede girar el modelo en cualquier dirección sin topes.

Rotar (libre, cualquier eje): clic izquierdo + arrastrar
Zoom: rueda del ratón / pellizco táctil
Desplazar: clic derecho + arrastrar, o Ctrl + clic izquierdo (o dos dedos en táctil)
Centrar vista: botón Centrar vista al pie del panel — siempre devuelve una vista recta, sin el giro libre acumulado

ViewCube

El cubo en la esquina superior derecha permite saltar a vistas predefinidas: TOP FRONT L R BACK BOT. Entre FRONT y sus cuatro vecinas hay flechas (↑ ↓ ← →) que giran la cámara un pequeño paso (15°) en esa dirección desde la posición actual — pulsa varias veces para llegar a cualquier ángulo intermedio que no sea ninguno de los 6 ejes puros.

Separar órganos

El deslizador 💥 Separar órganos aleja las estructuras del centroide para verlas individualmente sin ocultarlas.

Estructuras

El panel derecho lista todas las estructuras agrupadas por categoría (Tumor, Vísceras, Vasos, Huesos…).

Ojo 👁: muestra u oculta la estructura.
Cuadrado de color: haz clic para elegir un color personalizado — se guarda con el caso.
Deslizador de opacidad: ajusta la transparencia de 0 a 100%.
Clic en el nombre: centra la vista en esa estructura y abre el tutor IA contextual.

Grupos

Crea grupos personalizados (p. ej. "Estructuras a resecar") para controlar la visibilidad de varias estructuras a la vez. Al añadir una estructura a un grupo (manual o auto-generado), se le aplica automáticamente una opacidad del 50% para poder ver varias estructuras superpuestas a la vez; al sacarla del grupo recupera opacidad total. Los grupos se guardan junto al caso y están disponibles para cualquiera que lo abra.

Al procesar un caso (subida directa o desde la cola de gestor/admin) puedes marcar «Agrupar estructuras automáticamente» — desactivado por defecto — para que el sistema cree un grupo por cada categoría anatómica presente (Tumor, Vísceras, Vasos, Huesos, Músculos, Nervioso) con la transparencia ya activada.

Volumen remanente

Selecciona un órgano y marca las estructuras a resecar. El sistema calcula el volumen funcional que quedaría tras la cirugía.

TC / Cortes radiológicos

Si el caso tiene un TC asociado, la sección 🩻 TC en 3D aparece en el panel. Superpone cortes axiales, coronales y sagitales sobre el modelo 3D.

Activa el plano deseado con el checkbox.
Desliza el control para recorrer los cortes.
Haz clic en el modelo 3D para localizar el punto en los tres planos simultáneamente.

Si el caso tiene varios estudios (TC + RMN), la sección 📂 Estudios del caso permite navegar entre ellos.

Herramientas clínicas

📏 Medir distancia

Haz clic en Medir y luego en dos puntos del modelo. La distancia aparece en pantalla y se puede guardar con un nombre.

📏 Margen mínimo tumor↔estructura

En la sección Herramientas, selecciona dos estructuras y pulsa Medir margen. El visor dibuja la distancia mínima en color según el riesgo:

Rojo — menos de 2 mm (contacto directo)
Amarillo — 2–5 mm (margen ajustado)
Verde — más de 5 mm (margen seguro)

🔴 Margen de resección

Visualiza el volumen de seguridad de 5 mm y 10 mm alrededor de la estructura seleccionada.

🔵 Simulación de clampaje

Selecciona un órgano y uno o varios vasos a clampear. El sistema calcula el territorio isquémico resultante y el volumen funcional comprometido.

⚠️ Contacto tumor↔estructuras

Analiza qué estructuras están en contacto con el tumor y a qué distancia mínima.

📍 Marcar punto

Clica en el modelo para fijar un pin con etiqueta. Los pines se guardan automáticamente.

🎥 Fly-through

Selecciona un vaso y pulsa Recorrer. La cámara viaja por el interior del vaso siguiendo la línea central real.

📷 Captura de pantalla

Guarda una captura del visor en la galería. Puedes descargarla o incluirla en el informe CSV.

🎥 Vistas guardadas

Guarda la posición de cámara actual con un nombre (p. ej. "Vista portal anterior") y recupérala con un clic.

📊 Exportar informe CSV

Genera un CSV con todas las mediciones, volúmenes y anotaciones del caso.

🗂 Versiones de escena

Guarda el estado visual del caso (visibilidad y opacidad de estructuras) como una versión numerada. Útil para presentar distintas propuestas quirúrgicas.

1

Ajusta la visibilidad y opacidad de las estructuras.

2

En la sección 🗂 Versiones, escribe un nombre y pulsa 💾.

3

El cirujano asignado recibe un email automático con enlace al caso.

4

Cualquier usuario puede restaurar versiones anteriores pulsando ↩.

💡 Solo Admin y Gestor ven todas las versiones; el resto solo las de sus casos asignados.

💬 Comentarios

Añade comentarios directamente en el visor. Son visibles para todos los usuarios con acceso al caso.

Escribe el texto del comentario (máx. 2.000 caracteres) y pulsa ▶ o Enter.

💡 Los comentarios quedan registrados en el log de auditoría con usuario, fecha y hora.

Compartir enlace

El enlace /?s=TOKEN abre el visor directamente sin login. Úsalo para compartir con otros miembros del equipo quirúrgico o con el paciente.

⚠ El enlace incluye datos clínicos. No lo publiques en canales públicos. Caduca a los 30 días.

Revisión radiológica

Pulsa 🔬 Enviar para revisión radiológica. El enlace especial se copia al portapapeles. El radiólogo puede validar estructuras y guardar su revisión sin modificar el caso original.

Gestión de usuarios Solo Admin

Dashboard → pestaña 👥 Usuarios. Muestra la tabla completa de cuentas con filtros y ordenación.

Crear usuario

Pulsa ＋ Nuevo usuario, rellena nombre, email, rol y contraseña inicial. El usuario podrá cambiar su contraseña en su próximo acceso.

Editar rol o desactivar

En cada fila de la tabla hay botones para cambiar el rol, desactivar la cuenta (invalida la sesión activa de inmediato) o extender el acceso de un invitado 30 días más.

Roles disponibles

Admin · Gestor · Radiólogo · Cirujano · Invitado

💡 Al desactivar un usuario su sesión queda invalidada en la siguiente petición al servidor, sin necesidad de esperar a que caduque el JWT.

Feature flags Solo Admin

Dashboard → pestaña ⚙ Features. Activa o desactiva funcionalidades del visor para cada rol en tiempo real, sin necesidad de redesplegar.

Flag	Funcionalidad
`ai_tutor`	Tutor IA contextual por estructura
`ai_assistant`	Asistente IA de caso completo (Gemini)
`flythrough`	Vuelo por el interior de vasos
`vr`	Modo visualización VR
`clampaje`	Simulación de clampaje vascular
`contacts`	Análisis contacto tumor↔estructuras
`remnant_volume`	Volumen remanente post-resección
`resection_margin`	Margen de resección 3D
`export_csv`	Exportar informe CSV
`tc_planes`	Cortes TC/RMN superpuestos en 3D
`review`	Revisión radiológica
`comments`	Comentarios en el visor
`versions`	Versiones de escena
`upload_study`	Añadir estudio TC/RMN adicional

Los cambios se aplican al siguiente inicio de sesión del usuario afectado.

Mantenimiento Solo Admin

Dashboard → pestaña 🔧 Mantenimiento. Gestiona los datos maestros del sistema sin necesidad de tocar código ni redesplegar.

🏥 Hospitales

Lista de hospitales asociables a los cirujanos. Cada hospital incluye nombre, provincia, municipio, dirección y CP. Los hospitales asignados aparecen en el perfil del cirujano y en los informes.

🔬 Especialidades quirúrgicas

Catálogo de especialidades disponibles para etiquetar los casos. Esta lista es la que aparece en el selector de especialidad al editar un caso y en los filtros de la tabla de casos.

🩺 Patologías

Catálogo de patologías/diagnósticos para clasificar los casos. Igual que las especialidades, se reflejan directamente en los filtros del dashboard.

💡 Cualquier cambio en estos catálogos se aplica de inmediato en todos los formularios y filtros del sistema, sin necesidad de reiniciar sesión.

Backlog / Kanban Admin Gestor

Dashboard → pestaña 📌 Backlog. Tablero Kanban para gestionar el desarrollo del producto. Accesible para Admin y Gestor.

Columnas del tablero

Columna	Significado
Backlog	Pendiente de planificar
▶ En curso	En desarrollo activo
🔍 Rev. Antonio	Pendiente de revisión por Antonio
🔍 Rev. Juan/Jesús	Pendiente de revisión por Juan o Jesús
✓ Hecho	Completado y cerrado

Mover tarjetas

Arrastra cualquier tarjeta entre columnas para cambiar su estado. El cambio se guarda automáticamente.

Filtros

Usa la barra de filtros para buscar por texto, filtrar por área (PLT, JES, CEL, PRD) o por responsable.

Crear / editar tarjetas

Haz clic en una tarjeta para editarla. Usa el botón ＋ Nueva tarjeta para crear una entrada nueva.

Auditoría Solo Admin

Dashboard → enlace 📋 Auditoría en la cabecera. Muestra el registro completo de todas las acciones del sistema almacenadas en PostgreSQL.

Filtros disponibles

Por email de usuario
Por tipo de acción (login, acceso a caso, comentario, etc.)
Por recurso afectado
Por rango de fechas

Exportar

Pulsa ⬇ Exportar CSV para descargar hasta 500 registros con los filtros activos. Útil para informes de cumplimiento.

💡 Los registros se conservan 365 días por defecto (configurable por el administrador técnico).

Backup Solo Admin

Dashboard → botón 💾 Backup en la cabecera. Descarga un archivo ZIP con todos los casos, modelos, metadatos y configuración del sistema.

⚠ El ZIP contiene datos clínicos. Almacénalo en un lugar seguro y cifrado. No compartas el archivo sin cifrar.

El backup excluye los archivos crudos de subida (carpeta raw/) para reducir el tamaño. Para un backup completo, contacta con el equipo técnico.

🤖 Asistente IA

Tutor contextual por estructura

Haz clic en el nombre de cualquier estructura en el panel. El tutor IA muestra información clínica relevante: función anatómica, relevancia quirúrgica y precauciones de resección.

Asistente de caso completo

El botón 🤖 (esquina inferior izquierda del visor) abre un chat que conoce el contexto completo del caso: estructuras, volúmenes, mediciones. Puedes hacerle preguntas en lenguaje natural o compartir una captura del visor para que la analice.

💡 El asistente IA es orientativo. Contrasta siempre con bibliografía clínica actualizada y el criterio médico del equipo.

⚠ Límite de uso: 30 consultas por hora por usuario. Contacta con el administrador si necesitas ampliar el límite.

Preguntas frecuentes

El botón de Acceder no hace nada

Prueba en una ventana de incógnito (Ctrl+Shift+N / Cmd+Shift+N). Si funciona, el problema es caché del navegador: haz Cmd+Shift+R (Mac) o Ctrl+Shift+R (Windows) para forzar recarga completa.

El dashboard aparece en blanco

La sesión ha caducado o es inválida. Ve a /login.html, borra el almacenamiento local del navegador si es necesario (DevTools → Application → Local Storage → Clear All) y vuelve a iniciar sesión.

El enlace del caso dice "caducado"

Los enlaces duran 30 días por normativa RGPD. Contacta al equipo de Eureqa para que genere un nuevo enlace.

El modelo tarda en cargar

Los modelos 3D de alta resolución pueden tardar 5–20 segundos. El TC puede tardar más según el tamaño del estudio. Una vez cargado, la navegación es fluida.

No veo algunas secciones del visor

Es posible que el administrador haya desactivado esa funcionalidad para tu rol. Contacta con el administrador del sistema si crees que debería estar disponible.

¿Puedo usar el visor en el móvil?

Sí. Compatible con Safari (iOS) y Chrome (Android). La navegación táctil funciona con un dedo para rotar y dos dedos para zoom/desplazar.

¿Cómo añado un segundo TC o una RMN al caso?

Desde el visor, haz hover sobre el caso en la lista izquierda y pulsa ＋TC. O ve a /subir.html, tab Añadir, sub-tab 🩻 Estudio TC/RMN.

¿Dónde están mis datos? ¿Quién tiene acceso?

Los datos se almacenan en servidores de Railway (UE). Solo tienen acceso los usuarios con cuenta activa en el sistema. Consulta la Política de privacidad para más detalle.

Contacto

Para incidencias, solicitudes o nuevas cuentas: aquintas@gmail.com