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.
| 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 offriteoverrideReasonsin 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelsucontext-menuodropdown-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-dialogil 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-deceasedper 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-groupetichettato 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 comedata-interpretationper 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-viewnon ne deduce mai una, quindi un risultato con un intervallo e senzainterpretationnon mostra alcun segnale. -
Un risultato fuori scala è il limite dello strumento con un comparatore («> 33,3 mmol/L»:
formatQuantitycon">") 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-chartcon 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». IlQuantity.comparatordi 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.DateTimeFormatconmonth: "short"). - Scegliete l'orologio di proposito: passate
hourCyclein 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-fieldprecision="month"o"year", memorizzate2019-03o2019e scrivetela conformatPartialDate(). Non inventate mai un giorno. -
Una durata è
duration-view, un<time datetime="P3DT4H">che contiene le vostre parole, dadurationParts()eIntl.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-listi cui elementi hanno una data di scadenza (review-date) e uno stato di scadenza a parole, condata-due; la regola che lo ha prodotto è vostra.
Moduli
-
Una domanda con risposta «sì», «no» o «non chiesto» è un
radio-groupdi tre risposte, nessuna scelta all'inizio, mai una casella di controllo: una casella non distingue «negato» da «mai chiesto». Una revisione per sistemi è unfieldsetper 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.NumberFormate, dovetype="number"non accetta la virgola, raccoglietelo in un campo di testo coninputmode="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-setsizeearia-posinsetsu 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-liste atimeline-listuncoverageLabel, e all'helperdata-gridil suocoverageLabel. 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-itemotimeline-list-itemunentryStatee unentryStateLabel. 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-sourcee parole visibili, così che un testo copiato o generato non venga mai preso per la visita di oggi. -
Una sezione che non si carica è
unavailablecon 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.
| 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" |
| 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:
| 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-summarydell'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
switchdi 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.