Manual — NefroSys Paciente
App de acompañamiento del paciente en hemodiálisis · se va completando a medida que se construye
¿Qué es NefroSys Paciente?
Es la app de acompañamiento para el paciente en hemodiálisis, parte del sistema NefroSys (no se vende por separado). El paciente ve un espejo de sus datos (próxima sesión, peso seco, última presión, acceso vascular), firma la recepción de sus documentos, avisa si no podrá asistir y aprende con una biblioteca educativa validada por su centro.
Proyecto y tablero de avance: NefroSys Paciente — Tablero. Diseño y mockups navegables en nefrosys-code/mockups/app-paciente/.
Estado de construcción
| Pieza | Qué hace | Estado |
|---|---|---|
| Diseño y mockups (V1 + V2) | 16 pantallas navegables, aprobadas por Andrés | Hecho |
| Base de datos (migr. 086) | Tablas del módulo + RLS por centro, sin acceso directo del paciente | Hecho |
| Identidad del paciente (migr. 087) | RPCs de generar/revocar activación, con entropía en el servidor | Hecho |
| Panel del centro — Activaciones | Esta pantalla: views/app-paciente-activaciones.html | Hecho |
| App del paciente — activación + Home + Mis datos | PWA instalable: activación con QR/código, onboarding, próxima sesión y datos en espejo | Hecho |
| Documentos y firma (migr. 089 + pantallas) | Catálogo del centro, entrega, firma con el dedo en la app, folio y comprobante verificable con QR | Hecho |
| Panel del centro — Documentos | views/app-paciente-documentos.html: catálogo + entregar + bandeja de firmas con evidencia | Hecho |
| Avisar inasistencia (app + bandeja) | El paciente avisa en 2 toques; el centro gestiona en views/app-paciente-inasistencias.html | Hecho |
| Biblioteca educativa "Aprender a cuidarme" | 7 artículos revisados contra Daugirdas/KDIGO; en la base como borrador, esperando validación clínica | En validación |
| Auditoría de seguridad final del módulo | Doble ronda con auditor especializado; corregida y APTO para producción | Hecho |
| Apariencia — modo día/noche, nombre completo, logo, premium | Toggle de tema persistente, saludo con nombre completo, logo NefroSys en splash/home, destellos al seleccionar | Hecho |
| Mis líquidos (migr. 095 + pantalla + ficha) | El paciente registra su ingesta diaria con botones rápidos y la compara con el límite que el nefrólogo escribió en la prescripción | Hecho |
Activar la app de un paciente
Se hace presencialmente, en el sillón, junto al paciente — nunca a distancia. La encuentras en NefroSys: menú lateral Pacientes → 📱 App Paciente (activaciones). Visible solo para administrador y enfermero coordinador.
Generar el código
Qué significa cada estado
| Estado | Significado |
|---|---|
| Sin activar | El paciente nunca ha recibido un código. |
| Código pendiente | Se generó un código y el paciente aún no lo usa. Puedes volver a mostrarlo con "Ver código". |
| App activada | El paciente ya activó su cuenta y puede usar la app. |
| Código vencido | Pasaron las 48 horas sin que se activara. Genera uno nuevo. |
| Revocada | Se le cortó el acceso (ver abajo). Puede reactivarse generando un código nuevo. |
Revocar el acceso
Úsalo si el paciente perdió el teléfono, egresó del centro, o hubo un error. Corta el acceso al instante: clic en "Revocar" junto al paciente activado, escribe el motivo y confirma. El paciente deberá reactivarse presencialmente si vuelve a necesitarla.
Documentos y firma
Es el corazón del valor de la app: el centro entrega sus documentos (consentimiento, derechos y deberes, cuidados, plan de emergencia…), el paciente los lee y firma con el dedo en su teléfono, y cada firma queda con folio y comprobante verificable con QR — evidencia lista para acreditación. La pantalla del centro está en el menú Pacientes → 📄 App Paciente (documentos), solo para administrador y enfermero coordinador.
1 · Crear el catálogo documental
2 · Entregar al paciente
Clic en "Entregar" junto al documento vigente, elige al paciente y confirma. El documento aparece al instante en su app con la insignia POR FIRMAR (y un punto rojo en su pantalla de inicio). El sistema no deja entregar dos veces la misma versión al mismo paciente.
En su teléfono, el paciente lo lee (con opción "Leer documento completo"), firma con el dedo, marca la declaración de recepción y confirma. Recibe su folio al instante y puede volver a ver su comprobante con QR cuando quiera.
3 · Bandeja de firmas y evidencia
La sección "Entregas y firmas" muestra cada entrega con su estado (Por firmar / Firmado), fechas y folio; puedes filtrar y buscar por paciente, RUT, documento o folio. En los firmados, "Ver evidencia" abre la imagen de la firma, el método, las fechas y el enlace a la verificación pública del comprobante — la misma página que ve un acreditador al escanear el QR, sin ningún dato de salud.
Avisos de inasistencia
Cuando un paciente sabe que no podrá venir, toca "No podré asistir" en su app: elige la sesión (le proponemos su próxima sesión real, o puede marcar otro día en el calendario), elige el motivo (salud, trámite médico, traslado, familiar, otro) y envía. Dos toques.
El aviso cae al instante en la bandeja del centro: menú Pacientes → 🔔 App Paciente (inasistencias). Ahí ves la sesión que perderá, el motivo y con cuánta anticipación avisó. Cuando ya contactaste al paciente y resolviste la recuperación de la sesión, clic en "Marcar gestionado" — queda registrado quién y cuándo lo gestionó.
Biblioteca educativa "Aprender a cuidarme"
En la app, el paciente encuentra 7 temas de autocuidado en lenguaje simple: cuidados de la fístula y del catéter, líquidos y sal, alimentación (potasio y fósforo), peso seco, signos de alarma y sus exámenes explicados. Cada uno abre una ficha con consejos y una caja de "cuándo avisar a tu centro".
El contenido evita a propósito dosis y cifras (litros de agua, gramos de sal, metas de laboratorio): eso es individual y lo define tu equipo. Todos los temas terminan derivando al centro ante cualquier duda.
Cómo publicar un artículo
En NefroSys, menú Pacientes → 📚 App Paciente (biblioteca). Verás los artículos con su estado: Borrador (no visible al paciente) o Publicado. Clic en "Revisar" para leer el artículo completo tal como lo verá el paciente, con su fuente clínica; si estás conforme, "Publicar para los pacientes" y aparece al instante en la app. Puedes "Despublicar" cuando quieras. Solo administrador y enfermero coordinador pueden publicar, verificado en el servidor.
Mis líquidos (registro de ingesta)
El paciente registra cada vez que toma líquido desde el botón "💧 Mis líquidos de hoy" del inicio, con botones rápidos (vaso ~200 ml · taza ~150 ml · botella ~500 ml) u "otra cantidad". Ve el total del día, la hora de cada toma, y puede deshacer un error (solo lo registrado hoy). El día corre de 00:00 a 00:00 hora de Chile, calculado siempre en el servidor.
El límite lo pone el equipo, en la ficha
En NefroSys, ficha del paciente → sección Prescripción → campo nuevo "Líquidos/día (ml)" (junto a UF base; también sale en la ficha impresa). Cuando el nefrólogo lo escribe, la app muestra una barra de avance contra ese límite:
- Verde-azulado: va bien (bajo el 80% del límite).
- Ámbar: "Cerca de tu límite de hoy" (80–100%).
- Rojo: "Sobre el límite de hoy — coméntalo con tu equipo". La app nunca regaña ni indica conducta: siempre deriva al equipo.
Apariencia: diseño "Cálido Humano", modo día/noche y marca
La app usa el diseño "Cálido Humano" (elegido entre 3 direcciones visuales): fondo marfil cálido, tipografía Nunito Sans y acento ámbar, pensado para que el paciente sienta la app cercana y no como un sistema hospitalario frío. Se adapta al tema del teléfono (claro u oscuro) y trae un botón propio (☀️/🌙) para elegir manualmente — la elección se recuerda.
- Saludo cálido: la mascota NefroSyn acompaña un saludo según la hora ("Buenos días / Buenas tardes / Buenas noches") con el nombre completo del paciente.
- Próxima sesión estilo ticket: tarjeta navy tipo "pase" con un talón que muestra cuántos días faltan (o "Hoy"), el turno y los días del esquema (Lun·Mié·Vie o Mar·Jue·Sáb). Todo sale de datos reales de la ficha — nada inventado.
- Consejo de hoy: una tarjeta que ofrece el artículo educativo que corresponde al paciente según su acceso vascular real (fístula → cuidados de la fístula; catéter → cuidados del catéter) y lo abre directo. Solo muestra artículos ya validados por el equipo.
- Logo NefroSys en la pantalla de carga y en Inicio — versión a color sobre fondo claro, contorno blanco sobre fondo oscuro.
- Detalles premium: destello suave al elegir opciones y brillo al presionar botones principales; se desactivan si el teléfono tiene "reducir movimiento".
Seguridad del módulo
- El paciente nunca ve datos de otro paciente, ni un centro ve pacientes de otro centro — reforzado en la base de datos, no solo en la pantalla.
- El código y el QR se generan con alta aleatoriedad en el servidor; nadie puede adivinarlos ni repetirlos. El token de sesión se guarda solo cifrado (nunca en claro).
- Activar y revocar la app es exclusivo de administrador y enfermero coordinador, verificado en el servidor: ningún otro usuario del centro puede emitir accesos ni firmar en lugar del paciente.
- El comprobante público solo muestra metadatos con el RUT enmascarado: nunca el nombre ni datos de salud. Cada firma queda ligada a un hash del documento firmado para su valor probatorio.
Qué viene después
Con documentos y firma funcionando, lo que sigue es: avisar inasistencia desde la app (el motor ya existe, falta la pantalla y la bandeja del centro), la biblioteca educativa validada, la auditoría de seguridad final del módulo completo, y publicar todo en www.nefrosys.cl. Sigue el avance en el tablero del proyecto.