Interfețe de utilizator pentru sănătate

Un ghid pentru echipele care construiesc software clinic cu Lily: portaluri clinice, rezultate și raportare, prescriere și administrare de medicamente, suport decizional și tablouri de bord spitalicești.

Traducerile acestei pagini sunt ciorne automate nerevizuite. Pagina în limba engleză este versiunea de referință.

Ce face Lily și ce nu face

Lily vă oferă contracte de afișare: markup semantic, ARIA, comportament la tastatură și puncte de acroșare pentru clase, pentru lucrurile care se repetă pe ecranele clinice. Nu vă oferă logică clinică, conținut clinic sau o declarație de conformitate reglementară.

Ce oferă Lily și ce oferiți dumneavoastră
Lily oferă Dumneavoastră oferiți
observation-view: o valoare, o unitate, un semnal în cuvinte, un interval și stările pentru valori lipsă Valoarea, decizia privind semnalul, intervalul de referință
allergy-record-list și allergy-record-list-item: un status care nu este niciodată gol Înregistrarea alergiei și terminologia ei
medication-view: denumire, concentrație, formă, cale și frecvență, nimic trunchiat Datele despre medicament, segmentele tall man, concentrația formatată
decision-support-card: forma cardului CDS Hooks Regulile, acțiunile sugerate, înregistrarea rezultatului
early-warning-score-view: un scor, o bandă și o escaladare, afișate Sistemul de scorare și calculul său validat
age-view și ageParts(): o vârstă în unități potrivite ei Cuvintele pentru unități (Intl.DurationFormat sau etichetele dumneavoastră)
formatQuantity(): 5 mg, niciodată 5,0 mg; 0,5 mg, niciodată ,5 mg Numărul, unitatea și localizarea
Compoziția bannerului pacientului Fiecare etichetă și valoare, și cine poate vedea informațiile clinice

Reglementare. Software-ul care calculează un scor, un centil, o doză sau o interacțiune medicamentoasă este de obicei un dispozitiv medical. Lily nu calculează nimic din acestea, intenționat. Dacă produsul dumneavoastră este reglementat, dumneavoastră răspundeți de dosarul de inginerie a utilizabilității (IEC 62366-1, ghidul FDA privind factorii umani, EU MDR). Testele Lily, raportul său autoevaluat de conformitate privind accesibilitatea și matricea sa de cititoare de ecran pot fi dovezi în acel dosar; niciuna nu este o declarație de conformitate, iar matricea nu are încă rezultate.

Alerte: întrerupeți doar pentru ce este critic

Oboseala față de alerte este o problemă de siguranță: când fiecare alertă întrerupe, oamenii le închid pe toate. Recomandarea AHRQ este să ierarhizați alertele după gravitate și să faceți întreruptive doar pe cele grave.

  • Informație (indicator="info"): în rând, lângă sarcină, un card de suport decizional în pagină.
  • Avertisment (indicator="warning"): vizibil fără a bloca, același card, stilizat să iasă în evidență; fără modal.
  • Critic (indicator="critical"): puneți cardul într-un dialog de alertă și oferiți overrideReasons, astfel încât închiderea lui să ceară un motiv.
  • Un card de suport decizional nu este niciodată, singur, o regiune live. Anunțați un nou card critic mutând focalizarea în dialog, nu prin aria-live.
  • Eliminați un card când evenimentul la care a răspuns se produce din nou și înregistrați fiecare rezultat (acceptat sau ignorat, cu motivul).

Erori de pacient: identificați, nu restricționați

  • Afișați doi identificatori oriunde apar datele unui pacient: numele cu data nașterii și identificatorul național cu componenta lui de vizualizare (The Joint Commission, Quick Safety 45).
  • Folosiți bannerul pacientului pe fiecare ecran care acționează asupra dosarului unui pacient și păstrați-l vizibil.
  • Înainte de o acțiune asupra unui dosar altul decât cel din banner, confirmați-o cu numele, data nașterii și identificatorul.
  • O înregistrare despre altcineva decât pacientul (istoricul unui părinte, un făt, un donator) spune mai întâi, în cuvinte, a cui este: dați elementelor dosarului un subjectLabel („Mama”), astfel încât diagnosticul unei rude să nu fie citit niciodată drept al pacientului (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Nu limitați câte dosare poate deschide un clinician: un studiu randomizat pe 3.356 de clinicieni (JAMA, 2019) a constatat că aceasta nu a redus comenzile pentru pacientul greșit, iar oamenii o ocolesc.
  • Un meniu de acțiuni asupra unui dosar numește mai întâi acel dosar, cu subjectLabel pe context-menu sau dropdown-menu („Ada Lovelace, tensiune arterială 3 nov.”): o primă parte neinteractivă, care este și numele accesibil al meniului.
  • Încadrați fiecare acțiune după ce face și faceți nivelul vizibil înainte să ruleze. De rutină (vizualizare, tipărire) rulează imediat. Documentată spune ce va scrie în dosar („Adaugă o notă la consultație”). Clinică (oprire, anularea unei prescripții) cere o a doua confirmare, într-un alert-dialog al cărui buton de confirmare este verbul („Oprește”), niciodată „OK” sau „Da”. Divulgatoare (acces de urgență, partajare în afara echipei de îngrijire) cere mai întâi un motiv și îl înregistrează.
  • Când sunt deschise mai multe dosare (file, ferestre, panouri împărțite), textul vizibil și numele accesibil al fiecărei file includ numele pacientului și un al doilea identificator, panoul activ repetă bannerul și nicio acțiune nu se aplică altui pacient decât celui din panoul său.
  • Afișați ca text în antetul paginii locul căruia i se vor atribui înregistrările (secția, cabinetul sau unitatea aleasă la autentificare) și faceți din schimbarea lui o acțiune explicită.
  • Afișați în banner vizita activă sau „Nicio vizită activă”. Un formular care are nevoie de o vizită spune asta și oferă să înceapă una, în loc să eșueze la salvare.

Bannerul pacientului

Compoziția este documentată la medical-banner, cu o pagină funcțională la /patient-banner în aplicația-exemplu SvelteKit:

  • doi identificatori și vârsta alături de data nașterii;
  • alergiile printr-o listă de alergii, astfel încât „fără alergii cunoscute”, „neînregistrat” și „indisponibil” să nu arate niciodată la fel;
  • o valoare lipsă este exprimată în cuvinte („Necunoscut”), niciodată printr-un semn de întrebare, o liniuță sau o celulă goală;
  • un pacient decedat: data-deceased pentru temă și o linie vizibilă de text, niciodată doar culoarea;
  • niciun câmp trunchiat, tăiat sau ascuns la nicio lățime; textul se rupe pe rânduri.
  • semnalările pacientului („Are nevoie de interpret”, „Risc de infecție”) sunt un tag-group etichetat de cuvinte, niciodată doar pictograme sau culoare, și rămân vizibile când bannerul se rupe pe rânduri.

Rezultate

  • O singură afișare pentru un rezultat, indiferent din ce sistem provine: vizualizarea observației.
  • Semnalul este formulat în cuvinte din traducerea dumneavoastră (flagLabel), cu codul de interpretare FHIR în data-interpretation pentru temă.
  • Separați rezultatele noi de cele anterioare și arătați o tendință (o sparkline sau o diagramă liniară cu tabelul ei de date): clinicienii caută o schimbare semnificativă, nu doar intervalul.
  • Un rezultat care nu a fost niciodată înregistrat și unul indisponibil sunt stări diferite, cu cuvinte diferite.
  • Necunoscut nu înseamnă normal. Un rezultat al cărui interval de referință lipsește, încă se încarcă sau este ilizibil nu are interpretare și spune asta; observation-view nu deduce niciodată una, așa că un rezultat cu interval și fără interpretation nu afișează niciun semnal.
  • Un rezultat în afara scalei este limita instrumentului cu un comparator („> 33,3 mmol/L”: formatQuantity cu ">") și semnalul dumneavoastră critic, niciodată un număr gol. O valoare aproximativă își păstrează ≈ ("~").
  • Dați alte intervale numite („Critic: sub 2,5”) ca ranges, fiecare ca parte proprie.
  • Un rezultat corectat sau modificat păstrează valoarea pe care a înlocuit-o, într-un <del>, cu cuvintele dumneavoastră despre când s-a schimbat (previousValue, previousLabel), astfel încât un clinician care a citit valoarea veche să știe că s-a schimbat.
  • O măsurătoare pe interval își spune durata și funcția („Medie, 24 de ore”), iar starea și metoda unei măsurători („Așezat, manșetă mare”) sunt text vizibil alături, niciodată doar o indicație (openEHR INTERVAL_EVENT, state, protocol).
  • O tendință are nevoie de puncte comparabile: nu trasați linie sub minimul dumneavoastră, întrerupeți linia unde s-a schimbat metoda sau analiza și spuneți direcția și sensul în cuvinte („în scădere, în ameliorare”).
  • Semnele vitale introduse într-un sistem de unități pot afișa celălalt alături, ca text al dumneavoastră („70 kg (154 lb)”); Lily nu convertește nimic, așa că precizați rotunjirea. Introduceți o cantitate cu quantity-input-div, al cărui număr respectă limitele fiecărei unități.
  • O curbă de creștere este un line-chart cu liniile dumneavoastră de percentile ca serii, punctele copilului și tabelul de date cu vârstă și valoare; Lily nu calculează percentile și nu livrează referințe de creștere.

Medicamente

  • Denumiri generice cu litere mici, cu excepția literelor tall man din listele FDA și ISMP sau din lista țării dumneavoastră (Australia și Canada își publică propriile liste). Marcați-le în nameSegments; Lily nu le ghicește niciodată.
  • Scrieți concentrația cu formatQuantity: fără zero final, cu zero inițial, cu un spațiu fix înainte de unitate.
  • Păstrați comparatorul unui rezultat: formatQuantity(5, "mmol/L", locale, "<") scrie „<5 mmol/L”. Quantity.comparator din FHIR se scrie <, ≤, ≥ sau >; dacă îl omiteți, „mai puțin de 5” devine „5”.
  • Scrieți mL, niciodată cc, și evitați orice abreviere din lista ISMP a abrevierilor predispuse la erori.
  • Nu trunchiați niciodată denumirea sau doza unui medicament.

Date și ore

  • Scrieți luna cu litere, astfel încât o dată să nu poată fi citită în două feluri (Intl.DateTimeFormat cu month: "short").
  • Alegeți ceasul în mod deliberat: transmiteți hourCycle explicit. NHS cere formatul de 24 de ore; aceasta este o regulă britanică, nu una mondială, așa că Lily nu îl alege niciodată în locul dumneavoastră.
  • Vârstele urmează benzile Common User Interface prin ageParts(); un serviciu cu altă convenție își transmite propriile cuvinte.
  • O dată cunoscută doar până la lună sau an rămâne așa: cereți-o cu date-field precision="month" sau "year", stocați 2019-03 sau 2019și scrieți-o cu formatPartialDate(). Nu inventați niciodată o zi.
  • O durată este duration-view, un <time datetime="P3DT4H"> care conține cuvintele dumneavoastră, din durationParts() și Intl.DurationFormat.

Tablouri de bord

  • Un panou de secție sau un ecran de centru de comandă se actualizează des. Nu anunțați niciodată fiecare schimbare: păstrați o regiune de rezumat politicoasă („3 paturi libere, 2 externări așteptate”) și lăsați oamenii să citească panoul.
  • Fiecare stare de pe un panou (pat curățat, ocupat, blocat) este text sau o stare data-* cu cuvinte, niciodată doar culoarea.
  • Nimic nu clipește (WCAG 2.2.2, 2.3.1), iar un panou actualizat după un temporizator are un buton de pauză sau se actualizează doar la cerere; actualizările nu mută niciodată focalizarea. O înregistrare întârziată spune asta în cuvinte („Așteaptă de peste 20 de minute”) cu data-overdue.
  • Un număr sau o rată își arată numitorul („12 din 68”) și duce la lista din spatele lui.
  • O listă sau o cronologie spune ce vedere este: ce arată, ordinea și perioada, ce este ascuns și de ce și ce surse nu au răspuns. O listă goală de la o sursă care nu a răspuns nu dovedește că nu există nimic.
  • O listă de mementouri este o record-list ale cărei elemente au o dată scadentă (review-date) și o stare a scadenței în cuvinte, cu data-due; regula care a produs-o este a dumneavoastră.

Formulare

  • O întrebare cu răspunsurile „da”, „nu” sau „neîntrebat” este un radio-group de trei răspunsuri, niciunul ales la început, niciodată o casetă de bifat: o casetă nu poate deosebi „neagă” de „nu a fost întrebat niciodată”. O revizuire pe aparate este un fieldset pentru fiecare aparat, iar un buton „toate celelalte absente” le setează doar pe cele fără răspuns.
  • O întrebare cu o listă de răspunsuri (medicamente, adrese) este un repeatable-fieldset: un element se adaugă sau se elimină, focalizarea îl urmează, iar fiecare buton de eliminare poartă numele elementului său.
  • Un număr cu virgulă zecimală: afișați-l cu Intl.NumberFormat și, unde type="number" nu acceptă virgula, preluați-l într-un câmp de text cu inputmode="decimal" și analizați-l în codul dumneavoastră. Nu schimbați niciodată o valoare tastată de persoană, nici pentru a o încadra într-un interval: o valoare în afara intervalului este o eroare pe care o poate vedea.
  • O listă lungă care afișează doar o parte din opțiuni deodată setează aria-setsize și aria-posinset pe fiecare opțiune și ține minte că căutarea în pagină nu vede restul.

Dosare, note și proveniența lor

  • Spuneți ce vedere este o listă sau o grilă înaintea rândurilor: perioada și ordinea, ce omite și de ce și ce surse nu au răspuns („Ultimele 12 luni, cele mai noi întâi. Dosarul medicului de familie nu a răspuns.”). Dați lui record-list și lui timeline-list un coverageLabel, iar ajutorului data-grid propriul coverageLabel. O listă goală de la o sursă care nu a răspuns spune asta în cuvinte, ca să nu fie citită niciodată drept „nimic înregistrat”.
  • Spuneți de unde vine o înregistrare și dacă este finală cu record-provenance-view: semnată, în așteptarea semnăturii, modificată, salvată pe acest dispozitiv și încă netrimisă. O ciornă nesemnată nu trebuie să pară niciodată semnată.
  • O înregistrare despre altcineva (un părinte, un făt, un donator) spune mai întâi a cui este, cu subjectLabel.
  • O înregistrare reținută rămâne în listă cu cuvintele dumneavoastră („Restricționat: indisponibil pentru dumneavoastră”), iar o înregistrare făcută din greșeală rămâne tăiată cu „Introdus din greșeală”: dați lui record-list-item sau timeline-list-item un entryState și un entryStateLabel. Nu eliminați niciodată pe tăcute niciuna dintre ele, deoarece un gol se citește „nu s-a întâmplat nimic”.
  • Într-o notă clinică, marcați sursa fiecărui pasaj (tastat, dictat, șablon, copiat înainte, generat) cu data-source și cuvinte vizibile, astfel încât textul copiat sau generat să nu fie luat niciodată drept examinarea de azi.
  • O secțiune care nu se poate încărca este unavailable în cuvintele dumneavoastră, cu un buton de reîncercare; un cod tehnic, dacă este afișat, stă în spatele unei dezvăluiri. O eroare cauzată de acțiunea unei persoane este anunțată, cu valoarea pe care dosarul o are acum; o eroare la încărcarea paginii nu.
  • Istoricul unei prescripții este o timeline-list, câte un element pe pas (planificată, programată, activă, suspendată, finalizată, anulată) cu ora și motivul, iar starea curentă și pe element.

De la FHIR la Lily

Lily nu citește resurse FHIR; codul dumneavoastră le mapează pe proprietățile Lily. Aceste tabele mapează Rezumatul Internațional al Pacientului HL7 FHIR (IPS 2.0.1, FHIR R4). Maparea codurilor este o sugestie: o stabilește evaluarea dumneavoastră de siguranță clinică, iar cuvintele pentru fiecare stare sunt ale dumneavoastră.

Secțiunile IPS și componentele Lily pentru ele
Secțiune IPS Lily
Alergii și intoleranțe (48765-2) allergy-record-list și elementele sale
Rezumatul medicației (10160-0) medication-record-list, fiecare element conținând un medication-view
Lista de probleme (11450-4) problem-record-list și elementele sale
Imunizări (11369-6) immunization-record-list și elementele sale
Rezultate (30954-2) observation-view, într-un tabel de date sau într-o listă-rezumat
Istoricul procedurilor (47519-4) procedure-record-list și elementele sale
Dispozitive medicale (46264-8) device-record-list și elementele sale
Alerte (104605-1) Text de avertizare sau o alertă, niciodată în spatele unui control restrâns
Orice altă secțiune record-list și elementele sale
O secțiune obligatorie pe care documentul o omite Lista secțiunii cu status="omitted"
Codurile FHIR și valorile Lily pentru ele
FHIR Lily
emptyReason nilknown status="none-known" al listei
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", cu cuvinte care spun care este cazul
Codurile IPS no-known-allergies, no-known-medications și altele asemănătoare status="none-known"
Codurile IPS no-allergy-info, no-medication-info și altele asemănătoare status="not-recorded"
AllergyIntolerance.criticality criticality, separat de severity al unei reacții
clinicalStatus, verificationStatus Aceleași proprietăți la elementele de alergie și de problemă, cu aceleași coduri
MedicationStatement.status status al elementului de medicament
Dosage.text medication-view dosageText
Observation.status status al observation-view, cu aceleași coduri
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (și pe listele de dosare)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Mapați o înregistrare entered-in-error pe statusul ei entered-in-error, cu cuvinte, în loc să o eliminați în tăcere: dacă o afișați deloc este decizia serviciului dumneavoastră.

De la openEHR la Lily

Lily nu citește nici compozițiile openEHR. Corespondența pentru tipurile de date și codurile modelului de referință openEHR, ca o sugestie asupra căreia decide evaluarea dumneavoastră de siguranță clinică:

Tipuri de date și coduri openEHR și valorile Lily corespunzătoare
openEHR Lily
DV_QUANTITY (introducere) quantity-input-div; unități ca coduri UCUM cu cuvintele dumneavoastră
DV_QUANTITY (afișare), magnitude_status observation-view cu formatQuantity(value, unit, locale, comparator) (~ este ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges cu un meaning observation-view ranges
DV_DATE parțială (an, an și lună) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view cu durationParts()
DV_PROPORTION formatProportion() în observation-view
DV_ORDINAL, DV_SCALE un radio-group ale cărui etichete poartă numărul și cuvintele lui
DV_CODED_TEXT modelul valorilor codificate de mai jos
DV_BOOLEAN checkbox-input, doar când „neîntrebat” nu se poate întâmpla
ELEMENT.null_flavour 253 necunoscut, 271 nicio informație status="not-recorded" sau "unavailable", cu cuvinte care spun care este cazul
null_flavour 272 mascat observation-view status="masked"
null_flavour 273 nu se aplică status="not-applicable"
PARTY_RELATED subiect subjectLabel pe elementele dosarului
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Pașii mașinii de stări a instrucțiunilor o timeline-list de pași, cu starea curentă pe element
un element de arhetip cu apariții 0..* repeatable-fieldset

Valori codificate

  • Afișați Coding.display; dacă nu există, CodeableConcept.text; dacă nu există nici acesta, system|code. Niciodată o celulă goală.
  • Oferiți un control care dezvăluie sistemul de coduri și codul lângă fiecare valoare, de exemplu un buton de comutare cu textul „Afișează codurile”. Codurile ascunse rămân în afara ordinii de citire până la afișare.
  • Marcați textul clinic cu limba documentului (lang), care poate diferi de cea a interfeței. Traduceți interfața; niciodată conținutul clinic.
  • Lily nu livrează terminologie: nicio căutare SNOMED CT, LOINC, ATC sau UCUM. Scrieți ce spune documentul. Pagina /patient-summary din exemplul SvelteKit arată modelul.

Ce nu va face Lily

  • Să calculeze un scor de avertizare timpurie, un centil de creștere, o doză sau un interval de referință.
  • Să livreze o bază de date de medicamente, o listă tall man sau coduri SNOMED CT, CIM, LOINC ori UCUM.
  • Să reproducă un instrument licențiat (Wong-Baker FACES) sau designul altui organism (graficul NEWS2).
  • Să limiteze numărul de dosare deschise simultan.
  • Să deducă o interpretare dintr-un interval, să convertească o unitate sau să analizeze o dată relativă („marțea viitoare”).
  • Să folosească un comutator pentru „da, nu sau necunoscut”: switch din ARIA nu are o a treia stare, deci sunt trei butoane radio.

Cercetarea, sursele și deciziile din spatele acestui ghid se află în spec/healthcare-ui.