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.
| 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 ponuditeoverrideReasonskako 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelnacontext-menuilidropdown-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-deceasedza 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-groupod 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 kaodata-interpretationza 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-viewga nikada ne zaključuje, pa nalaz s rasponom, a bezinterpretation, ne prikazuje oznaku. -
Nalaz izvan ljestvice granica je instrumenta sa znakom usporedbe („> 33,3 mmol/L”:
formatQuantitys">") 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-charts 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-ovQuantity.comparatorzapisuje 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.DateTimeFormatsmonth: "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-fieldprecision="month"ili"year", spremite2019-03ili2019i zapišite ga sformatPartialDate(). Nikada ne izmišljajte dan. -
Trajanje je
duration-view,<time datetime="P3DT4H">s vašim riječima, izdurationParts()iIntl.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, sdata-due; pravilo koje ga je stvorilo vaše je.
Obrasci
-
Pitanje s odgovorima „da”, „ne” ili „nije pitano” je
radio-groupod tri odgovora, nijedan unaprijed odabran, nikada potvrdni okvir: okvir ne razlikuje „poriče” od „nikada pitano”. Pregled sustava je jedanfieldsetpo 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.NumberFormati, gdjetype="number"ne prihvaća zarez, primite ga u tekstnom polju sinputmode="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-setsizeiaria-posinsetna 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-listitimeline-listcoverageLabel, a pomoćnikudata-gridnjegovcoverageLabel. 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-itemilitimeline-list-itementryStateientryStateLabel. 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-sourcei 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
unavailablevaš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 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 | 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:
| 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-summaryu 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”:
switchu 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.