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.
| 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úkniteoverrideReasons, 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelpricontext-menualebodropdown-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-deceasedpre 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-groupzo 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 vdata-interpretationpre 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-viewju nikdy neodvodí, takže výsledok s rozpätím a bezinterpretationnezobrazí žiadny príznak. -
Výsledok mimo stupnice je hranica prístroja so znamienkom porovnania („> 33,3 mmol/l“:
formatQuantitys">") 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-charts 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.comparatorvo 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.DateTimeFormatsmonth: "short"). - Hodiny zvoľte zámerne: odovzdajte
hourCyclevý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-fieldprecision="month"alebo"year", uložte2019-03alebo2019a zapíšte ho pomocouformatPartialDate(). Nikdy si nevymýšľajte deň. -
Trvanie je
duration-view,<time datetime="P3DT4H">obsahujúci vaše slová, zdurationParts()aIntl.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, sdata-due; pravidlo, ktoré ho vytvorilo, je vaše.
Formuláre
-
Otázka s odpoveďami „áno“, „nie“ alebo „nepýtali sa“ je
radio-groupz 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 jedenfieldsetna 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.NumberFormata tam, kdetype="number"neprijíma čiarku, ho prevezmite v textovom poli sinputmode="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-setsizeaaria-posinsetpri 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-listatimeline-listcoverageLabel, a pomocníkovidata-gridjehocoverageLabel. 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-itemalebotimeline-list-itementryStateaentryStateLabel. 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-sourcea 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
unavailablevaš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é.
| 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" |
| 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:
| 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-summaryprí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“:
switchv 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.