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í.
| 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ěteoverrideReasons, 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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í
subjectLabelucontext-menunebodropdown-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-deceasedpro 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-groupze 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 jakodata-interpretationpro 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-viewji nikdy neodvodí, takže výsledek s rozmezím a bezinterpretationnezobrazí žádný příznak. -
Výsledek mimo stupnici je mez přístroje se znaménkem srovnání („> 33,3 mmol/l“:
formatQuantitys">") 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-charts 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.comparatorve 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.DateTimeFormatsmonth: "short"). - Hodiny volte záměrně: předejte
hourCyclevý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-fieldprecision="month"nebo"year", uložte2019-03nebo2019a zapište ho pomocíformatPartialDate(). Nikdy si nevymýšlejte den. -
Doba trvání je
duration-view,<time datetime="P3DT4H">obsahující vaše slova, zdurationParts()aIntl.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, sdata-due; pravidlo, které ho vytvořilo, je vaše.
Formuláře
-
Otázka s odpověďmi „ano“, „ne“ nebo „nedotázáno“ je
radio-groupze 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 jedenfieldsetna 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.NumberFormata tam, kdetype="number"nepřijímá čárku, ho převezměte v textovém poli sinputmode="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-setsizeaaria-posinsetu 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-listatimeline-listcoverageLabel, a pomocníkovidata-gridjehocoverageLabel. 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-itemnebotimeline-list-itementryStateaentryStateLabel. 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-sourcea 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
unavailablevaš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 | 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" |
| 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:
| 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-summaryv 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é“:
switchv 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.