Používateľské rozhrania v zdravotníctve

Sprievodca pre tímy, ktoré vytvárajú klinický softvér s Lily: klinické portály, výsledky a výkazníctvo, predpisovanie a podávanie liekov, podpora rozhodovania a nemocničné prehľadové panely.

Preklady tejto stránky sú neskontrolované strojové návrhy. Anglická stránka je záväzná verzia.

Čo Lily robí a čo nerobí

Lily vám dáva kontrakty zobrazenia: sémantické značkovanie, ARIA, správanie klávesnice a háčiky tried pre veci, ktoré sa opakujú na klinických obrazovkách. Nedáva vám klinickú logiku, klinický obsah ani regulačné tvrdenie.

Čo poskytuje Lily a čo poskytujete vy
Lily poskytuje Vy poskytujete
observation-view: hodnotu, jednotku, príznak slovami, rozsah a stavy chýbajúcich údajov Hodnotu, rozhodnutie o príznaku, referenčný rozsah
allergy-record-list a allergy-record-list-item: stav, ktorý nikdy nie je prázdny Záznam o alergii a jeho terminológiu
medication-view: názov, silu, formu, cestu podania a frekvenciu, nič sa neskracuje Údaje o lieku, segmenty tall man, naformátovanú silu
decision-support-card: tvar karty CDS Hooks Pravidlá, akcie návrhov, zaznamenanie výsledku
early-warning-score-view: skóre, pásmo a eskaláciu, zobrazené Systém skórovania a jeho validovaný výpočet
age-view a ageParts(): vek v jednotkách, ktoré mu vyhovujú Slová pre jednotky (Intl.DurationFormat alebo vaše vlastné označenia)
formatQuantity(): 5 mg, nikdy 5,0 mg; 0,5 mg, nikdy ,5 mg Číslo, jednotku a jazykové nastavenie
Zloženie bannera pacienta Každé označenie a hodnotu a to, kto smie vidieť klinické informácie

Regulácia. Softvér, ktorý počíta skóre, percentil, dávku alebo liekovú interakciu, je zvyčajne zdravotnícka pomôcka. Lily nič z toho nepočíta, zámerne. Ak je váš produkt regulovaný, zodpovedáte za jeho dokumentáciu použiteľnosti (IEC 62366-1, usmernenie FDA o ľudských faktoroch, EU MDR). Testy Lily, jej samostatne posúdená správa o súlade s prístupnosťou a jej matica čítačiek obrazovky môžu byť dôkazom v tejto dokumentácii; nič z toho nie je vyhlásenie o súlade a matica zatiaľ nemá výsledky.

Upozornenia: prerušujte len kvôli kritickému

Únava z upozornení je bezpečnostný problém: keď každé upozornenie prerušuje, ľudia ich zahodia všetky. Odporúčanie AHRQ je odstupňovať upozornenia podľa závažnosti a prerušujúce urobiť len tie závažné.

  • Informácia (indicator="info"): priamo v texte, vedľa úlohy, karta podpory rozhodovania na stránke.
  • Varovanie (indicator="warning"): viditeľné bez blokovania, tá istá karta, štýlovaná tak, aby vynikla; bez modálneho okna.
  • Kritické (indicator="critical"): vložte kartu do dialógu upozornenia a ponúknite overrideReasons, aby sa pri jej zatvorení pýtal dôvod.
  • Karta podpory rozhodovania nikdy nie je sama osebe živou oblasťou. Novú kritickú kartu oznámte presunutím fokusu do dialógu, nie cez aria-live.
  • Odstráňte kartu, keď sa udalosť, na ktorú odpovedala, stane znova, a zaznamenajte každý výsledok (prijatá, alebo prepísaná s dôvodom).

Zámeny pacienta: identifikujte, neobmedzujte

  • Zobrazte dva identifikátory všade, kde sa objavia údaje pacienta: meno s dátumom narodenia a národný identifikátor s jeho komponentom zobrazenia (The Joint Commission, Quick Safety 45).
  • Používajte banner pacienta na každej obrazovke, ktorá pracuje so záznamom jedného pacienta, a nechajte ho viditeľný.
  • Pred akciou so záznamom, ktorý nie je ten v banneri, ju potvrďte menom, dátumom narodenia a identifikátorom.
  • Záznam o niekom inom než pacientovi (anamnéza rodiča, plod, darca) najprv slovami povie, koho sa týka: dajte položkám záznamu subjectLabel („Matka“), aby diagnóza príbuzného nikdy nebola čítaná ako pacientova (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Neobmedzujte, koľko záznamov môže klinik otvoriť: randomizovaná štúdia s 3 356 klinikmi (JAMA, 2019) zistila, že to neznížilo počet objednávok pre nesprávneho pacienta, a ľudia to obchádzajú.
  • Ponuka akcií nad jedným záznamom najprv pomenuje tento záznam, pomocou subjectLabel pri context-menu alebo dropdown-menu („Ada Lovelace, krvný tlak 3. nov.“): neinteraktívna prvá časť, ktorá je zároveň prístupným názvom ponuky.
  • Každú akciu zaraďte do úrovne podľa toho, čo robí, a úroveň ukážte skôr, než sa vykoná. Rutinná (zobraziť, tlačiť) sa vykoná hneď. Dokumentovaná povie, čo zapíše do záznamu („Pridá poznámku ku kontaktu“). Klinická (vysadiť, zrušiť ordináciu) sa opýta druhýkrát, v alert-dialog , ktorého potvrdzovacie tlačidlo je sloveso („Vysadiť“), nikdy „OK“ ani „Áno“. Odhaľujúca (núdzový prístup, zdieľanie mimo ošetrujúceho tímu) sa najprv opýta na dôvod a zaznamená ho.
  • Keď je otvorených viac záznamov (karty, okná, rozdelené panely), viditeľný text a prístupný názov každej karty obsahujú meno pacienta a druhý identifikátor, aktívny panel opakuje banner a žiadna akcia sa netýka iného pacienta než pacienta svojho panela.
  • Zobrazte miesto, ku ktorému budú záznamy priradené (oddelenie, ambulanciu alebo zariadenie zvolené pri prihlásení), ako text v hlavičke stránky a jeho zmenu urobte výslovnou akciou.
  • Zobrazte v banneri aktívnu návštevu alebo „Žiadna aktívna návšteva“. Formulár, ktorý potrebuje návštevu, to povie a ponúkne jej začatie, namiesto zlyhania pri uložení.

Banner pacienta

Zloženie je zdokumentované pri medical-banner, s funkčnou stránkou na /patient-banner v ukážkovej aplikácii SvelteKit:

  • dva identifikátory a vek vedľa dátumu narodenia;
  • alergie cez zoznam alergií, aby „žiadne známe alergie“, „nezaznamenané“ a „nedostupné“ nikdy nevyzerali rovnako;
  • chýbajúca hodnota je slovami („Neznáme“), nikdy otáznik, pomlčka alebo prázdna bunka;
  • zomretý pacient: data-deceased pre tému a viditeľný riadok textu, nikdy len farba;
  • žiadne pole nie je skrátené, orezané ani skryté pri žiadnej šírke; text sa zalamuje.
  • príznaky pacienta („Potrebuje tlmočníka“, „Riziko infekcie“) sú opísaná tag-group zo slov, nikdy len ikony či farba, a zostávajú viditeľné, keď sa banner zalomí.

Výsledky

  • Jedno zobrazenie výsledku, nech pochádza z ktoréhokoľvek systému: zobrazenie pozorovania.
  • Príznak sú slová z vášho prekladu (flagLabel), s interpretačným kódom FHIR v data-interpretation pre tému.
  • Oddeľte nové výsledky od skorších a ukážte trend (sparkline alebo čiarový graf s tabuľkou údajov): klinici hľadajú významnú zmenu, nielen rozsah.
  • Výsledok, ktorý nebol nikdy zaznamenaný, a nedostupný výsledok sú rozdielne stavy s rozdielnymi slovami.
  • Neznáme nie je normálne. Výsledok, ktorého referenčné rozpätie chýba, sa stále načítava alebo je nečitateľné, nemá interpretáciu a povie to; observation-view ju nikdy neodvodí, takže výsledok s rozpätím a bez interpretation nezobrazí žiadny príznak.
  • Výsledok mimo stupnice je hranica prístroja so znamienkom porovnania („> 33,3 mmol/l“: formatQuantity s ">") a vaším kritickým príznakom, nikdy holé číslo. Približná hodnota si ponechá svoj ≈ ("~").
  • Ďalšie pomenované rozpätia („Kritické: pod 2,5“) zadajte ako ranges, každé ako samostatnú časť.
  • Opravený alebo pozmenený výsledok si ponechá nahradenú hodnotu v <del>, s vašimi slovami o tom, kedy sa zmenila (previousValue, previousLabel), aby klinik, ktorý čítal starú hodnotu, vedel, že sa zmenila.
  • Intervalové meranie uvádza svoju dĺžku a funkciu („Priemer, 24 hodín“) a stav a metóda merania („Posediačky, veľká manžeta“) sú viditeľný text vedľa, nikdy len tip (openEHR INTERVAL_EVENT, state, protocol).
  • Trend potrebuje porovnateľné body: nekreslite čiaru pod svojím minimom, prerušte čiaru tam, kde sa zmenila metóda alebo stanovenie, a povedzte smer a význam slovami („klesá, zlepšuje sa“).
  • Vitálne funkcie zadané v jednej sústave jednotiek môžu vedľa ukázať druhú ako váš text („70 kg (154 lb)“); Lily nič neprevádza, takže uveďte svoje zaokrúhlenie. Množstvo zadávajte pomocou quantity-input-div, ktorého číslo preberá limity každej jednotky.
  • Rastový graf je line-chart s vašimi percentilovými čiarami ako radmi, bodmi dieťaťa a jeho dátovou tabuľkou veku a hodnoty; Lily nepočíta percentily a nedodáva rastové referencie.

Lieky

  • Generické názvy malými písmenami, okrem písmen tall man zo zoznamov FDA a ISMP alebo zo zoznamu vašej krajiny (Austrália a Kanada zverejňujú vlastné). Označte ich v nameSegments; Lily ich nikdy neuhádne.
  • Silu zapisujte cez formatQuantity: bez koncovej nuly, s úvodnou nulou, s nezalomiteľnou medzerou pred jednotkou.
  • Zachovajte komparátor výsledku: formatQuantity(5, "mmol/L", locale, "<") zapíše „<5 mmol/L“. Quantity.comparator vo FHIR sa zapisuje ako <, ≤, ≥ alebo >; ak ho vynecháte, „menej ako 5“ sa zmení na „5“.
  • Píšte mL, nikdy cc, a vyhnite sa každej skratke zo zoznamu skratiek náchylných na chyby od ISMP.
  • Nikdy neskracujte názov ani dávku lieku.

Dátumy a časy

  • Mesiac píšte textom, aby sa dátum nedal čítať dvoma spôsobmi (Intl.DateTimeFormat s month: "short").
  • Hodiny zvoľte zámerne: odovzdajte hourCycle výslovne. NHS žiada 24-hodinový formát; to je britské pravidlo, nie celosvetové, preto ho Lily nikdy nevyberá za vás.
  • Vek sleduje pásma Common User Interface cez ageParts(); služba s inou konvenciou odovzdá vlastné slová.
  • Dátum známy len na mesiac alebo rok taký zostane: pýtajte sa naň pomocou date-field precision="month" alebo "year", uložte 2019-03 alebo 2019a zapíšte ho pomocou formatPartialDate(). Nikdy si nevymýšľajte deň.
  • Trvanie je duration-view, <time datetime="P3DT4H"> obsahujúci vaše slová, z durationParts() a Intl.DurationFormat.

Prehľadové panely

  • Oddelenská tabuľa alebo obrazovka riadiaceho centra sa aktualizuje často. Nikdy neoznamujte každú zmenu: majte jednu zdvorilú súhrnnú oblasť („3 voľné lôžka, 2 plánované prepustenia“) a nechajte ľudí čítať tabuľu.
  • Každý stav na tabuli (lôžko vyčistené, obsadené, blokované) je text alebo stav data-* so slovami, nikdy len farba.
  • Nič nebliká (WCAG 2.2.2, 2.3.1) a tabuľa aktualizovaná časovačom má ovládanie pauzy alebo sa aktualizuje len na požiadanie; aktualizácie nikdy nepresúvajú fokus. Oneskorený záznam to povie slovami („Čaká viac ako 20 minút“) s data-overdue.
  • Počet alebo podiel ukazuje svojho menovateľa („12 z 68“) a odkazuje na zoznam za ním.
  • Zoznam alebo časová os hovorí, čoho je pohľadom: čo ukazuje, v akom poradí a za aké obdobie, čo je skryté a prečo, a ktoré zdroje neodpovedali. Prázdny zoznam zo zdroja, ktorý neodpovedal, nedokazuje, že nič neexistuje.
  • Zoznam pripomienok je record-list , ktorého položky nesú termín (review-date) a stav termínu slovami, s data-due; pravidlo, ktoré ho vytvorilo, je vaše.

Formuláre

  • Otázka s odpoveďami „áno“, „nie“ alebo „nepýtali sa“ je radio-group z troch odpovedí, žiadna vopred zvolená, nikdy začiarkavacie políčko: políčko nerozlíši „popiera“ od „nikdy sa nepýtali“. Prehľad systémov je jeden fieldset na orgánový systém a tlačidlo „všetky ostatné neprítomné“ nastaví len nezodpovedané.
  • Otázka so zoznamom odpovedí (lieky, adresy) je repeatable-fieldset: položka sa pridá alebo odoberie, fokus nasleduje a každé tlačidlo odobrania je pomenované podľa svojej položky.
  • Číslo s desatinnou čiarkou: zobrazte ho pomocou Intl.NumberFormat a tam, kde type="number" neprijíma čiarku, ho prevezmite v textovom poli s inputmode="decimal" a spracujte vo svojom kóde. Nikdy nemeňte hodnotu, ktorú osoba napísala, ani kvôli obmedzeniu na rozpätie: hodnota mimo rozpätia je chyba, ktorú môže vidieť.
  • Dlhý zoznam, ktorý naraz vykresľuje len časť možností, nastavuje aria-setsize a aria-posinset pri každej možnosti a pamätá, že hľadanie na stránke zvyšok nevidí.

Záznamy, poznámky a ich pôvod

  • Pred riadkami povedzte, čoho je zoznam alebo mriežka pohľadom: obdobie a poradie, čo vynecháva a prečo, a ktoré zdroje neodpovedali („Posledných 12 mesiacov, najnovšie prvé. Záznam všeobecného lekára neodpovedal.“). Dajte record-list a timeline-list coverageLabel, a pomocníkovi data-grid jeho coverageLabel. Prázdny zoznam zo zdroja, ktorý neodpovedal, to povie slovami, aby nebol nikdy čítaný ako „nič nezaznamenané“.
  • Povedzte, odkiaľ záznam pochádza a či je konečný, pomocou record-provenance-view: podpísaný, čaká na podpis, pozmenený, uložený v tomto zariadení a ešte neodoslaný. Nepodpísaný koncept nikdy nesmie vyzerať podpísane.
  • Záznam o niekom inom (rodičovi, plode, darcovi) najprv povie, koho sa týka, pomocou subjectLabel.
  • Zadržaný záznam zostane v zozname s vašimi slovami („Obmedzené: pre vás nedostupné“) a omylom vytvorený záznam zostane prečiarknutý s „Zadané omylom“: dajte record-list-item alebo timeline-list-item entryState a entryStateLabel. Nikdy žiadny z nich potichu neodstraňujte, pretože medzera sa číta ako „nič sa nestalo“.
  • V klinickej poznámke označte zdroj každej pasáže (napísané, nadiktované, šablóna, prevzaté z predchádzajúcej poznámky, vygenerované) pomocou data-source a viditeľných slov, aby prevzatý či vygenerovaný text nebol nikdy považovaný za dnešné vyšetrenie.
  • Oddiel, ktorý nemožno načítať, je unavailable vašimi slovami, s tlačidlom na zopakovanie; technický kód, ak je vôbec zobrazený, je za rozbalením. Zlyhanie spôsobené akciou osoby sa oznámi spolu s hodnotou, ktorú záznam teraz má; zlyhanie pri načítaní stránky nie.
  • História ordinácie je timeline-list, jedna položka na krok (plánované, naplánované na čas, aktívne, pozastavené, dokončené, zrušené) s časom a dôvodom a aktuálny stav aj na položke.

Z FHIR do Lily

Lily nečíta zdroje FHIR; váš kód ich mapuje na vlastnosti Lily. Tieto tabuľky mapujú medzinárodný súhrn o pacientovi HL7 FHIR (IPS 2.0.1, FHIR R4). Mapovanie kódov je návrh: rozhoduje o ňom vaše posúdenie klinickej bezpečnosti a slová pre každý stav sú vaše vlastné.

Sekcie IPS a komponenty Lily pre ne
Sekcia IPS Lily
Alergie a intolerancie (48765-2) allergy-record-list a jeho položky
Súhrn liekov (10160-0) medication-record-list, v ktorom každá položka obsahuje medication-view
Zoznam problémov (11450-4) problem-record-list a jeho položky
Imunizácie (11369-6) immunization-record-list a jeho položky
Výsledky (30954-2) observation-view v dátovej tabuľke alebo súhrnnom zozname
História výkonov (47519-4) procedure-record-list a jeho položky
Zdravotnícke pomôcky (46264-8) device-record-list a jeho položky
Upozornenia (104605-1) Varovný text alebo upozornenie, nikdy nie za zbaleným ovládacím prvkom
Akákoľvek iná sekcia record-list a jeho položky
Povinná sekcia, ktorú dokument vynecháva Zoznam sekcie s status="omitted"
Kódy FHIR a im zodpovedajúce hodnoty Lily
FHIR Lily
emptyReason nilknown status="none-known" zoznamu
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable" so slovami, ktoré povedia, o ktorý prípad ide
Kódy IPS no-known-allergies, no-known-medications a podobné status="none-known"
Kódy IPS no-allergy-info, no-medication-info a podobné status="not-recorded"
AllergyIntolerance.criticality criticality, oddelene od severity reakcie
clinicalStatus, verificationStatus Rovnaké vlastnosti na položkách alergií a problémov, s rovnakými kódmi
MedicationStatement.status status položky lieku
Dosage.text medication-view dosageText
Observation.status status komponentu observation-view, s rovnakými kódmi
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (aj na zoznamoch záznamov)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Záznam entered-in-error namapujte na jeho stav entered-in-error, so slovami, namiesto toho, aby ste ho potichu vynechali: či ho vôbec zobraziť, je rozhodnutie vašej služby.

Od openEHR k Lily

Lily nečíta ani kompozície openEHR. Mapovanie dátových typov a kódov referenčného modelu openEHR ako návrh, o ktorom rozhodne vaše posúdenie klinickej bezpečnosti:

Dátové typy a kódy openEHR a im zodpovedajúce hodnoty Lily
openEHR Lily
DV_QUANTITY (zadávanie) quantity-input-div; jednotky ako kódy UCUM s vašimi slovami
DV_QUANTITY (zobrazenie), 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 čiastočný (rok, rok a mesiac) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view s durationParts()
DV_PROPORTION formatProportion() vnútri observation-view
DV_ORDINAL, DV_SCALE radio-group , ktorého popisky nesú číslo a jeho slová
DV_CODED_TEXT vzor kódovaných hodnôt nižšie
DV_BOOLEAN checkbox-input, len keď „nepýtali sa“ nemôže nastať
ELEMENT.null_flavour 253 neznáme, 271 žiadne informácie status="not-recorded" alebo "unavailable" so slovami, ktoré povedia, o ktorý prípad ide
null_flavour 272 maskované observation-view status="masked"
null_flavour 273 neuplatňuje sa status="not-applicable"
PARTY_RELATED subjekt subjectLabel na položkách záznamu
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Kroky stavového automatu inštrukcií timeline-list z krokov, s aktuálnym stavom na položke
položka archetypu s výskytom 0..* repeatable-fieldset

Kódované hodnoty

  • Zobrazte Coding.display; ak nie je, CodeableConcept.text; ak nie je ani ten, system|code. Nikdy nie prázdnu bunku.
  • Ponúknite ovládací prvok, ktorý pri každej hodnote odhalí kódovací systém a kód, napríklad prepínacie tlačidlo s textom „Zobraziť kódy“. Skryté kódy zostanú mimo poradia čítania, kým sa nezobrazia.
  • Klinický text označte jazykom dokumentu (lang), ktorý sa môže líšiť od jazyka rozhrania. Prekladajte rozhranie; klinický obsah nikdy neprekladajte.
  • Lily neposkytuje terminológiu: žiadne vyhľadávanie SNOMED CT, LOINC, ATC ani UCUM. Píšte to, čo hovorí dokument. Vzor ukazuje stránka /patient-summary príkladu SvelteKit.

Čo Lily nebude robiť

  • Počítať skóre včasného varovania, rastový percentil, dávku ani referenčný rozsah.
  • Dodávať databázu liekov, zoznam tall man ani kódy SNOMED CT, MKCH, LOINC či UCUM.
  • Reprodukovať licencovaný nástroj (Wong-Baker FACES) ani dizajn iného orgánu (tabuľku NEWS2).
  • Obmedzovať počet súčasne otvorených záznamov.
  • Odvodzovať interpretáciu z rozpätia, prevádzať jednotky alebo spracúvať relatívny dátum („budúci utorok“).
  • Používať prepínač pre „áno, nie alebo neznáme“: switch v ARIA nemá tretí stav, takže ide o tri prepínacie tlačidlá.

Výskum, zdroje a rozhodnutia za týmto sprievodcom sú v spec/healthcare-ui.