Manual de Usuario – RespirApp

© 2025 RespirApp. Todos los derechos reservados.

1. Consideraciones Generales

RespirApp es una plataforma gamificada diseñada para el entrenamiento respiratorio en población pediátrica mediante el uso de un sensor de flujo MBMED acoplado al dispositivo FluxMed GrH. El software integra módulos de adquisición de señal, juegos terapéuticos, gestión de usuarios y generación de reportes clínicos. Este manual describe las funciones principales para administradores, profesionales y pacientes, y provee enlaces a tutoriales en video que muestran el uso de cada componente.

1.1. Requisitos del Sistema

  • Sistema operativo: Windows 10 o superior.
  • Python 3.10+ instalado.
  • Sensor de flujo MBMED® conectado al equipo FluxMed GrH.
  • Accesorios necesarios: boquilla espirométrica, filtro HME, clip nasal y, de ser necesario, adaptadores 3D.
  • Conexión USB disponible para establecer comunicación serie.
Dispositivo FluxMed GrH

Figura 1: Equipo FluxMed GRH.

1.2. Uso de Boquillas, Filtros y Adaptadores

Para garantizar mediciones respiratorias precisas, seguras y reproducibles, es indispensable utilizar correctamente los accesorios complementarios del sensor de flujo. A continuación se detallan los elementos necesarios según el diseño del hardware descrito en el documento técnico de RespirApp.

1.2.1. Boquillas

El sensor requiere el uso de una boquilla espirométrica para asegurar un sellado adecuado y evitar fugas durante la inspiración y espiración. Existen dos tipos compatibles:

Boquilla espirométrica rígida Boquillas descartables

Figura 2: Boquillas de espirometría.

1.2.2. Filtro HME

El filtro HME debe colocarse entre el sensor y la boquilla. Su función es:

El uso del filtro es obligatorio para preservar la integridad del equipo y asegurar la consistencia de los datos.

Filtro HME

Figura 3: Filtro HME.

1.2.3. Clip Nasal

Para obtener mediciones correctas en maniobras espiratorias o de apneas, el paciente debe utilizar un clip nasal. Este evita fugas de aire por la nariz y asegura que todo el flujo sea dirigido hacia el sensor, aumentando la validez de los parámetros obtenidos (como PEF, flujo espiratorio sostenido o inspiratorio).

Clip nasal

Figura 4: Clip nasal para espirometrías.

1.2.4. Adaptadores 3D

En casos donde el paciente no pueda utilizar las boquillas estándar, RespirApp provee adaptadores diseñados en 3D para:

Su empleo solo es necesario cuando la boquilla estándar no genera un sellado adecuado.

Adaptadores 3D

Figura 5: Adaptadores impresos en 3D.


2. Gestión de Usuarios

2.1. Perfiles de Usuario

RespirApp cuenta con tres tipos de usuarios, cada uno con permisos específicos:
Administrador: gestiona profesionales, pacientes, permisos y configuraciones globales.
Profesional: asigna rutinas, crea ejercicios, visualiza resultados y genera reportes.
Paciente: ejecuta rutinas asignadas.

2.2. Inicio de Sesión

Al iniciar la aplicación, aparecerá la pantalla principal donde podrá ingresar con usuario y contraseña. Si es la primera vez, el administrador deberá crear las cuentas correspondientes desde el menú de configuración.

2.3. Editar Perfil

Permite modificar datos personales, nombre, email o credenciales del usuario.

Tutorial: Editar Perfil

2.4. Cambiar Contraseña

Funcionalidad disponible para todos los usuarios desde el menú de configuración. Incluye validación segura y hashing.

Tutorial: Cambiar Contraseña

2.5. Agregar Profesional

Opción disponible sólo para el administrador. Permite cargar un nuevo profesional al sistema.

Tutorial: Agregar Profesional

2.6. Buscar / Editar Profesional

El administrador puede visualizar, filtrar y editar la información de profesionales existentes.

Tutorial: Buscar / Editar Profesional

2.7. Agregar Paciente

Disponible para administrador y profesional. Permite registrar nuevos pacientes.

Tutorial: Agregar Paciente

2.8. Reasignar Pacientes a Otros Profesionales

El administrador con permisos ampliados pueden reasignar un paciente a otro profesional en caso de cambios en la estructura del equipo, rotación médica o necesidad de derivación. Esta función garantiza la continuidad del tratamiento y permite que el nuevo profesional acceda inmediatamente al historial, rutinas, informes y observaciones del paciente.

Para reasignar un paciente, se debe acceder a la sección “Ver Paciente”, seleccionar “Editar Profesional Asignado” y elegir el nuevo profesional de la lista disponible. Una vez confirmada la reasignación, el sistema actualiza automáticamente la relación profesional–paciente.

Tutorial: Reasignar Pacientes

3. Rutinas y Ejercicios

3.1. Crear Rutina

El profesional puede generar una rutina combinando ejercicios basados en los juegos terapéuticos. Cada ejercicio incluye parámetros como duración, umbrales de flujo y niveles de dificultad.

Tutorial: Crear Rutina

3.2. Ejecutar Rutina

El paciente accede a la sección “Iniciar Rutina”, donde se presentan los juegos en el orden definido por su profesional. Los resultados se guardan automáticamente y son accesibles para el profesional.

Ejecutar rutina

Figura 6: Pantalla de ejecutar rutina.

3.3. Resultados y Reportes

Los resultados de cada juego (curvas de flujo, métricas respiratorias, tiempo de apnea, PEF, etc.) se almacenan en formato JSON.B y pueden exportarse a PDF. El profesional puede visualizar el progreso del paciente a través de gráficas comparativas y reportes clínicos.

3.4. Ver / Guardar Informes

La plataforma permite que el profesional visualice informes generados tras cada rutina o sesión. En estos informes se incluyen datos clave como curvas de flujo, valores de PEF, tiempos de apnea y resultados de los juegos. Además, existe la opción de exportar y guardar los informes en formato PDF para facilitar su impresión, archivado o envío a terceros intervinientes.

Tutorial: Ver / Guardar Informes

4. Juegos

RespirApp incluye cuatro juegos diseñados sobre parámetros respiratorios validados.

4.1. Barco al Viento

Entrena flujo inspiratorio laminar. El paciente debe inhalar de manera lenta y constante para avanzar el barco.

Demo: Barco al Viento
Barco al Viento

Figura 7: Pantalla de inicio – Barco al Viento.

4.2. Soplo Antillamas

Evaluación pico de flujo espiratorio (PEF) y espiración rápida. El objetivo es apagar llamas generadas de manera aleatoria en tres niveles diferentes.

Demo: Soplo Antillamas
Soplo Antillamas

Figura 8: Pantalla de inicio – Soplo Antillamas.

4.3. PulmoRiders

Entrena tiempo de apnea controlada. El jugador mantiene un período de apnea para avanzar en una carrera animada.

Demo: PulmoRiders
PulmoRiders

Figura 9: Pantalla de inicio – PulmoRiders.

4.4. Gira Gira

Entrena flujo espiratorio sostenido. El paciente debe mantener un soplo continuo para girar el molino.

Demo: Gira Gira
Gira Gira

Figura 10: Pantalla de inicio – Gira Gira.


5. Configuración del Sensor

El sensor debe conectarse vía USB antes de iniciar una rutina. El sistema detectará automáticamente el puerto y comenzará a recibir datos de flujo. Es necesario la calibración del sensor previo al comienzo de la rutina para que los datos obtenidos sean correctos.

Calibración del sensor

Figura 11: Calibración del sensor.


6. Resolución de Problemas

A continuación se presentan las incidencias más comunes y sus posibles soluciones:


7. Contacto y Soporte

Para soporte técnico, reportes de error o consultas relacionadas con el uso del sistema, puede comunicarse con el equipo desarrollador o con el profesional responsable del dispositivo.

Email soporte: soporte@respirapp.com
Desarrollador: Equipo RespirApp – 2025