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.

Kaj ponuja Lily in kaj ponudite vi
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 ponudite overrideReasons, 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 (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • 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 subjectLabel pri context-menu ali dropdown-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-deceased za 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-group iz 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 v data-interpretation za 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-view je nikoli ne izpelje, zato izvid z intervalom in brez interpretation ne pokaže oznake.
  • Izvid zunaj lestvice je meja instrumenta s primerjalnim znakom (»> 33,3 mmol/l«: formatQuantity z ">") 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-chart z 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.comparator v 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.DateTimeFormat z month: "short").
  • Uro izberite namerno: hourCycle podajte 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-field precision="month" ali "year", shranite 2019-03 ali 2019in ga zapišite z formatPartialDate(). Nikoli si ne izmislite dneva.
  • Trajanje je duration-view, <time datetime="P3DT4H"> z vašimi besedami, iz durationParts() in Intl.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, z data-due; pravilo, ki ga je ustvarilo, je vaše.

Obrazci

  • Vprašanje z odgovori »da«, »ne« ali »ni vprašano« je radio-group s tremi odgovori, nobeden vnaprej izbran, nikoli potrditveno polje: polje ne loči »zanika« od »nikoli vprašano«. Pregled sistemov je en fieldset na 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.NumberFormat in tam, kjer type="number" ne sprejme vejice, ga sprejmite v besedilnem polju z inputmode="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-setsize in aria-posinset na 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-list in timeline-list coverageLabel, pomočniku data-grid pa njegov coverageLabel. 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-item ali timeline-list-item entryState in entryStateLabel. 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-source in vidnimi besedami, da prenesenega ali ustvarjenega besedila nikoli ne zamenjajo za današnji pregled.
  • Razdelek, ki se ne more naložiti, je unavailable z 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.

Razdelki IPS in komponente Lily zanje
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"
Kode FHIR in vrednosti Lily zanje
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:

Podatkovni tipi in kode openEHR ter ustrezne vrednosti Lily
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-summary primera 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«: switch v ARIA nima tretjega stanja, zato so to trije izbirni gumbi.

Raziskave, viri in odločitve za tem vodnikom so v spec/healthcare-ui.