Brief — Manual de operaciones para el médico

Por qué existe este manual

La función Brief de iRehab parte de un principio de diseño: la IA no está aquí para escribir prosa por ti — está aquí para devolverte tiempo. Cuando el paciente se sienta, la pantalla ya tiene un resumen estructurado. No gastas cinco minutos recogiendo datos básicos — los inviertes escuchando, explorando, decidiendo. El razonamiento completo está en Resumen previo a la consulta: cuando el paciente no sabe si es tendón o nervio.

Este manual es para el médico que usa la función. Imprímelo y pégalo cerca del escritorio.

Antes de empezar: configuración inicial

Todo lo que sigue a partir de la sección 1 asume que tu cuestionario ya está en funcionamiento. Si es la primera vez que lo configuras, sigue primero estos seis pasos — unos 15 minutos, con algunos pasos gestionados por nuestro equipo.

Lo diseñamos a propósito como pruébalo antes de comprometerte: primero rellenas el cuestionario una vez como lo haría un paciente (o revisas primero un borrador), y solo lo activas de verdad cuando te convence. No hace falta firmar contrato ni pagar para llegar hasta ahí.

Consigue una cuenta (solo por invitación). iRehab funciona por invitación. Contacta al equipo de De Novo: activaremos tu cuenta de médico con tu email y te enviaremos un enlace de invitación para el registro. Si tu especialidad necesita un cuestionario personalizado (por ejemplo, el caso de Ginecología y Obstetricia, que fusiona tres formularios — ginecología, obstetricia y uroginecología — en uno solo), primero te mostraremos una página de revisión para repasarla pregunta por pregunta; recogemos tus decisiones y lo finalizamos (normalmente con una o dos rondas de ajustes).
Registra tu cuenta de médico. Abre el enlace de invitación y completa tus datos en doctor.denovortho.com/#/register (el email debe coincidir con el de la invitación; indica tu especialidad con precisión). ⚠️ Usa siempre el enlace de invitación — si abres la página de registro por separado, faltará el código de invitación.
Confirma tu cuestionario en Composer. Inicia sesión en el Doctor PWA, abre Composer y revisa cada campo comparándolo con la versión que definiste.
Genera un QR en el Centro de distribución. Cuando todo esté correcto, ve al Centro de distribución, genera un código QR del cuestionario e imprímelo para tu consulta o recepción. (Un cartel es reutilizable — no hace falta reimprimirlo cada día; ver la sección 1 más abajo.)
Pruébalo tú mismo (dogfooding). Escanea tu propio QR con el móvil y rellena el cuestionario de principio a fin como lo haría un paciente. Es tu última comprobación antes de activarlo del todo — verás exactamente cómo es la experiencia real del paciente.
Vuelve a la pestaña Brief para ver el resultado. Tu envío de prueba aparecerá en la cola de Brief unos 30 segundos después — ábrelo, y ese es el resumen estructurado que verás con pacientes reales. Cuando te parezca correcto, ya está listo; el uso diario empieza en la sección 1.

Una vez configurado, la rutina diaria es sencilla: los pacientes escanean el QR del cartel y rellenan el formulario, y tú lees la cola de Brief de un vistazo (secciones 1 y 2 más abajo).

1. Antes de la consulta: genera tu póster QR en el Centro de distribución

Abre el Doctor PWA (doctor.denovortho.com) e inicia sesión
Ve a la pestaña Centro de distribución
Localiza la plantilla de cuestionario de tu especialidad
Pulsa Generar QR del cartel
Pulsa Imprimir cartel A4 para abrir la vista previa A4, luego imprime o guarda como PDF

Notas:

Imprime desde un ordenador de la clínica si puedes, el diseño queda más limpio. Safari en iPhone a veces descuadra — si solo tienes el móvil, guarda PDF y luego imprime
Un póster es reutilizable (por defecto ~200 usos o 60 días); caduca automáticamente al alcanzar el límite, y se puede regenerar o revocar en cualquier momento
Colócalo donde los pacientes lo vean fácilmente — sala de espera o recepción. Si no saben escanear, el personal de recepción puede ayudar

2. Cómo leer la cola de Brief

Tras enviar el formulario, el registro aparece en tu cola "Brief" en unos 30 segundos. Cada tarjeta muestra:

Nombre + año de nacimiento + sexo (en niños pequeños se muestra "X años Y meses")
Motivo de consulta en una línea — palabras del paciente, literal
Puntuación VAS de dolor (0–10)
Etiqueta de tipo de sensación (dolor / entumecimiento / debilidad / varios / otro)
Barra roja de aviso — aparece si la combinación de síntomas merece atención extra; mira esos primero
Etiqueta ⚠️ Búsqueda manual — el registro se recuperó de la cola de otro médico mediante código; haz algunas preguntas extra

Al expandir la tarjeta verás el borrador completo en dos formatos:

Resumen telegráfico — copia con un toque para pegar en la línea S del HIS (R't knee, B/L, F/M/N)
Párrafo redactado — para informes de IRB o cartas de derivación

3. Árbol de decisión durante la consulta

Al final de cada visita, pulsa un botón de cierre. Tres opciones:

Botón de cierre	Lo que hace el sistema
Seguimiento (conserv.)	Paciente entra en la lista de seguimiento iRehab; VAS + GROC se envían 3 días antes de la revisión
Cirugía o rehabilitación	Crea un registro formal de atención; eliges la vía (TKA / THA / Hombro / Rehab general)
Cerrar (sin seguimiento)	Registro conservado 180 días para consulta futura; el sistema no envía más notificaciones

Cada botón muestra un cuadro de confirmación listando lo que el sistema hará a continuación — confirma antes de que se ejecute.

4. Búsqueda manual con código de confirmación

Cuándo usarla:

Tu cola parece vacía pero el paciente insiste en haber rellenado
El paciente te da un código PC-XXXXXX
Cubres a otro médico (el paciente escaneó el QR del otro)
Ayuda entre consultas

Cómo:

Arriba a la derecha de la cola, toca "⊕ Búsqueda manual"
Introduce los 6 caracteres que te lee el paciente: PC- [ _ _ _ _ _ _ ] (no distingue mayúsculas; si lo pegan desde LINE, el sistema lo limpia)
Enviar → el registro entra en tu cola con la etiqueta ⚠️ Búsqueda manual
Si el registro original pertenecía a otro médico, la tarjeta muestra "Médico original: XXX" — recordatorio de que no es tu paciente de siempre, pregunta más

Limitación: solo dentro del mismo hospital. No hay búsqueda entre hospitales.

5. Preguntas frecuentes

P: El paciente dice que lo rellenó, pero mi cola está vacía. ¿Qué hago? R: Primero, comprueba el tiempo — de envío a aparición son unos 30 segundos. ¿Sigue sin aparecer? Pide el código PC-XXXXXX y usa la búsqueda manual (sección 4).

P: ¿Y los caracteres confundibles como O y 0? R: El sistema los excluye a propósito (no aparecen O / 0 / I / 1 en los códigos generados). Lo que el paciente te lee no será ambiguo.

P: Cubro a la Dra. X. ¿Qué pasa con su cola? R: Usa la sección 4 para traer el registro a tu cola con el código. La tarjeta marcará "Médico original: X". Cierra como siempre — el registro de atención se atribuirá correctamente a ti, pues eres quien vio al paciente.

P: El paciente rellenó la mitad y se fue. ¿Qué pasa? R: El registro queda en estado "no enviado" y no entra en la cola. Si vuelve y reescanea el mismo QR con el mismo móvil, el sistema reanuda desde el último paso.

P: Pulsé "Cerrar" por error — ¿cómo deshago? R: Los registros cerrados se conservan 180 días. Abre el registro, arriba a la derecha pulsa "Reabrir" y elige "Seguimiento" o "Cirugía o rehabilitación". Se crea un nuevo registro; el cierre original queda marcado "retirado".

P: ¿Qué significa la barra roja de aviso? R: Las respuestas del paciente coinciden con una combinación que el sistema marca para atención extra (ej.: "debilidad + empeora + persistente"). No es un diagnóstico, solo te recuerda confirmar esos síntomas de alarma durante el examen. Si es realmente urgente lo decides tú.

6. Traducción con IA (opcional) — Trae tu propia clave Gemini (BYOK)

Función opcional. Si no la habilitas, el uso diario no cambia; simplemente verás el motivo de consulta en el idioma original del paciente sin traducción automática. Es el diseño BYoAI (Bring-your-own-AI): el médico usa su propia cuota de la API de Gemini, con un coste (muy bajo) a su cargo. Los servidores de iRehab no retienen ninguna respuesta del LLM.

Cuándo habilitarla

Recibes con regularidad pacientes no hispanohablantes nativos (vietnamitas, indonesios, japoneses, coreanos, inglés…)
Quieres un botón de un toque para traducir el motivo en idioma extranjero a un idioma que leas con facilidad

Configuración (5 minutos)

Paso 1 — Consigue una clave en Google AI Studio

En el navegador → https://aistudio.google.com/app/apikey
Inicia sesión con tu cuenta de Google (usa una personal, no la del hospital)
Pulsa "Create API key" → obtendrás una cadena que empieza por AQ.Ab...
No cierres la pestaña aún; copia esa cadena

Paso 2 — Confirma que la facturación está activa (crítico)

Pulsa la nueva clave → o la barra lateral izquierda "Billing" → habilita la facturación
Incluso en el nivel gratuito, Google exige una tarjeta de crédito en el proyecto antes de darte cuota normal
Sin facturación, el registro fallará (verás "quota exceeded")

Paso 3 — Registra la clave en Doctor PWA

Cambia a la pestaña "✨ AI" abajo (no a Profile; la configuración BYOK se movió de Profile a la pestaña AI)
Busca la tarjeta "BYOK Gemini Key"
Pulsa "Habilitar e introducir clave"
Lee la nota de propósito → Continuar
Marca los tres consentimientos (los datos van a Google, el hospital lo permite, iRehab no es responsable de lo que Google haga) → Continuar
Pega AQ.Ab... → pulsa "Guardar clave"
El éxito muestra un indicador verde "Configurada (activa)"

Errores de registro frecuentes

Error	Por qué	Cómo arreglarlo
Formato no válido	Copia-pega con espacios extra o caracteres faltantes	Recopia el `AQ.Ab...` completo
Clave no válida o revocada	La clave fue borrada o tiene permisos restringidos	Regénerala en AI Studio
Cuota agotada	Cuota de Google disparada	Espera 1–2 min / confirma facturación / rota la clave
Error de respuesta de Google	Respuesta mal formada de Google	Espera 1 min; si persiste, avisa a ingeniería
Servicio temporalmente no disponible	KMS de iRehab transitoriamente no disponible	Espera 1 min y reintenta
Demasiados intentos	Más de 20 registros en una hora	Espera 1 hora

Cómo usarla tras habilitarla

Expande una tarjeta de paciente en la cola de Brief → el área Path B mostrará un botón "Traducir motivo" (solo aparece cuando el idioma del motivo ≠ el idioma de tu UI). Al pulsarlo se envía el texto a tu propia API de Gemini; en segundos aparece una traducción de una línea en la tarjeta.

Importante:

La traducción es un apoyo a la lectura; no sobrescribe la línea S del HIS. La línea S sigue pegándose con el resumen telegráfico original
El texto original del paciente se conserva al 100% en el registro — sin modificar, sin resumir, sin reescribir
La traducción corre solo cuando pulsas — no se dispara automáticamente. Tú decides cuándo traducir

Garantías de seguridad (IT del hospital puede preguntar)

Tu clave nunca sale de tu navegador + backend de iRehab; no entra en logs, mensajes de error ni sistemas de soporte
El backend almacena con Google KMS envelope encryption (doble envoltorio); ni siquiera los ingenieros de iRehab pueden desencriptarla directamente
Cada desencriptación de clave escribe un Google Cloud Audit Log (el uso anómalo es rastreable)
Los servidores de iRehab no retienen contenido de respuesta del LLM; la traducción solo se muestra en tu navegador
Puedes pulsar "Quitar clave" en la pestaña AI en cualquier momento — el secreto cifrado se borra inmediatamente
Los registros históricos de uso se conservan para auditoría; no se eliminan

Qué decirle a IT del hospital

Los datos viajan por HTTPS a la API de Google Gemini (generativelanguage.googleapis.com)
Cada petición lleva solo el texto del motivo de consulta del paciente — sin nombre, DNI ni número de historia
Política de retención de Google en esta ruta: vía API comercial, no se usa para entrenar modelos (garantizado contractualmente)
Si la política del hospital lo prohíbe, IT puede notificar al jefe de servicio y deshabilitaremos la función para toda la institución desde el backend