Uživatelská rozhraní ve zdravotnictví

Průvodce pro týmy, které s Lily vytvářejí klinický software: klinické portály, výsledky a reporting, předepisování a podávání léků, podpora rozhodování a nemocniční přehledové panely.

Překlady této stránky jsou nerevidované strojové koncepty. Anglická stránka je závazná verze.

Co Lily dělá a co ne

Lily vám dává kontrakty pro zobrazení: sémantické značkování, ARIA, chování klávesnice a třídy pro stylování toho, co se na klinických obrazovkách opakuje. Nedává vám klinickou logiku, klinický obsah ani regulatorní tvrzení.

Co poskytuje Lily a co poskytujete vy
Lily poskytuje Vy poskytujete
observation-view: hodnota, jednotka, příznak slovy, rozmezí a stavy chybějící hodnoty Hodnotu, rozhodnutí o příznaku, referenční rozmezí
allergy-record-list a allergy-record-list-item: stav, který není nikdy prázdný Záznam o alergii a jeho terminologii
medication-view: název, síla, forma, cesta podání a četnost, nic není zkráceno Data o léku, segmenty tall man, naformátovanou sílu
decision-support-card: tvar karty CDS Hooks Pravidla, akce návrhů, zaznamenání výsledku
early-warning-score-view: skóre, pásmo a eskalace, zobrazené Skórovací systém a jeho validovaný výpočet
age-view a ageParts(): věk v jednotkách, které mu vyhovují Slova pro jednotky (Intl.DurationFormat nebo vaše vlastní popisky)
formatQuantity(): 5 mg, nikdy 5,0 mg; 0,5 mg, nikdy ,5 mg Číslo, jednotku a jazykovou verzi
Složení pacientského banneru Každý popisek a hodnotu a to, kdo smí klinické informace vidět

Regulace. Software, který počítá skóre, centil, dávku nebo lékovou interakci, je obvykle zdravotnický prostředek. Lily nic z toho záměrně nepočítá. Pokud je váš produkt regulovaný, odpovídáte za jeho soubor o inženýrství použitelnosti (IEC 62366-1, pokyny FDA k lidským faktorům, EU MDR). Testy Lily, její vlastní hodnocení zprávy o shodě přístupnosti a její matice odečítačů obrazovky mohou být důkazem v tomto souboru; nic z toho není prohlášením o shodě a matice zatím nemá žádné výsledky.

Upozornění: přerušujte jen kvůli kritickému

Únava z upozornění je bezpečnostní problém: když každé upozornění přeruší práci, lidé je odmítají všechna. Doporučení AHRQ je upozornění odstupňovat podle závažnosti a přerušovat jen těmi závažnými.

  • Informace (indicator="info"): vložená, vedle úkolu, karta podpory rozhodování na stránce.
  • Varování (indicator="warning"): viditelné bez blokování, tatáž karta, stylovaná tak, aby vynikla; žádné modální okno.
  • Kritické (indicator="critical"): vložte kartu do dialogu s upozorněním a nabídněte overrideReasons, aby se při jejím odmítnutí žádal důvod.
  • Karta podpory rozhodování není sama o sobě nikdy živou oblastí. Novou kritickou kartu oznamte přesunem fokusu do dialogu, ne pomocí aria-live.
  • Kartu odstraňte, když se znovu stane událost, na kterou odpovídala, a zaznamenejte každý výsledek (přijato, nebo přepsáno s důvodem).

Chyby se záměnou pacienta: identifikujte, neomezujte

  • Všude, kde se zobrazují údaje pacienta, ukazujte dva identifikátory: jméno s datem narození a národní identifikátor s jeho zobrazovací komponentou (The Joint Commission, Quick Safety 45).
  • Používejte pacientský banner na každé obrazovce, která jedná se záznamem jednoho pacienta, a nechte jej viditelný.
  • Před akcí se záznamem jiným, než je ten v banneru, ji potvrďte jménem, datem narození a identifikátorem.
  • Záznam o někom jiném než pacientovi (anamnéza rodiče, plod, dárce) nejprve slovy řekne, koho se týká: dejte položkám záznamu subjectLabel („Matka“), aby diagnóza příbuzného nebyla nikdy čtena jako pacientova (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Neomezujte, kolik záznamů smí klinik otevřít: randomizovaná studie s 3 356 kliniky (JAMA, 2019) zjistila, že to nesnížilo počet objednávek na nesprávného pacienta, a lidé to obcházejí.
  • Nabídka akcí nad jedním záznamem nejprve pojmenuje tento záznam, pomocí subjectLabel u context-menu nebo dropdown-menu („Ada Lovelace, krevní tlak 3. lis.“): neinteraktivní první část, která je zároveň přístupným názvem nabídky.
  • Každou akci zařaďte do úrovně podle toho, co dělá, a úroveň ukažte dříve, než se provede. Rutinní (zobrazit, tisknout) se provede hned. Dokumentovaná řekne, co zapíše do záznamu („Přidá poznámku ke kontaktu“). Klinická (vysadit, zrušit ordinaci) se zeptá podruhé, v alert-dialog , jehož potvrzovací tlačítko je sloveso („Vysadit“), nikdy „OK“ ani „Ano“. Odhalující (nouzový přístup, sdílení mimo ošetřující tým) se nejprve zeptá na důvod a zaznamená ho.
  • Když je otevřeno více záznamů (karty, okna, rozdělené panely), viditelný text a přístupný název každé karty obsahují jméno pacienta a druhý identifikátor, aktivní panel opakuje banner a žádná akce se netýká jiného pacienta než pacienta svého panelu.
  • Zobrazte místo, ke kterému budou záznamy přiřazeny (oddělení, ambulanci nebo zařízení zvolené při přihlášení), jako text v záhlaví stránky a jeho změnu udělejte výslovnou akcí.
  • Zobrazte v banneru aktivní návštěvu, nebo „Žádná aktivní návštěva“. Formulář, který potřebuje návštěvu, to řekne a nabídne její zahájení, místo aby selhal při uložení.

Pacientský banner

Složení je zdokumentováno u medical-banner, s fungující stránkou na /patient-banner v ukázkové aplikaci SvelteKit:

  • dva identifikátory a věk vedle data narození;
  • alergie prostřednictvím seznamu alergií, aby „žádné známé alergie“, „nezaznamenáno“ a „nedostupné“ nikdy nevypadaly stejně;
  • chybějící hodnota je napsána slovy („Neznámé“), nikdy otazníkem, pomlčkou ani prázdnou buňkou;
  • zemřelý pacient: data-deceased pro motiv a viditelný řádek textu, nikdy jen barva;
  • žádné pole není zkráceno, oříznuto ani skryto při žádné šířce; text se zalamuje.
  • příznaky pacienta („Potřebuje tlumočníka“, „Riziko infekce“) jsou popsaná tag-group ze slov, nikdy jen ikony nebo barva, a zůstávají viditelné, když se banner zalomí.

Výsledky

  • Jedno zobrazení výsledku, ať pochází z kteréhokoli systému: zobrazení pozorování.
  • Příznak jsou slova z vašeho překladu (flagLabel), s interpretačním kódem FHIR jako data-interpretation pro motiv.
  • Oddělte nové výsledky od dřívějších a ukažte trend (sparkline nebo spojnicový graf s datovou tabulkou): kliničtí pracovníci hledají významnou změnu, ne jen rozmezí.
  • Výsledek, který nebyl nikdy zaznamenán, a výsledek, který je nedostupný, jsou různé stavy s různými slovy.
  • Neznámé není normální. Výsledek, jehož referenční rozmezí chybí, se stále načítá nebo je nečitelné, nemá interpretaci a řekne to; observation-view ji nikdy neodvodí, takže výsledek s rozmezím a bez interpretation nezobrazí žádný příznak.
  • Výsledek mimo stupnici je mez přístroje se znaménkem srovnání („> 33,3 mmol/l“: formatQuantity s ">") a vaším kritickým příznakem, nikdy holé číslo. Přibližná hodnota si ponechá svůj ≈ ("~").
  • Další pojmenovaná rozmezí („Kritické: pod 2,5“) zadejte jako ranges, každé jako samostatnou část.
  • Opravený nebo pozměněný výsledek si ponechá nahrazenou hodnotu v <del>, s vašimi slovy o tom, kdy se změnila (previousValue, previousLabel), aby klinik, který četl starou hodnotu, věděl, že se změnila.
  • Intervalové měření uvádí svou délku a funkci („Průměr, 24 hodin“) a stav a metoda měření („Vsedě, velká manžeta“) jsou viditelný text vedle, nikdy jen tip (openEHR INTERVAL_EVENT, state, protocol).
  • Trend potřebuje srovnatelné body: nekreslete čáru pod svým minimem, přerušte čáru tam, kde se změnila metoda nebo stanovení, a řekněte směr a význam slovy („klesá, zlepšuje se“).
  • Vitální funkce zadané v jedné soustavě jednotek mohou vedle ukázat druhou jako váš text („70 kg (154 lb)“); Lily nic nepřevádí, takže uveďte své zaokrouhlení. Množství zadávejte pomocí quantity-input-div, jehož číslo přebírá limity každé jednotky.
  • Růstový graf je line-chart s vašimi percentilovými čarami jako řadami, body dítěte a jeho datovou tabulkou věku a hodnoty; Lily nepočítá percentily a nedodává růstové reference.

Léky

  • Generické názvy malými písmeny, kromě písmen tall man ze seznamů FDA a ISMP nebo seznamu vaší země (Austrálie a Kanada vydávají vlastní). Označte je v nameSegments; Lily je nikdy nehádá.
  • Sílu zapisujte pomocí formatQuantity: bez koncové nuly, s úvodní nulou, s nezalomitelnou mezerou před jednotkou.
  • Zachovejte u výsledku porovnávací operátor: formatQuantity(5, "mmol/L", locale, "<") zapíše „<5 mmol/L“. Quantity.comparator ve FHIR se zapisuje <, ≤, ≥ nebo >; jeho vynecháním se z „méně než 5“ stane „5“.
  • Pište mL, nikdy cc, a vyhněte se každé zkratce ze seznamu zkratek náchylných k chybám podle ISMP.
  • Nikdy nezkracujte název ani dávku léku.

Data a časy

  • Měsíc pište textem, aby se datum nedalo číst dvojím způsobem (Intl.DateTimeFormat s month: "short").
  • Hodiny volte záměrně: předejte hourCycle výslovně. NHS žádá 24hodinový formát; to je britské pravidlo, ne celosvětové, proto jej Lily nikdy nevybírá za vás.
  • Věky se řídí pásmy Common User Interface přes ageParts(); služba s jinou konvencí předá vlastní slova.
  • Datum známé jen na měsíc nebo rok takové zůstane: ptejte se na něj pomocí date-field precision="month" nebo "year", uložte 2019-03 nebo 2019a zapište ho pomocí formatPartialDate(). Nikdy si nevymýšlejte den.
  • Doba trvání je duration-view, <time datetime="P3DT4H"> obsahující vaše slova, z durationParts() a Intl.DurationFormat.

Přehledové panely

  • Tabule oddělení nebo obrazovka velínu se aktualizuje často. Nikdy neoznamujte každou změnu: ponechte jednu zdvořilou souhrnnou oblast („3 volná lůžka, 2 očekávaná propuštění“) a nechte lidi číst tabuli.
  • Každý stav na tabuli (lůžko čisté, obsazené, blokované) je text nebo stav data-* se slovy, nikdy jen barva.
  • Nic nebliká (WCAG 2.2.2, 2.3.1) a tabule aktualizovaná časovačem má ovládání pauzy, nebo se aktualizuje jen na vyžádání; aktualizace nikdy nepřesouvají fokus. Opožděný záznam to řekne slovy („Čeká přes 20 minut“) s data-overdue.
  • Počet nebo podíl ukazuje svého jmenovatele („12 z 68“) a odkazuje na seznam za ním.
  • Seznam nebo časová osa říká, čeho je pohledem: co ukazuje, v jakém pořadí a za jaké období, co je skryto a proč, a které zdroje neodpověděly. Prázdný seznam ze zdroje, který neodpověděl, nedokazuje, že nic neexistuje.
  • Seznam připomínek je record-list , jehož položky nesou termín (review-date) a stav termínu slovy, s data-due; pravidlo, které ho vytvořilo, je vaše.

Formuláře

  • Otázka s odpověďmi „ano“, „ne“ nebo „nedotázáno“ je radio-group ze tří odpovědí, žádná předem zvolená, nikdy zaškrtávací políčko: políčko nerozliší „popírá“ od „nikdy se neptali“. Přehled systémů je jeden fieldset na orgánový systém a tlačítko „všechny ostatní nepřítomné“ nastaví jen nezodpovězené.
  • Otázka se seznamem odpovědí (léky, adresy) je repeatable-fieldset: položka se přidá nebo odebere, fokus následuje a každé tlačítko odebrání je pojmenováno podle své položky.
  • Číslo s desetinnou čárkou: zobrazte ho pomocí Intl.NumberFormat a tam, kde type="number" nepřijímá čárku, ho převezměte v textovém poli s inputmode="decimal" a zpracujte ve svém kódu. Nikdy neměňte hodnotu, kterou osoba napsala, ani kvůli omezení na rozmezí: hodnota mimo rozmezí je chyba, kterou může vidět.
  • Dlouhý seznam, který najednou vykresluje jen část možností, nastavuje aria-setsize a aria-posinset u každé možnosti a pamatuje, že hledání na stránce zbytek nevidí.

Záznamy, poznámky a jejich původ

  • Před řádky řekněte, čeho je seznam nebo mřížka pohledem: období a pořadí, co vynechává a proč, a které zdroje neodpověděly („Posledních 12 měsíců, nejnovější první. Záznam praktického lékaře neodpověděl.“). Dejte record-list a timeline-list coverageLabel, a pomocníkovi data-grid jeho coverageLabel. Prázdný seznam ze zdroje, který neodpověděl, to řekne slovy, aby nebyl nikdy čten jako „nic nezaznamenáno“.
  • Řekněte, odkud záznam pochází a zda je konečný, pomocí record-provenance-view: podepsaný, čeká na podpis, pozměněný, uložený v tomto zařízení a dosud neodeslaný. Nepodepsaný koncept nikdy nesmí vypadat podepsaně.
  • Záznam o někom jiném (rodiči, plodu, dárci) nejprve řekne, koho se týká, pomocí subjectLabel.
  • Zadržený záznam zůstane v seznamu s vašimi slovy („Omezeno: pro vás nedostupné“) a omylem pořízený záznam zůstane přeškrtnutý s „Zadáno omylem“: dejte record-list-item nebo timeline-list-item entryState a entryStateLabel. Nikdy žádný z nich potichu neodstraňujte, protože mezera se čte jako „nic se nestalo“.
  • V klinické poznámce označte zdroj každé pasáže (napsáno, nadiktováno, šablona, převzato z dřívější poznámky, vygenerováno) pomocí data-source a viditelných slov, aby převzatý či vygenerovaný text nebyl nikdy považován za dnešní vyšetření.
  • Oddíl, který nelze načíst, je unavailable vašimi slovy, s tlačítkem pro opakování; technický kód, pokud je vůbec zobrazen, je za rozbalením. Selhání způsobené akcí osoby se oznámí spolu s hodnotou, kterou záznam nyní má; selhání při načítání stránky ne.
  • Historie ordinace je timeline-list, jedna položka na krok (plánováno, naplánováno na čas, aktivní, pozastaveno, dokončeno, zrušeno) s časem a důvodem a aktuální stav také na položce.

Od FHIR k Lily

Lily nečte zdroje FHIR; váš kód je mapuje na props Lily. Tyto tabulky mapují HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Mapování kódů je návrh: rozhodne o něm vaše klinické posouzení bezpečnosti a slova pro každý stav jsou vaše vlastní.

Sekce IPS a odpovídající komponenty Lily
Sekce IPS Lily
Alergie a intolerance (48765-2) allergy-record-list a jeho položky
Přehled léků (10160-0) medication-record-list, každá položka obsahuje medication-view
Seznam problémů (11450-4) problem-record-list a jeho položky
Očkování (11369-6) immunization-record-list a jeho položky
Výsledky (30954-2) observation-view v datové tabulce nebo souhrnném seznamu
Anamnéza výkonů (47519-4) procedure-record-list a jeho položky
Zdravotnické prostředky (46264-8) device-record-list a jeho položky
Výstrahy (104605-1) Varovný text nebo upozornění, nikdy ne za sbaleným ovládacím prvkem
Jakákoli jiná sekce record-list a jeho položky
Povinná sekce, kterou dokument vynechává Seznam sekce s status="omitted"
Kódy FHIR a jim odpovídající hodnoty Lily
FHIR Lily
emptyReason nilknown status="none-known" seznamu
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", se slovy, která říkají, který z nich
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, odlišně od severity reakce
clinicalStatus, verificationStatus Stejné props u položek alergií a problémů, se stejnými kódy
MedicationStatement.status status položky léku
Dosage.text medication-view dosageText
Observation.status observation-view status, se stejnými kódy
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (také na seznamech záznamů)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Záznam entered-in-error mapujte na jeho stav entered-in-error, se slovy, a nevynechávejte jej tiše: zda se vůbec zobrazí, je rozhodnutí vaší služby.

Od openEHR k Lily

Lily nečte ani kompozice openEHR. Mapování datových typů a kódů referenčního modelu openEHR jako návrh, o kterém rozhodne vaše posouzení klinické bezpečnosti:

Datové typy a kódy openEHR a jim odpovídající hodnoty Lily
openEHR Lily
DV_QUANTITY (zadávání) quantity-input-div; jednotky jako kódy UCUM s vašimi slovy
DV_QUANTITY (zobrazení), 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 částečné (rok, rok a měsíc) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view s durationParts()
DV_PROPORTION formatProportion() uvnitř observation-view
DV_ORDINAL, DV_SCALE radio-group , jehož popisky nesou číslo a jeho slova
DV_CODED_TEXT vzor kódovaných hodnot níže
DV_BOOLEAN checkbox-input, jen když „nedotázáno“ nemůže nastat
ELEMENT.null_flavour 253 neznámé, 271 žádné informace status="not-recorded" nebo "unavailable", se slovy, která říkají, který z nich
null_flavour 272 maskováno observation-view status="masked"
null_flavour 273 nelze použít 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 instrukcí timeline-list z kroků, s aktuálním stavem na položce
položka archetypu s výskytem 0..* repeatable-fieldset

Kódované hodnoty

  • Zobrazte Coding.display; není-li, CodeableConcept.text; není-li ani to, system|code. Nikdy prázdnou buňku.
  • Nabídněte ovládací prvek, který u každé hodnoty odhalí kódový systém a kód, například přepínací tlačítko s textem „Zobrazit kódy“. Skryté kódy zůstávají mimo pořadí čtení, dokud se nezobrazí.
  • Označte klinický text jazykem dokumentu (lang), který se může lišit od jazyka rozhraní. Rozhraní překládejte; klinický obsah nikdy nepřekládejte.
  • Lily nedodává žádnou terminologii: žádné vyhledávání v SNOMED CT, LOINC, ATC ani UCUM. Pište to, co říká dokument. Vzor ukazuje stránka /patient-summary v příkladu SvelteKit.

Co Lily nedělá

  • Nepočítá skóre včasného varování, růstový centil, dávku ani referenční rozmezí.
  • Nedodává databázi léků, seznam tall man ani kódy SNOMED CT, MKN, LOINC či UCUM.
  • Nereprodukuje licencovaný nástroj (Wong-Baker FACES) ani návrh jiného subjektu (tabulku NEWS2).
  • Neomezuje počet současně otevřených záznamů.
  • Odvozovat interpretaci z rozmezí, převádět jednotky nebo zpracovávat relativní datum („příští úterý“).
  • Používat přepínač pro „ano, ne nebo neznámé“: switch v ARIA nemá třetí stav, takže jde o tři přepínací tlačítka.

Výzkum, zdroje a rozhodnutí za tímto průvodcem jsou v spec/healthcare-ui.