Uporabniški vmesniki v zdravstvu
Vodnik za skupine, ki z Lily gradijo klinično programsko opremo: klinični portali, izvidi in poročanje, predpisovanje in dajanje zdravil, podpora odločanju ter bolnišnične nadzorne plošče.
Prevodi te strani so nepregledani strojni osnutki. Angleška stran je zavezujoča različica.
Kaj Lily naredi in česa ne
Lily vam daje pogodbe prikaza: pomensko označevanje, ARIA, vedenje tipkovnice in razredne kljuke za stvari, ki se ponavljajo na kliničnih zaslonih. Ne daje vam klinične logike, kliničnih vsebin ali regulativne trditve.
| Lily ponuja | Vi ponudite |
|---|---|
| observation-view: vrednost, enoto, oznako z besedami, razpon in stanja manjkajočih podatkov | Vrednost, odločitev o oznaki, referenčni razpon |
| allergy-record-list in allergy-record-list-item: stanje, ki ni nikoli prazno | Zapis o alergiji in njegovo terminologijo |
| medication-view: ime, jakost, obliko, pot in pogostost, nič ni prirezano | Podatke o zdravilu, segmente tall man, oblikovano jakost |
| decision-support-card: obliko kartice CDS Hooks | Pravila, predlagana dejanja, beleženje izida |
| early-warning-score-view: oceno, pas in stopnjevanje, prikazano | Sistem točkovanja in njegov validiran izračun |
age-view in ageParts(): starost v ustreznih enotah |
Besede za enote (Intl.DurationFormat ali vaše lastne oznake) |
formatQuantity(): 5 mg, nikoli 5,0 mg; 0,5 mg, nikoli ,5 mg |
Število, enoto in območno nastavitev |
| Sestavo pasice bolnika | Vsako oznako in vrednost ter kdo sme videti klinične informacije |
Regulacija. Programska oprema, ki izračuna oceno, centil, odmerek ali medsebojno delovanje zdravil, je običajno medicinski pripomoček. Lily ničesar od tega ne izračuna, namerno. Če je vaš izdelek reguliran, ste za dokumentacijo inženiringa uporabnosti odgovorni vi (IEC 62366-1, smernice FDA o človeških dejavnikih, EU MDR). Testi Lily, njeno samoocenjeno poročilo o skladnosti z dostopnostjo in njena matrika bralnikov zaslona so lahko dokaz v tej dokumentaciji; nič od tega ni izjava o skladnosti, matrika pa še nima rezultatov.
Opozorila: prekinite le zaradi kritičnega
Utrujenost zaradi opozoril je varnostna težava: ko vsako opozorilo prekine delo, jih ljudje zavržejo vsa. Smernica AHRQ je, da opozorila razvrstite po resnosti in prekinjajoča naredite le resna.
- Informacija (
indicator="info"): vrstično, ob nalogi, kartica podpore odločanju na strani. - Opozorilo (
indicator="warning"): vidno brez blokiranja, ista kartica, oblikovana tako, da izstopa; brez modalnega okna. - Kritično (
indicator="critical"): kartico postavite v pogovorno okno opozorila in ponuditeoverrideReasons, da zavrnitev zahteva razlog. - Kartica podpore odločanju sama po sebi nikoli ni živa regija. Novo kritično kartico napovejte s premikom fokusa v pogovorno okno, ne z
aria-live. - Kartico odstranite, ko se dogodek, na katerega je odgovorila, ponovi, in zabeležite vsak izid (sprejeta ali preglašena z razlogom).
Zamenjave bolnikov: prepoznajte, ne omejujte
- Pokažite dva identifikatorja povsod, kjer se pojavijo podatki bolnika: ime z datumom rojstva ter nacionalni identifikator z njegovo komponento prikaza (The Joint Commission, Quick Safety 45).
- Pasico bolnika uporabite na vsakem zaslonu, ki deluje na zapisu enega bolnika, in jo pustite vidno.
- Pred dejanjem na zapisu, ki ni tisti v pasici, ga potrdite z imenom, datumom rojstva in identifikatorjem.
-
Vnos o nekom drugem kot o pacientu (anamneza starša, plod, darovalec) najprej z besedami pove, na koga se nanaša: elementom zapisa dajte
subjectLabel(»Mati«), da diagnoze sorodnika nikoli ne preberejo kot pacientove (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Ne omejujte, koliko zapisov sme odpreti zdravnik: randomizirana študija s 3.356 zdravniki (JAMA, 2019) je pokazala, da to ni zmanjšalo naročil za napačnega bolnika, ljudje pa to zaobidejo.
-
Meni dejanj nad enim zapisom najprej poimenuje ta zapis, z
subjectLabelpricontext-menualidropdown-menu(»Ada Lovelace, krvni tlak 3. nov.«): neinteraktivni prvi del, ki je hkrati dostopno ime menija. -
Vsako dejanje razvrstite v raven glede na to, kaj počne, in raven pokažite, preden se izvede. Rutinsko (prikaži, natisni) se izvede takoj. Dokumentirano pove, kaj bo zapisalo v zapis (»Doda opombo k obravnavi«).
Klinično (ukini, prekliči naročilo) vpraša drugič, v
alert-dialog, katerega potrditveni gumb je glagol (»Ukini«), nikoli »V redu« ali »Da«. Razkrivajoče (nujni dostop, deljenje zunaj negovalne ekipe) najprej vpraša za razlog in ga zabeleži. - Ko je odprtih več zapisov (zavihki, okna, razdeljeni podokni), vidno besedilo in dostopno ime vsakega zavihka vsebujeta ime pacienta in drugi identifikator, aktivno podokno ponovi pasico, nobeno dejanje pa ne velja za drugega pacienta kot za pacienta svojega podokna.
- Prikažite kraj, kateremu bodo pripisani zapisi (oddelek, ambulanto ali ustanovo, izbrano ob prijavi), kot besedilo v glavi strani, in naj bo njegova sprememba izrecno dejanje.
- V pasici prikažite aktivni obisk ali »Ni aktivnega obiska«. Obrazec, ki potrebuje obisk, to pove in ponudi, da ga začne, namesto da ob shranjevanju spodleti.
Pasica bolnika
Sestava je dokumentirana pri medical-banner, z delujočo stranjo na /patient-banner v vzorčni aplikaciji SvelteKit:
- dva identifikatorja in starost ob datumu rojstva;
- alergije prek seznama alergij, tako da „brez znanih alergij“, „ni zabeleženo“ in „ni na voljo“ nikoli ne izgledajo enako;
- manjkajoča vrednost je z besedami („Ni znano“), nikoli vprašaj, pomišljaj ali prazna celica;
- preminuli bolnik:
data-deceasedza temo in vidna vrstica besedila, nikoli le barva; - nobeno polje ni prirezano, odrezano ali skrito pri nobeni širini; besedilo se prelomi.
-
oznake pacienta (»Potrebuje tolmača«, »Tveganje okužbe«) so označena
tag-groupiz besed, nikoli samo ikone ali barva, in ostanejo vidne, ko se pasica prelomi.
Izvidi
- En prikaz izvida, ne glede na to, iz katerega sistema prihaja: pogled opazovanja.
- Oznaka so besede iz vašega prevoda (
flagLabel), s kodo interpretacije FHIR vdata-interpretationza temo. - Nove izvide ločite od prejšnjih in pokažite trend (sparkline ali črtni grafikon z njegovo tabelo podatkov): zdravniki iščejo pomembno spremembo, ne le razpona.
- Izvid, ki ni bil nikoli zabeležen, in izvid, ki ni na voljo, sta različni stanji z različnimi besedami.
-
Neznano ni normalno. Izvid, katerega referenčni interval manjka, se še nalaga ali je neberljiv, nima interpretacije in to pove;
observation-viewje nikoli ne izpelje, zato izvid z intervalom in brezinterpretationne pokaže oznake. -
Izvid zunaj lestvice je meja instrumenta s primerjalnim znakom (»> 33,3 mmol/l«:
formatQuantityz">") in vašo kritično oznako, nikoli golo število. Približna vrednost ohrani svoj ≈ ("~"). - Dodatne poimenovane intervale (»Kritično: pod 2,5«) podajte kot
ranges, vsakega kot svoj del. -
Popravljen ali spremenjen izvid ohrani zamenjano vrednost v
<del>, z vašimi besedami o tem, kdaj se je spremenila (previousValue,previousLabel), da klinik, ki je prebral staro vrednost, ve, da se je spremenila. -
Intervalna meritev pove svojo dolžino in funkcijo (»Povprečje, 24 ur«), stanje in metoda meritve (»Sede, velika manšeta«) pa sta vidno besedilo poleg, nikoli le namig (openEHR
INTERVAL_EVENT,state,protocol). - Trend potrebuje primerljive točke: ne rišite črte pod svojim minimumom, prekinite črto, kjer se je spremenila metoda ali določitev, ter z besedami povejte smer in pomen (»pada, izboljšanje«).
-
Vitalni znaki, vneseni v enem sistemu enot, lahko poleg prikažejo drugega kot vaše besedilo (»70 kg (154 lb)«); Lily ničesar ne pretvarja, zato navedite svoje zaokroževanje. Količino vnesite z
quantity-input-div, katerega število upošteva meje vsake enote. -
Rastni diagram je
line-chartz vašimi percentilnimi črtami kot nizi, točkami otroka in njegovo podatkovno tabelo starosti in vrednosti; Lily ne izračuna percentilov in ne dobavlja rastnih referenc.
Zdravila
- Generična imena z malimi črkami, razen črk tall man s seznamov FDA in ISMP ali seznama vaše države (Avstralija in Kanada objavljata svoje). Označite jih v
nameSegments; Lily jih nikoli ne ugiba. - Jakost zapišite s
formatQuantity: brez končne ničle, z vodilno ničlo, z nelomljivim presledkom pred enoto. - Ohranite primerjalnik izvida:
formatQuantity(5, "mmol/L", locale, "<")zapiše „<5 mmol/L“.Quantity.comparatorv FHIR se zapiše kot <, ≤, ≥ ali >; če ga izpustite, se „manj kot 5“ spremeni v „5“. - Pišite mL, nikoli cc, in se izogibajte vsaki kratici s seznama kratic, nagnjenih k napakam, ki ga vodi ISMP.
- Nikoli ne prirežite imena ali odmerka zdravila.
Datumi in časi
- Mesec zapišite z besedo, da datuma ni mogoče brati na dva načina (
Intl.DateTimeFormatzmonth: "short"). - Uro izberite namerno:
hourCyclepodajte izrecno. NHS zahteva 24-urno uro; to je britansko pravilo, ne svetovno, zato je Lily nikoli ne izbere namesto vas. - Starosti sledijo pasovom Common User Interface prek
ageParts(); storitev z drugačno konvencijo poda svoje besede. -
Datum, znan le do meseca ali leta, takšen tudi ostane: vprašajte zanj z
date-fieldprecision="month"ali"year", shranite2019-03ali2019in ga zapišite zformatPartialDate(). Nikoli si ne izmislite dneva. -
Trajanje je
duration-view,<time datetime="P3DT4H">z vašimi besedami, izdurationParts()inIntl.DurationFormat.
Nadzorne plošče
- Oddelčna tabla ali zaslon poveljniškega centra se osvežuje pogosto. Nikoli ne napovedujte vsake spremembe: imejte eno vljudno povzetkovno regijo („3 proste postelje, 2 načrtovana odpusta“) in pustite ljudem brati tablo.
- Vsako stanje na tabli (postelja očiščena, zasedena, blokirana) je besedilo ali stanje
data-*z besedami, nikoli le barva. -
Nič ne utripa (WCAG 2.2.2, 2.3.1), tabla, ki se posodablja s časovnikom, pa ima kontrolnik za premor ali se posodobi le na zahtevo; posodobitve nikoli ne premaknejo fokusa. Zamujen vnos to pove z besedami (»Čaka več kot 20 minut«) z
data-overdue. - Število ali delež pokaže svoj imenovalec (»12 od 68«) in povezuje na seznam za njim.
- Seznam ali časovnica pove, česa je pogled: kaj prikazuje, v kakšnem vrstnem redu in za katero obdobje, kaj je skrito in zakaj ter kateri viri niso odgovorili. Prazen seznam iz vira, ki ni odgovoril, ne dokazuje, da nič ne obstaja.
-
Seznam opomnikov je
record-list, katerega elementi nosijo rok (review-date) in stanje roka z besedami, zdata-due; pravilo, ki ga je ustvarilo, je vaše.
Obrazci
-
Vprašanje z odgovori »da«, »ne« ali »ni vprašano« je
radio-groups tremi odgovori, nobeden vnaprej izbran, nikoli potrditveno polje: polje ne loči »zanika« od »nikoli vprašano«. Pregled sistemov je enfieldsetna organski sistem, gumb »vsi drugi odsotni« pa nastavi le neodgovorjene. -
Vprašanje s seznamom odgovorov (zdravila, naslovi) je
repeatable-fieldset: element se doda ali odstrani, fokus mu sledi, vsak gumb za odstranitev pa je poimenovan po svojem elementu. -
Število z decimalno vejico: prikažite ga z
Intl.NumberFormatin tam, kjertype="number"ne sprejme vejice, ga sprejmite v besedilnem polju zinputmode="decimal"in razčlenite v svoji kodi. Nikoli ne spreminjajte vrednosti, ki jo je oseba vnesla, niti da bi jo omejili na interval: vrednost zunaj intervala je napaka, ki jo lahko vidi. -
Dolg seznam, ki hkrati prikaže le del možnosti, nastavi
aria-setsizeinaria-posinsetna vsaki možnosti in upošteva, da iskanje po strani ne vidi ostalega.
Zapisi, opombe in njihov izvor
-
Pred vrsticami povejte, česa je seznam ali mreža pogled: obdobje in vrstni red, kaj izpušča in zakaj ter kateri viri niso odgovorili (»Zadnjih 12 mesecev, najnovejše najprej. Zapis osebnega zdravnika ni odgovoril.«). Dajte
record-listintimeline-listcoverageLabel, pomočnikudata-gridpa njegovcoverageLabel. Prazen seznam iz vira, ki ni odgovoril, to pove z besedami, da ga nikoli ne preberejo kot »nič zabeleženo«. -
Povejte, od kod zapis prihaja in ali je dokončen, z
record-provenance-view: podpisan, čaka na podpis, spremenjen, shranjen na tej napravi in še ne poslan. Nepodpisan osnutek nikoli ne sme videti podpisan. - Vnos o nekom drugem (staršu, plodu, darovalcu) najprej pove, na koga se nanaša, z
subjectLabel. -
Zadržan vnos ostane na seznamu z vašimi besedami (»Omejeno: za vas ni na voljo«), pomotoma vnesen vnos pa ostane prečrtan z »Vneseno pomotoma«: dajte
record-list-itemalitimeline-list-itementryStateinentryStateLabel. Nikoli ne odstranite nobenega od njiju tiho, saj se vrzel bere kot »nič se ni zgodilo«. -
V klinični opombi označite vir vsakega odlomka (vtipkano, narekovano, predloga, preneseno iz prejšnje opombe, ustvarjeno) z
data-sourcein vidnimi besedami, da prenesenega ali ustvarjenega besedila nikoli ne zamenjajo za današnji pregled. -
Razdelek, ki se ne more naložiti, je
unavailablez vašimi besedami, z gumbom za ponovni poskus; tehnična koda, če je sploh prikazana, je za razkritjem. Napaka, ki jo je povzročilo dejanje osebe, se oznani skupaj z vrednostjo, ki jo ima zapis zdaj; napaka pri nalaganju strani ne. -
Zgodovina naročila je
timeline-list, en element na korak (načrtovano, razporejeno, aktivno, prekinjeno, zaključeno, preklicano) s časom in razlogom, trenutno stanje pa tudi na elementu.
Od FHIR do Lily
Lily ne bere virov FHIR; vaša koda jih preslika v lastnosti Lily. Ti tabeli preslikata mednarodni povzetek bolnika HL7 FHIR (IPS 2.0.1, FHIR R4). Preslikava kod je predlog: o njej odloča vaša presoja klinične varnosti, besede za vsako stanje pa so vaše.
| Razdelek IPS | Lily |
|---|---|
Alergije in preobčutljivosti (48765-2) |
allergy-record-list in njegovi elementi |
Povzetek zdravil (10160-0) |
medication-record-list, vsak element pa vsebuje medication-view |
Seznam težav (11450-4) |
problem-record-list in njegovi elementi |
Cepljenja (11369-6) |
immunization-record-list in njegovi elementi |
Izvidi (30954-2) |
observation-view v podatkovni tabeli ali povzetkovnem seznamu |
Zgodovina posegov (47519-4) |
procedure-record-list in njegovi elementi |
Medicinski pripomočki (46264-8) |
device-record-list in njegovi elementi |
Opozorila (104605-1) |
Opozorilno besedilo ali opozorilo, nikoli za strnjenim kontrolnikom |
| Kateri koli drug razdelek | record-list in njegovi elementi |
| Zahtevan razdelek, ki ga dokument izpušča | Seznam razdelka z status="omitted" |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
status="none-known" seznama |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable" z besedami, ki povedo, za kateri primer gre |
Kode IPS no-known-allergies, no-known-medications in podobne |
status="none-known" |
Kode IPS no-allergy-info, no-medication-info in podobne |
status="not-recorded" |
AllergyIntolerance.criticality |
criticality, ločeno od severity reakcije |
clinicalStatus, verificationStatus |
Iste lastnosti pri elementih alergij in težav, z istimi kodami |
MedicationStatement.status |
status elementa zdravila |
Dosage.text |
medication-view dosageText |
Observation.status |
status komponente observation-view, z istimi kodami |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (tudi na seznamih zapisov) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
Zapis entered-in-error preslikajte v njegovo stanje entered-in-error, z besedami, namesto da ga tiho izpustite: ali ga sploh prikazati, odloči vaša storitev.
Od openEHR do Lily
Lily ne bere niti sestavkov openEHR. Preslikava za podatkovne tipe in kode referenčnega modela openEHR kot predlog, o katerem odloči vaš pregled klinične varnosti:
| openEHR | Lily |
|---|---|
DV_QUANTITY (vnos) |
quantity-input-div; enote kot kode UCUM z vašimi besedami |
DV_QUANTITY (prikaz), magnitude_status |
observation-view z 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 z meaning |
observation-view ranges |
DV_DATE delni (leto, leto in mesec) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view z durationParts() |
DV_PROPORTION |
formatProportion() znotraj observation-view |
DV_ORDINAL, DV_SCALE |
radio-group , katerega oznake nosijo število in njegove besede |
DV_CODED_TEXT |
vzorec kodiranih vrednosti spodaj |
DV_BOOLEAN |
checkbox-input, le kadar »ni vprašano« ne more nastopiti |
ELEMENT.null_flavour 253 neznano, 271 ni podatkov |
status="not-recorded" ali "unavailable" z besedami, ki povedo, za kateri primer gre |
null_flavour 272 zakrito |
observation-view status="masked" |
null_flavour 273 ni smiselno |
status="not-applicable" |
PARTY_RELATED subjekt |
subjectLabel na elementih zapisa |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| Koraki stroja stanj navodil | timeline-list korakov, s trenutnim stanjem na elementu |
element arhetipa s pojavitvami 0..* |
repeatable-fieldset |
Kodirane vrednosti
- Prikažite
Coding.display; če ga ni,CodeableConcept.text; če ni niti tega,system|code. Nikoli prazne celice. - Ponudite kontrolnik, ki ob vsaki vrednosti razkrije kodni sistem in kodo, na primer preklopni gumb z besedilom „Pokaži kode“. Skrite kode ostanejo zunaj vrstnega reda branja, dokler niso prikazane.
- Klinično besedilo označite z jezikom dokumenta (
lang), ki se lahko razlikuje od jezika vmesnika. Prevajajte vmesnik; kliničnih vsebin nikoli ne prevajajte. - Lily ne dobavlja terminologije: nobenega iskanja po SNOMED CT, LOINC, ATC ali UCUM. Pišite, kar pravi dokument. Vzorec prikazuje stran
/patient-summaryprimera SvelteKit.
Česa Lily ne bo storila
- Izračunavati ocene zgodnjega opozarjanja, rastnega centila, odmerka ali referenčnega razpona.
- Dobavljati zbirke zdravil, seznama tall man ali kod SNOMED CT, MKB, LOINC ali UCUM.
- Reproducirati licenciranega instrumenta (Wong-Baker FACES) ali oblike drugega organa (grafikona NEWS2).
- Omejevati števila hkrati odprtih zapisov.
- Izpeljati interpretacijo iz intervala, pretvarjati enote ali razčlenjevati relativni datum (»naslednji torek«).
- Uporabiti stikalo za »da, ne ali neznano«:
switchv ARIA nima tretjega stanja, zato so to trije izbirni gumbi.
Raziskave, viri in odločitve za tem vodnikom so v spec/healthcare-ui.