Interfaces de usuario sanitarias

Una guía para los equipos que crean software clínico con Lily: portales clínicos, resultados e informes, prescripción y administración de medicamentos, apoyo a la decisión y paneles hospitalarios.

Esta traducción es un borrador automático sin revisar. La página en inglés es la versión de referencia.

Lo que Lily hace y lo que no

Lily le ofrece contratos de presentación: marcado semántico, ARIA, comportamiento de teclado y ganchos de clase para lo que las pantallas clínicas repiten. No le ofrece lógica clínica, contenido clínico ni una declaración regulatoria.

Lo que ofrece Lily y lo que ofrece usted
Lily ofrece Usted ofrece
observation-view: un valor, una unidad, un indicador en palabras, un intervalo y los estados ausentes El valor, la decisión del indicador, el intervalo de referencia
allergy-record-list y allergy-record-list-item: un estado que nunca está vacío El registro de alergias y su terminología
medication-view: nombre, concentración, forma, vía y frecuencia, sin truncar nada Los datos del medicamento, los segmentos tall man, la concentración formateada
decision-support-card: la forma de tarjeta de CDS Hooks Las reglas, las acciones sugeridas, el registro del resultado
early-warning-score-view: una puntuación, un nivel y una escalada, mostrados El sistema de puntuación y su cálculo validado
age-view y ageParts(): una edad en las unidades adecuadas Las palabras para las unidades (Intl.DurationFormat o sus propias etiquetas)
formatQuantity(): 5 mg, nunca 5,0 mg; 0,5 mg, nunca ,5 mg El número, la unidad y la configuración regional
La composición del banner del paciente Cada etiqueta y cada valor, y quién puede ver la información clínica

Regulación. El software que calcula una puntuación, un percentil, una dosis o una interacción farmacológica suele ser un producto sanitario. Lily no calcula nada de esto, a propósito. Si su producto está regulado, a usted le corresponde su expediente de ingeniería de usabilidad (IEC 62366-1, la guía de factores humanos de la FDA, el MDR de la UE). Las pruebas de Lily, su informe de conformidad de accesibilidad autoevaluado y su matriz de lectores de pantalla pueden servir de evidencia en ese expediente; ninguno es una declaración de conformidad, y la matriz aún no tiene resultados.

Alertas: interrumpir solo por lo crítico

La fatiga de alertas es un problema de seguridad: cuando cada alerta interrumpe, se acaban descartando todas. La AHRQ recomienda jerarquizar las alertas por gravedad y hacer interruptivas solo las graves.

  • Información (indicator="info"): integrada, junto a la tarea, una tarjeta de apoyo a la decisión en la página.
  • Advertencia (indicator="warning"): visible sin bloquear, la misma tarjeta, con un estilo que destaque; sin ventana modal.
  • Crítica (indicator="critical"): ponga la tarjeta dentro de un diálogo de alerta y ofrezca overrideReasons para que al descartarla se pida un motivo.
  • Una tarjeta de apoyo a la decisión nunca es por sí misma una región en vivo. Anuncie una nueva tarjeta crítica moviendo el foco al diálogo, no con aria-live.
  • Retire una tarjeta cuando vuelva a producirse el evento al que respondía, y registre cada resultado (aceptada, o anulada con su motivo).

Errores de paciente: identificar, no restringir

  • Muestre dos identificadores dondequiera que aparezcan datos de un paciente: el nombre con la fecha de nacimiento, y el identificador nacional con su componente de visualización (The Joint Commission, Quick Safety 45).
  • Use el banner del paciente en cada pantalla que actúe sobre la historia de un paciente, y manténgalo visible.
  • Antes de una acción sobre una historia distinta de la del banner, confírmela con el nombre, la fecha de nacimiento y el identificador.
  • Una entrada sobre alguien que no es el paciente (los antecedentes de un progenitor, un feto, un donante) dice primero de quién es, con palabras: da a los elementos del registro un subjectLabel («Madre»), para que el diagnóstico de un familiar nunca se lea como el del paciente (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • No limite cuántas historias puede abrir un profesional clínico: un ensayo aleatorizado con 3356 profesionales (JAMA, 2019) halló que no reducía las órdenes al paciente equivocado, y la gente lo esquiva.
  • Un menú de acciones sobre un registro nombra primero ese registro, con subjectLabel en context-menu o dropdown-menu («Ada Lovelace, tensión arterial 3 nov.»): una primera parte no interactiva que es también el nombre accesible del menú.
  • Clasifica cada acción por lo que hace y haz visible su nivel antes de que se ejecute. Rutinaria (ver, imprimir) se ejecuta al momento. Documentada dice qué escribirá en el registro («Añade una nota al encuentro»). Clínica (suspender, cancelar una orden) pide confirmación una segunda vez, en un alert-dialog cuyo botón de confirmación es el verbo («Suspender»), nunca «Aceptar» ni «Sí». Divulgadora (acceso de emergencia, compartir fuera del equipo asistencial) pide primero un motivo y lo registra.
  • Cuando hay varios registros abiertos (pestañas, ventanas, paneles divididos), el texto visible y el nombre accesible de cada pestaña incluyen el nombre del paciente y un segundo identificador, el panel activo repite el banner y ninguna acción se aplica a un paciente distinto del de su panel.
  • Muestra como texto en la cabecera de la página el lugar al que se atribuirán los registros (la planta, consulta o centro elegido al iniciar sesión), y haz que cambiarlo sea una acción explícita.
  • Muestra la visita activa, o «Sin visita activa», en el banner. Un formulario que necesita una visita lo dice y ofrece iniciarla, en lugar de fallar al guardar.

El banner del paciente

La composición está documentada en medical-banner, con una página funcional en /patient-banner en la aplicación de ejemplo de SvelteKit:

  • dos identificadores, y la edad junto a la fecha de nacimiento;
  • las alergias mediante una lista de alergias, para que «sin alergias conocidas», «no registrado» y «no disponible» nunca se parezcan;
  • un valor ausente se escribe con palabras («Desconocido»), nunca con un signo de interrogación, un guion o una celda vacía;
  • un paciente fallecido: data-deceased para el tema, y una línea de texto visible, nunca solo el color;
  • ningún campo truncado, recortado u oculto a ningún ancho; se ajusta a la línea siguiente.
  • los avisos del paciente («Necesita intérprete», «Riesgo de infección») son un tag-group etiquetado de palabras, nunca iconos ni color solos, y siguen visibles cuando el banner salta de línea.

Resultados

  • Una sola presentación para un resultado, venga del sistema que venga: la vista de observación.
  • El indicador son palabras de su traducción (flagLabel), con el código de interpretación de FHIR como data-interpretation para el tema.
  • Separe los resultados nuevos de los anteriores y muestre una tendencia (un minigráfico, o un gráfico de líneas con su tabla de datos): los profesionales buscan un cambio significativo, no solo el intervalo.
  • Un resultado que nunca se registró y uno que no está disponible son estados distintos, con palabras distintas.
  • Desconocido no es normal. Un resultado cuyo intervalo de referencia falta, aún se está cargando o no se puede leer no tiene interpretación y lo dice; observation-view nunca la deduce, así que un resultado con intervalo y sin interpretation no muestra ninguna marca.
  • Un resultado fuera de escala es el límite del instrumento con un comparador («> 33,3 mmol/L»: formatQuantity con ">") y tu marca de valor crítico, nunca un número suelto. Un valor aproximado conserva su ≈ ("~").
  • Da otros intervalos con nombre («Crítico: por debajo de 2,5») como ranges, cada uno en su propia parte.
  • Un resultado corregido o modificado conserva el valor que sustituyó, en un <del>, con tus palabras sobre cuándo cambió (previousValue, previousLabel), para que el clínico que leyó el valor anterior sepa que cambió.
  • Una medición de intervalo dice su duración y función («Media, 24 horas»), y el estado y el método de una medición («Sentado, manguito grande») son texto visible a su lado, nunca solo una información emergente (openEHR INTERVAL_EVENT, state, protocol).
  • Una tendencia necesita puntos comparables: no dibujes línea por debajo de tu mínimo, corta la línea donde cambió el método o el ensayo, y di la dirección y el significado con palabras («bajando, mejorando»).
  • Las constantes introducidas en un sistema de unidades pueden mostrar el otro al lado, como texto tuyo («70 kg (154 lb)»); Lily no convierte nada, así que indica tu redondeo. Introduce una cantidad con quantity-input-div, cuyo número toma los límites de cada unidad.
  • Una curva de crecimiento es un line-chart con tus líneas de percentiles como series, los puntos del niño y su tabla de datos de edad y valor; Lily no calcula ningún percentil ni incluye referencias de crecimiento.

Medicamentos

  • Nombres genéricos en minúsculas, salvo las letras tall man de las listas de la FDA y del ISMP o de su país (Australia y Canadá publican las suyas). Márquelas en nameSegments; Lily nunca las adivina.
  • Escriba la concentración con formatQuantity: sin cero final, con cero inicial, con un espacio de no separación antes de la unidad.
  • Conserve el comparador de un resultado: formatQuantity(5, "mmol/L", locale, "<") escribe «<5 mmol/L». El Quantity.comparator de FHIR se escribe <, ≤, ≥ o >; omitirlo convierte «menos de 5» en «5».
  • Escriba mL, nunca cc, y evite todas las abreviaturas de la lista de abreviaturas propensas a errores del ISMP.
  • Nunca trunque el nombre ni la dosis de un medicamento.

Fechas y horas

  • Escriba el mes con letras para que una fecha no pueda leerse de dos maneras (Intl.DateTimeFormat con month: "short").
  • Elija el reloj a propósito: pase hourCycle de forma explícita. El NHS pide el reloj de 24 horas; es una norma británica, no mundial, así que Lily nunca lo elige por usted.
  • Las edades siguen los tramos de la Common User Interface mediante ageParts(); un servicio con otra convención aporta sus propias palabras.
  • Una fecha conocida solo hasta el mes o el año se queda así: pídela con date-field precision="month" o "year", guarda 2019-03 o 2019y escríbela con formatPartialDate(). Nunca inventes un día.
  • Una duración es duration-view, un <time datetime="P3DT4H"> que contiene tus palabras, a partir de durationParts() y Intl.DurationFormat.

Paneles

  • Un tablero de planta o una pantalla de centro de mando se actualiza a menudo. Nunca anuncie cada cambio: mantenga una sola región de resumen cortés («3 camas libres, 2 altas previstas») y deje que la gente lea el tablero.
  • Cada estado de un tablero (cama limpia, ocupada, bloqueada) es texto o un estado data-* con palabras, nunca solo el color.
  • Nada parpadea (WCAG 2.2.2, 2.3.1), y un panel que se actualiza con un temporizador tiene un control de pausa o solo se actualiza a petición; las actualizaciones nunca mueven el foco. Una entrada atrasada lo dice con palabras («Esperando más de 20 minutos») con data-overdue.
  • Un recuento o una tasa muestra su denominador («12 de 68») y enlaza a la lista que hay detrás.
  • Una lista o una cronología dice de qué es una vista: qué muestra, su orden y su periodo, qué se oculta y por qué, y qué fuentes no respondieron. Una lista vacía de una fuente que no respondió no prueba que no exista nada.
  • Una lista de recordatorios es una record-list cuyos elementos llevan una fecha de vencimiento (review-date) y un estado de vencimiento con palabras, con data-due; la regla que la produjo es tuya.

Formularios

  • Una pregunta que se responde «sí», «no» o «no preguntado» es un radio-group de tres respuestas, ninguna elegida al principio, nunca una casilla: una casilla no distingue «negado» de «nunca preguntado». Una revisión por sistemas es un fieldset por aparato, y un botón «todos los demás ausentes» marca solo los que no tienen respuesta.
  • Una pregunta con una lista de respuestas (medicamentos, direcciones) es un repeatable-fieldset: se añade o quita un elemento, el foco lo sigue y cada botón de quitar lleva el nombre de su elemento.
  • Un número con coma decimal: muéstralo con Intl.NumberFormat y, donde type="number" no acepte la coma, tómalo en un campo de texto con inputmode="decimal" y analízalo en tu código. Nunca cambies un valor que la persona escribió, ni siquiera para ajustarlo a un intervalo: un valor fuera de intervalo es un error que puede ver.
  • Una lista larga que solo muestra parte de sus opciones a la vez establece aria-setsize y aria-posinset en cada opción, y recuerda que la búsqueda en la página no ve el resto.

Registros, notas y su procedencia

  • Di de qué es una vista una lista o una cuadrícula antes de sus filas: su periodo y su orden, qué deja fuera y por qué, y qué fuentes no respondieron («Últimos 12 meses, primero lo más reciente. La historia de atención primaria no respondió.»). Da a record-list y a timeline-list un coverageLabel, y al ayudante data-grid su coverageLabel. Una lista vacía de una fuente que no respondió lo dice con palabras, para que nunca se lea como «nada registrado».
  • Di de dónde viene un registro y si es definitivo con record-provenance-view: firmado, pendiente de firma, modificado, guardado en este dispositivo y aún no enviado. Un borrador sin firmar nunca debe parecer firmado.
  • Una entrada sobre otra persona (un progenitor, un feto, un donante) dice primero de quién es, con el subjectLabel.
  • Una entrada retenida sigue en la lista con tus palabras («Restringido: no disponible para ti»), y una entrada introducida por error sigue tachada con «Introducido por error»: da a record-list-item o timeline-list-item un entryState y un entryStateLabel. Nunca quites ninguna de las dos en silencio, porque un hueco se lee como «no pasó nada».
  • En una nota clínica, marca la fuente de cada fragmento (tecleado, dictado, plantilla, copiado de una nota anterior, generado) con data-source y palabras visibles, para que un texto copiado o generado nunca se tome por la exploración de hoy.
  • Una sección que no puede cargarse es unavailable con tus palabras, con un botón de reintentar; un código técnico, si se muestra, va detrás de un desplegable. Un fallo causado por una acción de la persona se anuncia, con el valor que ahora tiene el registro; un fallo al cargar la página, no.
  • El historial de una orden es una timeline-list, un elemento por paso (planificada, programada, activa, suspendida, completada, cancelada) con su hora y su motivo, y el estado actual también en el elemento.

De FHIR a Lily

Lily no lee recursos FHIR; su código los asigna a las props de Lily. Estas tablas asignan el HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). La asignación de códigos es una sugerencia: la decide su revisión de seguridad clínica, y las palabras de cada estado son suyas.

Secciones del IPS y los componentes de Lily correspondientes
Sección del IPS Lily
Alergias e intolerancias (48765-2) allergy-record-list y sus elementos
Resumen de medicación (10160-0) medication-record-list, con cada elemento conteniendo un medication-view
Lista de problemas (11450-4) problem-record-list y sus elementos
Inmunizaciones (11369-6) immunization-record-list y sus elementos
Resultados (30954-2) observation-view, en una tabla de datos o una lista de resumen
Historial de procedimientos (47519-4) procedure-record-list y sus elementos
Dispositivos médicos (46264-8) device-record-list y sus elementos
Alertas (104605-1) Un texto de advertencia o una alerta, nunca detrás de un control plegado
Cualquier otra sección record-list y sus elementos
Una sección obligatoria que el documento omite La lista de la sección con status="omitted"
Códigos FHIR y los valores de Lily correspondientes
FHIR Lily
emptyReason nilknown El status="none-known" de la lista
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", con palabras que indiquen cuál
Los códigos IPS no-known-allergies, no-known-medications y similares status="none-known"
Los códigos IPS no-allergy-info, no-medication-info y similares status="not-recorded"
AllergyIntolerance.criticality criticality, aparte del severity de una reacción
clinicalStatus, verificationStatus Las mismas props en los elementos de alergia y de problema, con los mismos códigos
MedicationStatement.status El status del elemento de medicación
Dosage.text medication-view dosageText
Observation.status observation-view status, con los mismos códigos
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (también en las listas de registros)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Asigne un registro entered-in-error a su estado entered-in-error, con palabras, en lugar de descartarlo en silencio: si se muestra o no es una decisión de su servicio.

De openEHR a Lily

Lily tampoco lee composiciones de openEHR. La correspondencia para los tipos de datos y códigos del modelo de referencia de openEHR, como una sugerencia que decide tu revisión de seguridad clínica:

Tipos de datos y códigos de openEHR, y sus valores en Lily
openEHR Lily
DV_QUANTITY (entrada) quantity-input-div; unidades como códigos UCUM con tus palabras
DV_QUANTITY (visualización), magnitude_status observation-view con formatQuantity(value, unit, locale, comparator) (~ es ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges con un meaning observation-view ranges
DV_DATE parcial (año, año y mes) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view con durationParts()
DV_PROPORTION formatProportion() dentro de observation-view
DV_ORDINAL, DV_SCALE un radio-group cuyas etiquetas llevan el número y sus palabras
DV_CODED_TEXT el patrón de valores codificados más abajo
DV_BOOLEAN checkbox-input, solo cuando «no preguntado» no puede ocurrir
ELEMENT.null_flavour 253 desconocido, 271 sin información status="not-recorded" o "unavailable", con palabras que indiquen cuál
null_flavour 272 enmascarado observation-view status="masked"
null_flavour 273 no aplicable status="not-applicable"
PARTY_RELATED sujeto subjectLabel en los elementos del registro
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Pasos de la máquina de estados de instrucciones una timeline-list de pasos, con el estado actual en el elemento
un elemento de arquetipo con ocurrencias 0..* repeatable-fieldset

Valores codificados

  • Muestre Coding.display; si no hay, CodeableConcept.text; si no hay ninguno, system|code. Nunca una celda vacía.
  • Ofrezca un control que revele el sistema de codificación y el código junto a cada valor, como un botón de alternancia que diga «Mostrar códigos». Los códigos ocultos quedan fuera del orden de lectura hasta que se muestran.
  • Marque el texto clínico con el idioma del documento (lang), que puede diferir del de la interfaz. Traduzca la interfaz; nunca traduzca el contenido clínico.
  • Lily no incluye terminología: ninguna consulta de SNOMED CT, LOINC, ATC o UCUM. Escriba lo que dice el documento. La página /patient-summary del ejemplo SvelteKit muestra el patrón.

Lo que Lily no hará

  • Calcular una puntuación de alerta temprana, un percentil de crecimiento, una dosis o un intervalo de referencia.
  • Incluir una base de datos de medicamentos, una lista tall man, ni códigos de SNOMED CT, CIE, LOINC o UCUM.
  • Reproducir un instrumento con licencia (Wong-Baker FACES) o el diseño de otro organismo (el gráfico NEWS2).
  • Limitar el número de historias abiertas a la vez.
  • Deducir una interpretación a partir de un intervalo, convertir una unidad o interpretar una fecha relativa («el martes que viene»).
  • Usar un interruptor para «sí, no o desconocido»: el switch de ARIA no tiene tercer estado, así que son tres botones de opción.

La investigación, las fuentes y las decisiones detrás de esta guía están en spec/healthcare-ui.