Korisnička sučelja u zdravstvu

Vodič za timove koji grade klinički softver s Lilyjem: klinički portali, nalazi i izvještavanje, propisivanje i primjena lijekova, podrška odlučivanju i bolničke nadzorne ploče.

Prijevodi ove stranice neprovjereni su strojni nacrti. Engleska stranica je mjerodavna verzija.

Što Lily radi, a što ne

Lily pruža ugovore o prikazu: semantičku oznaku, ARIA, ponašanje tipkovnice i klasne kuke za ono što se na kliničkim zaslonima ponavlja. Ne pruža kliničku logiku, klinički sadržaj niti regulatornu tvrdnju.

Što pruža Lily, a što pružate vi
Lily pruža Vi pružate
observation-view: vrijednost, jedinica, oznaka riječima, raspon i stanja nedostajućih podataka Vrijednost, odluka o oznaci, referentni raspon
allergy-record-list i allergy-record-list-item: status koji nikada nije prazan Zapis o alergiji i njegova terminologija
medication-view: naziv, jačina, oblik, put primjene i učestalost, ništa skraćeno Podaci o lijeku, tall man segmenti, formatirana jačina
decision-support-card: oblik kartice CDS Hooks Pravila, radnje prijedloga, bilježenje ishoda
early-warning-score-view: zbroj bodova, pojas i eskalacija, prikazani Sustav bodovanja i njegov validirani izračun
age-view i ageParts(): dob u jedinicama koje joj odgovaraju Riječi za jedinice (Intl.DurationFormat ili vaše vlastite oznake)
formatQuantity(): 5 mg, nikad 5,0 mg; 0,5 mg, nikad ,5 mg Broj, jedinica i regionalna postavka
Sastav zaglavlja pacijenta Svaka oznaka i vrijednost te tko smije vidjeti kliničke informacije

Regulativa. Softver koji izračunava zbroj bodova, centil, dozu ili interakciju lijekova obično je medicinski proizvod. Lily ne izračunava ništa od toga, namjerno. Ako je vaš proizvod reguliran, datoteku inženjerstva uporabljivosti vodite vi (IEC 62366-1, smjernice FDA-a o ljudskim čimbenicima, EU MDR). Lilyjevi testovi, njezino samoprocijenjeno izvješće o usklađenosti s pristupačnošću i matrica čitača zaslona mogu biti dokaz u toj datoteci; nijedno od toga nije tvrdnja o sukladnosti, a matrica još nema rezultata.

Upozorenja: prekidajte samo zbog kritičnog

Zamor od upozorenja sigurnosni je problem: kad svako upozorenje prekida rad, ljudi odbacuju sva. Smjernica AHRQ-a jest razvrstati upozorenja po težini i samo teška učiniti prekidnima.

  • Informacija (indicator="info"): u retku, uz zadatak, kartica podrške odlučivanju na stranici.
  • Upozorenje (indicator="warning"): vidljivo bez blokiranja, ista kartica, stilizirana da se ističe; bez modalnog prozora.
  • Kritično (indicator="critical"): stavite karticu unutar dijaloga upozorenja i ponudite overrideReasons kako bi se pri odbacivanju tražio razlog.
  • Kartica podrške odlučivanju sama po sebi nikada nije živa regija. Novu kritičnu karticu najavite premještanjem fokusa u dijalog, a ne s aria-live.
  • Uklonite karticu kad se događaj na koji je odgovarala ponovno dogodi i zabilježite svaki ishod (prihvaćeno ili nadjačano s razlogom).

Pogreške zamjene pacijenta: identificirajte, ne ograničavajte

  • Prikažite dva identifikatora gdje god se pojavljuju podaci o pacijentu: ime s datumom rođenja te nacionalni identifikator s njegovom view komponentom (The Joint Commission, Quick Safety 45).
  • Koristite zaglavlje pacijenta na svakom zaslonu koji djeluje na zapis jednog pacijenta i održavajte ga vidljivim.
  • Prije radnje na zapisu koji nije onaj u zaglavlju potvrdite je imenom, datumom rođenja i identifikatorom.
  • Unos o nekome drugome osim pacijenta (anamneza roditelja, plod, darivatelj) najprije riječima kaže na koga se odnosi: dajte stavkama zapisa subjectLabel („Majka”), kako se dijagnoza rođaka nikada ne bi pročitala kao pacijentova (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Ne ograničavajte koliko zapisa kliničar smije otvoriti: randomizirano ispitivanje s 3356 kliničara (JAMA, 2019) pokazalo je da to nije smanjilo narudžbe za pogrešnog pacijenta, a ljudi to zaobilaze.
  • Izbornik radnji nad jednim zapisom najprije imenuje taj zapis, s subjectLabel na context-menu ili dropdown-menu („Ada Lovelace, krvni tlak 3. stu.”): neinteraktivni prvi dio koji je ujedno pristupačni naziv izbornika.
  • Svrstajte svaku radnju u razinu prema onome što radi i pokažite razinu prije nego što se izvrši. Rutinska (pregled, ispis) izvršava se odmah. Dokumentirana kaže što će upisati u zapis („Dodaje bilješku uz kontakt”). Klinička (ukinuti, otkazati nalog) pita drugi put, u alert-dialog čiji je gumb za potvrdu glagol („Ukini”), nikada „U redu” ili „Da”. Otkrivajuća (hitni pristup, dijeljenje izvan tima za skrb) najprije traži razlog i bilježi ga.
  • Kada je otvoreno više zapisa (kartice, prozori, podijeljena okna), vidljivi tekst i pristupačni naziv svake kartice sadrže ime pacijenta i drugi identifikator, aktivno okno ponavlja natpis, a nijedna radnja ne odnosi se na drugog pacijenta osim pacijenta svojeg okna.
  • Prikažite mjesto kojemu će se pripisati zapisi (odjel, ambulantu ili ustanovu odabranu pri prijavi) kao tekst u zaglavlju stranice i neka njegova promjena bude izričita radnja.
  • U natpisu prikažite aktivni posjet ili „Nema aktivnog posjeta”. Obrazac kojemu je potreban posjet to kaže i nudi da ga započne, umjesto da zakaže pri spremanju.

Zaglavlje pacijenta

Sastav je dokumentiran uz medical-banner, s radnom stranicom na /patient-banner u primjeru aplikacije SvelteKit:

  • dva identifikatora i dob uz datum rođenja;
  • alergije kroz popis alergija, tako da „nema poznatih alergija”, „nije zabilježeno” i „nedostupno” nikad ne izgledaju isto;
  • nedostajuća vrijednost su riječi („Nije poznato”), nikad upitnik, crtica ili prazna ćelija;
  • preminuli pacijent: data-deceased za temu i vidljiv redak teksta, nikad samo boja;
  • nijedno polje nije skraćeno, odrezano ili skriveno ni pri kojoj širini; prelama se.
  • oznake pacijenta („Treba tumača”, „Rizik od infekcije”) su označena tag-group od riječi, nikada samo ikone ili boja, i ostaju vidljive kada se natpis prelomi.

Nalazi

  • Jedan prikaz za nalaz, iz kojeg god sustava dolazio: prikaz opservacije.
  • Oznaka su riječi iz vašeg prijevoda (flagLabel), s FHIR interpretacijskim kodom kao data-interpretation za temu.
  • Odvojite nove nalaze od ranijih i prikažite trend (sparkline ili linijski grafikon s tablicom podataka): kliničari traže značajnu promjenu, a ne samo raspon.
  • Nalaz koji nikad nije zabilježen i nalaz koji je nedostupan različita su stanja, s različitim riječima.
  • Nepoznato nije normalno. Nalaz kojemu referentni raspon nedostaje, još se učitava ili je nečitljiv nema tumačenje i to kaže; observation-view ga nikada ne zaključuje, pa nalaz s rasponom, a bez interpretation , ne prikazuje oznaku.
  • Nalaz izvan ljestvice granica je instrumenta sa znakom usporedbe („> 33,3 mmol/L”: formatQuantity s ">") i vašom kritičnom oznakom, nikada golim brojem. Približna vrijednost zadržava svoj ≈ ("~").
  • Dodatne imenovane raspone („Kritično: ispod 2,5”) navedite kao ranges, svaki kao zaseban dio.
  • Ispravljen ili izmijenjen nalaz zadržava vrijednost koju je zamijenio, u <del>, s vašim riječima o tome kada se promijenila (previousValue, previousLabel), kako bi kliničar koji je pročitao staru vrijednost znao da se promijenila.
  • Intervalno mjerenje navodi svoje trajanje i funkciju („Prosjek, 24 sata”), a stanje i metoda mjerenja („Sjedeći, velika manžeta”) vidljiv su tekst pokraj, nikada samo opis alata (openEHR INTERVAL_EVENT, state, protocol).
  • Trend treba usporedive točke: ne crtajte crtu ispod svog minimuma, prekinite crtu gdje se promijenila metoda ili pretraga i riječima recite smjer i značenje („pada, poboljšanje”).
  • Vitalni znakovi uneseni u jednom sustavu jedinica mogu pokraj pokazati drugi kao vaš tekst („70 kg (154 lb)”); Lily ništa ne pretvara, pa navedite svoje zaokruživanje. Količinu unesite s quantity-input-div, čiji broj prati granice svake jedinice.
  • Krivulja rasta je line-chart s vašim centilnim crtama kao nizovima, točkama djeteta i njegovom podatkovnom tablicom dobi i vrijednosti; Lily ne izračunava centile i ne isporučuje referencije rasta.

Lijekovi

  • Generički nazivi malim slovima, osim tall man slova s popisa FDA-a i ISMP-a ili vaše zemlje (Australija i Kanada objavljuju vlastite). Označite ih u nameSegments; Lily ih nikad ne pogađa.
  • Jačinu zapišite s formatQuantity: bez završne nule, s početnom nulom i nerazdvojivim razmakom prije jedinice.
  • Zadržite komparator nalaza: formatQuantity(5, "mmol/L", locale, "<") ispisuje „<5 mmol/L”. FHIR-ov Quantity.comparator zapisuje se kao <, ≤, ≥ ili >; ako ga izostavite, „manje od 5” postaje „5”.
  • Pišite mL, nikad cc, i izbjegavajte svaku kraticu s ISMP-ova popisa kratica sklonih pogreškama.
  • Nikad ne skraćujte naziv ni dozu lijeka.

Datumi i vremena

  • Mjesec napišite tekstom kako se datum ne bi mogao pročitati na dva načina (Intl.DateTimeFormat s month: "short").
  • Sat odaberite namjerno: izričito proslijedite hourCycle. NHS traži 24-satni sat; to je britansko pravilo, a ne svjetsko, pa ga Lily nikad ne bira umjesto vas.
  • Dob prati pojaseve Common User Interface putem ageParts(); usluga s drugom konvencijom proslijeđuje vlastite riječi.
  • Datum poznat samo do mjeseca ili godine takav i ostaje: pitajte za njega s date-field precision="month" ili "year", spremite 2019-03 ili 2019i zapišite ga s formatPartialDate(). Nikada ne izmišljajte dan.
  • Trajanje je duration-view, <time datetime="P3DT4H"> s vašim riječima, iz durationParts() i Intl.DurationFormat.

Nadzorne ploče

  • Ploča odjela ili zaslon zapovjednog centra često se ažurira. Nikad ne najavljujte svaku promjenu: zadržite jednu pristojnu regiju sažetka („3 slobodna kreveta, 2 otpusta očekuju”) i pustite ljude da čitaju ploču.
  • Svako stanje na ploči (krevet čist, zauzet, blokiran) tekst je ili stanje data-* s riječima, nikad samo boja.
  • Ništa ne treperi (WCAG 2.2.2, 2.3.1), a ploča koja se osvježava po mjeraču vremena ima kontrolu pauze ili se osvježava samo na zahtjev; ažuriranja nikada ne pomiču fokus. Zakašnjeli unos to kaže riječima („Čeka više od 20 minuta”) s data-overdue.
  • Broj ili stopa prikazuje svoj nazivnik („12 od 68”) i povezuje na popis iza sebe.
  • Popis ili vremenska crta kaže čega je prikaz: što prikazuje, svoj redoslijed i razdoblje, što je skriveno i zašto te koji izvori nisu odgovorili. Prazan popis iz izvora koji nije odgovorio ne dokazuje da ništa ne postoji.
  • Popis podsjetnika je record-list čije stavke nose rok (review-date) i stanje roka riječima, s data-due; pravilo koje ga je stvorilo vaše je.

Obrasci

  • Pitanje s odgovorima „da”, „ne” ili „nije pitano” je radio-group od tri odgovora, nijedan unaprijed odabran, nikada potvrdni okvir: okvir ne razlikuje „poriče” od „nikada pitano”. Pregled sustava je jedan fieldset po organskom sustavu, a gumb „svi ostali odsutni” postavlja samo neodgovorene.
  • Pitanje s popisom odgovora (lijekovi, adrese) je repeatable-fieldset: stavka se dodaje ili uklanja, fokus slijedi, a svaki gumb za uklanjanje imenovan je po svojoj stavci.
  • Broj s decimalnim zarezom: prikažite ga s Intl.NumberFormat i, gdje type="number" ne prihvaća zarez, primite ga u tekstnom polju s inputmode="decimal" i raščlanite u svojem kodu. Nikada ne mijenjajte vrijednost koju je osoba upisala, čak ni da je ograničite na raspon: vrijednost izvan raspona pogreška je koju može vidjeti.
  • Dugačak popis koji istodobno prikazuje samo dio opcija postavlja aria-setsize i aria-posinset na svaku opciju i pamti da pretraživanje stranice ne vidi ostatak.

Zapisi, bilješke i njihovo podrijetlo

  • Prije redaka recite čega je popis ili mreža prikaz: razdoblje i redoslijed, što izostavlja i zašto te koji izvori nisu odgovorili („Zadnjih 12 mjeseci, najnovije prvo. Zapis obiteljskog liječnika nije odgovorio.”). Dajte record-list i timeline-list coverageLabel, a pomoćniku data-grid njegov coverageLabel. Prazan popis iz izvora koji nije odgovorio to kaže riječima, da se nikada ne pročita kao „ništa zabilježeno”.
  • Recite odakle je zapis došao i je li konačan s record-provenance-view: potpisan, čeka potpis, izmijenjen, spremljen na ovom uređaju i još nije poslan. Nepotpisani nacrt nikada ne smije izgledati potpisano.
  • Unos o nekome drugome (roditelju, plodu, darivatelju) najprije kaže na koga se odnosi, s subjectLabel.
  • Zadržani unos ostaje na popisu s vašim riječima („Ograničeno: nije vam dostupno”), a pogrešno uneseni unos ostaje precrtan uz „Uneseno pogreškom”: dajte record-list-item ili timeline-list-item entryState i entryStateLabel. Nikada nijedan od njih ne uklanjajte tiho, jer se praznina čita kao „ništa se nije dogodilo”.
  • U kliničkoj bilješci označite izvor svakog odlomka (utipkano, diktirano, predložak, preneseno, generirano) s data-source i vidljivim riječima, kako preneseni ili generirani tekst nikada ne bi bio shvaćen kao današnji pregled.
  • Odjeljak koji se ne može učitati je unavailable vašim riječima, s gumbom za ponovni pokušaj; tehnički kod, ako je uopće prikazan, nalazi se iza otkrivanja. Pogreška uzrokovana radnjom osobe najavljuje se, s vrijednošću koju zapis sada ima; pogreška pri učitavanju stranice ne.
  • Povijest naloga je timeline-list, po jedna stavka za svaki korak (planirano, zakazano, aktivno, obustavljeno, dovršeno, otkazano) s vremenom i razlogom, a trenutačno stanje i na stavci.

Iz FHIR-a u Lily

Lily ne čita FHIR resurse; vaš ih kôd preslikava u Lilyjeve props. Ove tablice preslikavaju HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Preslikavanje kodova je prijedlog: o njemu odlučuje vaša klinička sigurnosna procjena, a riječi za svako stanje vaše su.

IPS odjeljci i Lily komponente za njih
IPS odjeljak Lily
Alergije i intolerancije (48765-2) allergy-record-list i njegove stavke
Sažetak lijekova (10160-0) medication-record-list, pri čemu svaka stavka sadrži medication-view
Popis problema (11450-4) problem-record-list i njegove stavke
Cijepljenja (11369-6) immunization-record-list i njegove stavke
Nalazi (30954-2) observation-view, u podatkovnoj tablici ili sažetom popisu
Povijest zahvata (47519-4) procedure-record-list i njegove stavke
Medicinski proizvodi (46264-8) device-record-list i njegove stavke
Upozorenja (104605-1) Tekst upozorenja ili upozorenje, nikad iza sklopljene kontrole
Bilo koji drugi odjeljak record-list i njegove stavke
Obavezan odjeljak koji dokument izostavlja Popis odjeljka s status="omitted"
FHIR kodovi i Lily vrijednosti za njih
FHIR Lily
emptyReason nilknown Popis sa status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", s riječima koje kažu koje je
IPS kodovi no-known-allergies, no-known-medications i slično status="none-known"
IPS kodovi no-allergy-info, no-medication-info i slično status="not-recorded"
AllergyIntolerance.criticality criticality, odvojeno od reakcijskog severity
clinicalStatus, verificationStatus Isti props na stavkama alergije i problema, s istim kodovima
MedicationStatement.status Stavka lijeka: status
Dosage.text medication-view dosageText
Observation.status observation-view status, s istim kodovima
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (također na popisima zapisa)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Zapis sa statusom entered-in-error preslikajte u status entered-in-error riječima, umjesto da ga tiho izostavite: hoće li se uopće prikazati, odluka je vaše usluge.

Od openEHR-a do Lily

Lily ne čita ni openEHR kompozicije. Preslikavanje za tipove podataka i kodove referentnog modela openEHR, kao prijedlog o kojem odlučuje vaša revizija kliničke sigurnosti:

Tipovi podataka i kodovi openEHR-a te odgovarajuće vrijednosti Lily
openEHR Lily
DV_QUANTITY (unos) quantity-input-div; jedinice kao UCUM kodovi s vašim riječima
DV_QUANTITY (prikaz), magnitude_status observation-view s formatQuantity(value, unit, locale, comparator) (~ je ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges s meaning observation-view ranges
DV_DATE djelomičan (godina, godina i mjesec) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view s durationParts()
DV_PROPORTION formatProportion() unutar observation-view
DV_ORDINAL, DV_SCALE radio-group čije oznake nose broj i njegove riječi
DV_CODED_TEXT uzorak kodiranih vrijednosti u nastavku
DV_BOOLEAN checkbox-input, samo kada „nije pitano” ne može nastupiti
ELEMENT.null_flavour 253 nepoznato, 271 nema informacija status="not-recorded" ili "unavailable", s riječima koje kažu koje je
null_flavour 272 maskirano observation-view status="masked"
null_flavour 273 nije primjenjivo status="not-applicable"
PARTY_RELATED subjekt subjectLabel na stavkama zapisa
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Koraci stroja stanja uputa timeline-list koraka, s trenutačnim stanjem na stavci
stavka arhetipa s pojavljivanjima 0..* repeatable-fieldset

Kodirane vrijednosti

  • Prikažite Coding.display; ako ga nema, CodeableConcept.text; ako nema ni jednog ni drugog, system|code. Nikad prazna ćelija.
  • Ponudite kontrolu koja uz svaku vrijednost otkriva sustav kodova i kod, primjerice gumb za prebacivanje s tekstom „Prikaži kodove”. Skriveni kodovi ostaju izvan redoslijeda čitanja dok se ne prikažu.
  • Klinički tekst označite jezikom dokumenta (lang), koji se može razlikovati od jezika sučelja. Prevedite sučelje; klinički sadržaj nikad ne prevodite.
  • Lily ne isporučuje terminologiju: nema pretraga SNOMED CT, LOINC, ATC ili UCUM. Napišite što dokument kaže. Stranica /patient-summary u SvelteKit primjeru pokazuje obrazac.

Što Lily neće raditi

  • Izračunavati zbroj ranog upozorenja, centil rasta, dozu ili referentni raspon.
  • Isporučivati bazu lijekova, popis tall man ili šifre SNOMED CT, MKB, LOINC ili UCUM.
  • Reproducirati licencirani instrument (Wong-Baker FACES) ili dizajn drugog tijela (NEWS2 tablicu).
  • Ograničavati broj istodobno otvorenih zapisa.
  • Zaključivati tumačenje iz raspona, pretvarati jedinice ili raščlanjivati relativni datum („sljedeći utorak”).
  • Koristiti prekidač za „da, ne ili nepoznato”: switch u ARIA-i nema treće stanje, pa su to tri izborna gumba.

Istraživanje, izvori i odluke iza ovog vodiča nalaze se u spec/healthcare-ui.