Interfacce utente sanitarie

Una guida per i team che realizzano software clinico con Lily: portali clinici, risultati e referti, prescrizione e somministrazione dei farmaci, supporto decisionale e dashboard ospedaliere.

Questa traduzione è una bozza automatica non revisionata. La pagina in inglese è la versione di riferimento.

Cosa fa Lily e cosa non fa

Lily vi offre contratti di visualizzazione: markup semantico, ARIA, comportamento da tastiera e hook di classe per ciò che le schermate cliniche ripetono. Non vi offre logica clinica, contenuti clinici né una dichiarazione regolatoria.

Cosa offre Lily e cosa offrite voi
Lily offre Voi offrite
observation-view: un valore, un'unità, un indicatore a parole, un intervallo e gli stati mancanti Il valore, la decisione sull'indicatore, l'intervallo di riferimento
allergy-record-list e allergy-record-list-item: uno stato che non è mai vuoto Il registro delle allergie e la sua terminologia
medication-view: nome, dosaggio, forma, via e frequenza, nulla troncato I dati sul farmaco, i segmenti tall man, il dosaggio formattato
decision-support-card: la forma di scheda di CDS Hooks Le regole, le azioni suggerite, la registrazione dell'esito
early-warning-score-view: un punteggio, una fascia e un'escalation, mostrati Il sistema di punteggio e il suo calcolo validato
age-view e ageParts(): un'età nelle unità adatte Le parole per le unità (Intl.DurationFormat o le vostre etichette)
formatQuantity(): 5 mg, mai 5,0 mg; 0,5 mg, mai ,5 mg Il numero, l'unità e la locale
La composizione del banner del paziente Ogni etichetta e ogni valore, e chi può vedere le informazioni cliniche

Normativa. Un software che calcola un punteggio, un percentile, una dose o un'interazione tra farmaci è di solito un dispositivo medico. Lily non calcola nulla di tutto ciò, di proposito. Se il vostro prodotto è regolamentato, spetta a voi il suo fascicolo di ingegneria dell'usabilità (IEC 62366-1, le linee guida della FDA sui fattori umani, il MDR dell'UE). I test di Lily, il suo rapporto di conformità di accessibilità autovalutato e la sua matrice dei lettori di schermo possono essere prove in quel fascicolo; nessuno di essi è una dichiarazione di conformità, e la matrice non ha ancora risultati.

Avvisi: interrompere solo per ciò che è critico

L'affaticamento da avvisi è un problema di sicurezza: quando ogni avviso interrompe, si finisce per ignorarli tutti. L'AHRQ raccomanda di graduare gli avvisi per gravità e di rendere interruttivi solo quelli gravi.

  • Informazione (indicator="info"): in linea, accanto all'attività, una scheda di supporto decisionale nella pagina.
  • Avvertenza (indicator="warning"): visibile senza bloccare, la stessa scheda, con uno stile che la faccia risaltare; nessuna finestra modale.
  • Critico (indicator="critical"): mettete la scheda in una finestra di dialogo di allerta e offrite overrideReasons in modo che chiuderla richieda un motivo.
  • Una scheda di supporto decisionale non è mai di per sé una regione live. Annunciate una nuova scheda critica spostando il focus nella finestra di dialogo, non con aria-live.
  • Rimuovete una scheda quando l'evento a cui rispondeva si ripete, e registrate ogni esito (accettata, oppure ignorata con il suo motivo).

Errori di paziente: identificare, non limitare

  • Mostrate due identificativi ovunque compaiano i dati di un paziente: il nome con la data di nascita, e l'identificativo nazionale con il suo componente di visualizzazione (The Joint Commission, Quick Safety 45).
  • Usate il banner del paziente in ogni schermata che agisce sulla cartella di un paziente, e tenetelo visibile.
  • Prima di un'azione su una cartella diversa da quella nel banner, fatela confermare con nome, data di nascita e identificativo.
  • Una voce che riguarda qualcuno diverso dal paziente (l'anamnesi di un genitore, un feto, un donatore) dice prima di chi è, a parole: date agli elementi della cartella un subjectLabel («Madre»), così che la diagnosi di un familiare non venga mai letta come quella del paziente (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Non limitate quante cartelle può aprire un clinico: uno studio randomizzato su 3.356 clinici (JAMA, 2019) ha rilevato che non riduceva le prescrizioni al paziente sbagliato, e le persone lo aggirano.
  • Un menu di azioni su una cartella nomina prima quella cartella, con subjectLabel su context-menu o dropdown-menu («Ada Lovelace, pressione arteriosa 3 nov»): una prima parte non interattiva che è anche il nome accessibile del menu.
  • Classificate ogni azione in base a ciò che fa, e rendete il livello visibile prima che venga eseguita. Di routine (visualizzare, stampare) viene eseguita subito. Documentata dice che cosa scriverà nella cartella («Aggiunge una nota all'incontro»). Clinica (sospendere, annullare una prescrizione) chiede una seconda conferma, in un alert-dialog il cui pulsante di conferma è il verbo («Sospendi»), mai «OK» o «Sì». Divulgativa (accesso d'emergenza, condivisione fuori dall'équipe di cura) chiede prima un motivo e lo registra.
  • Quando sono aperte più cartelle (schede, finestre, riquadri affiancati), il testo visibile e il nome accessibile di ogni scheda includono il nome del paziente e un secondo identificativo, il riquadro attivo ripete il banner, e nessuna azione si applica a un paziente diverso da quello del suo riquadro.
  • Mostrate come testo nell'intestazione della pagina il luogo a cui verranno attribuite le registrazioni (il reparto, l'ambulatorio o la struttura scelti all'accesso), e rendete il cambio un'azione esplicita.
  • Mostrate nel banner la visita attiva, o «Nessuna visita attiva». Un modulo che richiede una visita lo dice e propone di avviarne una, invece di fallire al salvataggio.

Il banner del paziente

La composizione è documentata con medical-banner, con una pagina funzionante in /patient-banner nell'app di esempio SvelteKit:

  • due identificativi, e l'età accanto alla data di nascita;
  • le allergie tramite un elenco delle allergie, così che «nessuna allergia nota», «non registrato» e «non disponibile» non si somiglino mai;
  • un valore mancante si scrive a parole («Non noto»), mai con un punto interrogativo, un trattino o una cella vuota;
  • un paziente deceduto: data-deceased per il tema, e una riga di testo visibile, mai il solo colore;
  • nessun campo troncato, tagliato o nascosto a qualsiasi larghezza; va a capo.
  • le segnalazioni del paziente («Serve un interprete», «Rischio infettivo») sono un tag-group etichettato di parole, mai icone o colore da soli, e restano visibili quando il banner va a capo.

Risultati

  • Un'unica visualizzazione per un risultato, qualunque sia il sistema di provenienza: la vista dell'osservazione.
  • L'indicatore è fatto di parole della vostra traduzione (flagLabel), con il codice di interpretazione FHIR come data-interpretation per il tema.
  • Separate i nuovi risultati da quelli precedenti e mostrate un andamento (una sparkline, o un grafico a linee con la sua tabella dati): i clinici cercano un cambiamento significativo, non solo l'intervallo.
  • Un risultato mai registrato e uno non disponibile sono stati diversi, con parole diverse.
  • Sconosciuto non è normale. Un risultato il cui intervallo di riferimento manca, è ancora in caricamento o illeggibile non ha interpretazione e lo dice; observation-view non ne deduce mai una, quindi un risultato con un intervallo e senza interpretation non mostra alcun segnale.
  • Un risultato fuori scala è il limite dello strumento con un comparatore («> 33,3 mmol/L»: formatQuantity con ">") e il vostro segnale critico, mai un numero nudo. Un valore approssimato mantiene il suo ≈ ("~").
  • Date altri intervalli con nome («Critico: sotto 2,5») come ranges, ciascuno come parte a sé.
  • Un risultato corretto o modificato conserva il valore che ha sostituito, in un <del>, con le vostre parole su quando è cambiato (previousValue, previousLabel), così che il clinico che ha letto il vecchio valore sappia che è cambiato.
  • Una misurazione su un intervallo dice la sua durata e funzione («Media, 24 ore»), e lo stato e il metodo di una misurazione («Seduto, bracciale grande») sono testo visibile accanto, mai solo un tooltip (openEHR INTERVAL_EVENT, state, protocol).
  • Un andamento richiede punti confrontabili: non tracciate alcuna linea sotto il vostro minimo, interrompete la linea dove è cambiato il metodo o il dosaggio, e dite direzione e significato a parole («in calo, in miglioramento»).
  • I parametri vitali inseriti in un sistema di unità possono mostrare l'altro accanto, come vostro testo («70 kg (154 lb)»); Lily non converte nulla, quindi dichiarate il vostro arrotondamento. Inserite una quantità con quantity-input-div, il cui numero segue i limiti di ciascuna unità.
  • Una curva di crescita è un line-chart con le vostre linee dei percentili come serie, i punti del bambino e la sua tabella di dati di età e valore; Lily non calcola percentili e non fornisce riferimenti di crescita.

Farmaci

  • Nomi generici in minuscolo, salvo le lettere tall man degli elenchi di FDA e ISMP o del vostro paese (Australia e Canada pubblicano i propri). Marcatele in nameSegments; Lily non le indovina mai.
  • Scrivete il dosaggio con formatQuantity: nessuno zero finale, uno zero iniziale, uno spazio indivisibile prima dell'unità.
  • Conservate il comparatore di un risultato: formatQuantity(5, "mmol/L", locale, "<") scrive «<5 mmol/L». Il Quantity.comparator di FHIR si scrive <, ≤, ≥ o >; ometterlo trasforma «meno di 5» in «5».
  • Scrivete mL, mai cc, ed evitate ogni abbreviazione dell'elenco ISMP delle abbreviazioni soggette a errore.
  • Non troncate mai il nome o la dose di un farmaco.

Date e orari

  • Scrivete il mese in lettere, così che una data non possa essere letta in due modi (Intl.DateTimeFormat con month: "short").
  • Scegliete l'orologio di proposito: passate hourCycle in modo esplicito. Il NHS chiede l'orologio a 24 ore; è una regola britannica, non mondiale, quindi Lily non la sceglie mai per voi.
  • Le età seguono le fasce della Common User Interface tramite ageParts(); un servizio con un'altra convenzione fornisce le proprie parole.
  • Una data nota solo fino al mese o all'anno resta tale: chiedetela con date-field precision="month" o "year", memorizzate 2019-03 o 2019e scrivetela con formatPartialDate(). Non inventate mai un giorno.
  • Una durata è duration-view, un <time datetime="P3DT4H"> che contiene le vostre parole, da durationParts() e Intl.DurationFormat.

Dashboard

  • Un tabellone di reparto o lo schermo di una centrale operativa si aggiorna spesso. Non annunciate mai ogni cambiamento: mantenete una sola regione di riepilogo cortese («3 letti liberi, 2 dimissioni previste») e lasciate che le persone leggano il tabellone.
  • Ogni stato su un tabellone (letto pulito, occupato, bloccato) è testo o uno stato data-* con parole, mai il solo colore.
  • Nulla lampeggia (WCAG 2.2.2, 2.3.1), e un tabellone che si aggiorna a tempo ha un comando di pausa o si aggiorna solo su richiesta; gli aggiornamenti non spostano mai il focus. Una voce in ritardo lo dice a parole («In attesa da oltre 20 minuti») con data-overdue.
  • Un conteggio o un tasso mostra il suo denominatore («12 su 68») e rimanda all'elenco che lo sostiene.
  • Un elenco o una cronologia dice di che cosa è una vista: che cosa mostra, il suo ordine e il suo periodo, che cosa è nascosto e perché, e quali fonti non hanno risposto. Un elenco vuoto da una fonte che non ha risposto non prova che non esista nulla.
  • Un elenco di promemoria è un record-list i cui elementi hanno una data di scadenza (review-date) e uno stato di scadenza a parole, con data-due; la regola che lo ha prodotto è vostra.

Moduli

  • Una domanda con risposta «sì», «no» o «non chiesto» è un radio-group di tre risposte, nessuna scelta all'inizio, mai una casella di controllo: una casella non distingue «negato» da «mai chiesto». Una revisione per sistemi è un fieldset per apparato, e un pulsante «tutti gli altri assenti» imposta solo quelli senza risposta.
  • Una domanda con un elenco di risposte (farmaci, indirizzi) è un repeatable-fieldset: un elemento viene aggiunto o rimosso, il focus segue, e ogni pulsante di rimozione porta il nome del suo elemento.
  • Un numero con la virgola decimale: mostratelo con Intl.NumberFormat e, dove type="number" non accetta la virgola, raccoglietelo in un campo di testo con inputmode="decimal" e analizzatelo nel vostro codice. Non cambiate mai un valore digitato dalla persona, nemmeno per riportarlo in un intervallo: un valore fuori intervallo è un errore che può vedere.
  • Un lungo elenco che mostra solo una parte delle opzioni alla volta imposta aria-setsize e aria-posinset su ogni opzione, e ricorda che la ricerca nella pagina non vede il resto.

Cartelle, note e la loro provenienza

  • Dite di che cosa è una vista un elenco o una griglia prima delle righe: il periodo e l'ordine, che cosa esclude e perché, e quali fonti non hanno risposto («Ultimi 12 mesi, prima i più recenti. La cartella del medico di base non ha risposto.»). Date a record-list e a timeline-list un coverageLabel, e all'helper data-grid il suo coverageLabel. Un elenco vuoto da una fonte che non ha risposto lo dice a parole, così non viene mai letto come «nulla registrato».
  • Dite da dove viene una registrazione e se è definitiva con record-provenance-view: firmata, in attesa di firma, modificata, salvata su questo dispositivo e non ancora inviata. Una bozza non firmata non deve mai sembrare firmata.
  • Una voce che riguarda qualcun altro (un genitore, un feto, un donatore) dice prima di chi è, con il subjectLabel.
  • Una voce trattenuta resta nell'elenco con le vostre parole («Riservato: non disponibile per te»), e una voce inserita per errore resta barrata con «Inserito per errore»: date a record-list-item o timeline-list-item un entryState e un entryStateLabel. Non rimuovete mai nessuna delle due in silenzio, perché un vuoto viene letto come «non è successo nulla».
  • In una nota clinica, indicate la fonte di ogni passaggio (digitato, dettato, modello, copiato da una nota precedente, generato) con data-source e parole visibili, così che un testo copiato o generato non venga mai preso per la visita di oggi.
  • Una sezione che non si carica è unavailable con le vostre parole, con un pulsante per riprovare; un codice tecnico, se mostrato, sta dietro un elemento espandibile. Un errore causato da un'azione della persona viene annunciato, con il valore che la cartella ora contiene; un errore al caricamento della pagina no.
  • La storia di una prescrizione è un timeline-list, un elemento per fase (pianificata, programmata, attiva, sospesa, completata, annullata) con ora e motivo, e lo stato attuale anche sull'elemento.

Da FHIR a Lily

Lily non legge le risorse FHIR; il vostro codice le associa alle props di Lily. Queste tabelle associano l'HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). L'associazione dei codici è un suggerimento: la decide la vostra revisione di sicurezza clinica, e le parole per ogni stato sono vostre.

Sezioni dell'IPS e componenti Lily corrispondenti
Sezione dell'IPS Lily
Allergie e intolleranze (48765-2) allergy-record-list e le sue voci
Riepilogo dei farmaci (10160-0) medication-record-list, con ogni voce che contiene un medication-view
Elenco dei problemi (11450-4) problem-record-list e le sue voci
Immunizzazioni (11369-6) immunization-record-list e le sue voci
Risultati (30954-2) observation-view, in una tabella di dati o in un elenco riepilogativo
Storia delle procedure (47519-4) procedure-record-list e le sue voci
Dispositivi medici (46264-8) device-record-list e le sue voci
Avvisi (104605-1) Un testo di avvertenza o un avviso, mai dietro un controllo compresso
Qualsiasi altra sezione record-list e le sue voci
Una sezione obbligatoria che il documento omette L'elenco della sezione con status="omitted"
Codici FHIR e valori Lily corrispondenti
FHIR Lily
emptyReason nilknown Il status="none-known" dell'elenco
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", con parole che dicano quale
I codici IPS no-known-allergies, no-known-medications e simili status="none-known"
I codici IPS no-allergy-info, no-medication-info e simili status="not-recorded"
AllergyIntolerance.criticality criticality, distinto dal severity di una reazione
clinicalStatus, verificationStatus Le stesse props sulle voci di allergia e di problema, con gli stessi codici
MedicationStatement.status Il status della voce del farmaco
Dosage.text medication-view dosageText
Observation.status observation-view status, con gli stessi codici
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (anche sugli elenchi delle cartelle)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Associate un record entered-in-error al suo stato entered-in-error, con parole, invece di scartarlo in silenzio: se mostrarlo o meno è una decisione del vostro servizio.

Da openEHR a Lily

Nemmeno Lily legge le composizioni openEHR. La corrispondenza per i tipi di dati e i codici del modello di riferimento openEHR, come suggerimento su cui decide la vostra revisione di sicurezza clinica:

Tipi di dati e codici openEHR, e i valori Lily corrispondenti
openEHR Lily
DV_QUANTITY (inserimento) quantity-input-div; unità come codici UCUM con le vostre parole
DV_QUANTITY (visualizzazione), magnitude_status observation-view con formatQuantity(value, unit, locale, comparator) (~ è ≈)
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 parziale (anno, anno e mese) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view con durationParts()
DV_PROPORTION formatProportion() dentro observation-view
DV_ORDINAL, DV_SCALE un radio-group le cui etichette riportano il numero e le sue parole
DV_CODED_TEXT lo schema dei valori codificati qui sotto
DV_BOOLEAN checkbox-input, solo quando «non chiesto» non può accadere
ELEMENT.null_flavour 253 sconosciuto, 271 nessuna informazione status="not-recorded" o "unavailable", con parole che dicano quale
null_flavour 272 mascherato observation-view status="masked"
null_flavour 273 non applicabile status="not-applicable"
PARTY_RELATED soggetto subjectLabel sugli elementi della cartella
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Fasi della macchina a stati delle istruzioni un timeline-list di fasi, con lo stato attuale sull'elemento
un elemento di archetipo con occorrenze 0..* repeatable-fieldset

Valori codificati

  • Mostrate Coding.display; se manca, CodeableConcept.text; se mancano entrambi, system|code. Mai una cella vuota.
  • Offrite un controllo che mostri il sistema di codifica e il codice accanto a ogni valore, come un pulsante a interruttore che dica «Mostra i codici». I codici nascosti restano fuori dall'ordine di lettura finché non sono mostrati.
  • Contrassegnate il testo clinico con la lingua del documento (lang), che può differire da quella dell'interfaccia. Traducete l'interfaccia; non traducete mai il contenuto clinico.
  • Lily non fornisce alcuna terminologia: nessuna ricerca in SNOMED CT, LOINC, ATC o UCUM. Scrivete ciò che dice il documento. La pagina /patient-summary dell'esempio SvelteKit mostra il modello.

Cosa Lily non farà

  • Calcolare un punteggio di allerta precoce, un percentile di crescita, una dose o un intervallo di riferimento.
  • Fornire una banca dati dei farmaci, un elenco tall man, o codici SNOMED CT, ICD, LOINC o UCUM.
  • Riprodurre uno strumento sotto licenza (Wong-Baker FACES) o il design di un altro ente (la scheda NEWS2).
  • Limitare il numero di cartelle aperte contemporaneamente.
  • Dedurre un'interpretazione da un intervallo, convertire un'unità o interpretare una data relativa («martedì prossimo»).
  • Usare un interruttore per «sì, no o sconosciuto»: lo switch di ARIA non ha un terzo stato, quindi sono tre pulsanti di opzione.

La ricerca, le fonti e le decisioni alla base di questa guida sono in spec/healthcare-ui.