Por qué existe este manual
La función Pre-consulta 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.
1. Antes de la consulta: imprimir el cartel QR del día
- Abre el Doctor PWA (
irehab-doctor.pages.dev) e inicia sesión - Cambia a la pestaña "Pre-consulta"
- Arriba a la derecha, toca "Imprimir QR de hoy"
- Se abre una vista previa A4 → 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
- El cartel muestra el nombre del médico que atiende ese día. Reimprime cuando cambie de médico
- 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 pre-consulta
Tras enviar el formulario, el registro aparece en tu cola "Pre-consulta" 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:
┌──────────────────────────┐
│ 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
AIza... - 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
AIza...→ 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 AIza... 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 pre-consulta → 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