Egészségügyi felhasználói felületek

Útmutató klinikai szoftvert építő csapatoknak a Lilyvel: klinikai portálok, eredmények és jelentések, gyógyszerrendelés és -beadás, döntéstámogatás és kórházi irányítópultok.

Ennek az oldalnak a fordításai nem ellenőrzött gépi tervezetek. Az angol oldal a mérvadó változat.

Mit tesz a Lily, és mit nem

A Lily megjelenítési szerződéseket ad: szemantikus jelölést, ARIA-t, billentyűzetes viselkedést és osztálykampókat azokhoz, amik a klinikai képernyőkön ismétlődnek. Nem ad klinikai logikát, klinikai tartalmat és szabályozási állítást.

Mit nyújt a Lily, és mit nyújtotok ti
A Lily nyújtja Ti nyújtjátok
observation-view: érték, mértékegység, szavakkal kifejezett jelzés, tartomány és hiányzó állapotok Az érték, a jelzésről szóló döntés, a referenciatartomány
allergy-record-list és allergy-record-list-item: soha nem üres állapot Az allergiabejegyzés és terminológiája
medication-view: név, hatáserősség, gyógyszerforma, alkalmazási mód és gyakoriság, semmi sincs csonkolva A gyógyszeradatok, a tall man szegmensek, a formázott hatáserősség
decision-support-card: a CDS Hooks kártya alakja A szabályok, a javaslati műveletek, az eredmény rögzítése
early-warning-score-view: pontszám, sáv és eszkaláció megjelenítve A pontozási rendszer és validált számítása
age-view és ageParts(): életkor a hozzá illő egységekben Az egységek szavai (Intl.DurationFormat vagy a saját címkéitek)
formatQuantity(): 5 mg, soha nem 5,0 mg; 0,5 mg, soha nem ,5 mg A szám, a mértékegység és a nyelvi beállítás
A betegfejléc összeállítása Minden címke és érték, és hogy ki láthat klinikai információt

Szabályozás. Az a szoftver, amely pontszámot, percentilist, adagot vagy gyógyszer-kölcsönhatást számít ki, általában orvostechnikai eszköz. A Lily szándékosan egyiket sem számítja. Ha a terméketek szabályozott, a használhatósági mérnöki dokumentáció a tiétek (IEC 62366-1, az FDA emberi tényezőkre vonatkozó útmutatója, EU MDR). A Lily tesztjei, az önértékelt akadálymentességi megfelelőségi jelentése és a képernyőolvasó-mátrixa bizonyítékul szolgálhatnak ebben a dokumentációban; egyik sem megfelelőségi állítás, és a mátrixban még nincsenek eredmények.

Riasztások: csak a kritikusnál szakítsatok félbe

A riasztási fáradtság biztonsági probléma: ha minden riasztás megszakít, az emberek mindet elvetik. Az AHRQ útmutatása szerint a riasztásokat súlyosság szerint kell szintezni, és csak a súlyosak legyenek megszakítók.

  • Információ (indicator="info"): a szövegben, a feladat mellett, egy döntéstámogató kártya az oldalon.
  • Figyelmeztetés (indicator="warning"): blokkolás nélkül látható, ugyanaz a kártya, kiemelkedően stílusozva; nincs modális ablak.
  • Kritikus (indicator="critical"): tegyétek a kártyát egy riasztási párbeszédablakba, és kínáljatok overrideReasons értéket, hogy az elvetés indoklást kérjen.
  • A döntéstámogató kártya önmagában soha nem élő régió. Az új kritikus kártyát úgy jelentsétek be, hogy a fókuszt a párbeszédablakba mozgatjátok, nem aria-live-val.
  • Távolítsatok el egy kártyát, amikor az esemény, amelyre válaszolt, újra bekövetkezik, és rögzítsetek minden eredményt (elfogadva, vagy felülbírálva az indoklásával).

Betegtévesztési hibák: azonosítsatok, ne korlátozzatok

  • Mutassatok két azonosítót mindenütt, ahol beteg adatai megjelennek: a nevet a születési dátummal, és a nemzeti azonosítót a view komponensével (The Joint Commission, Quick Safety 45).
  • Használjátok a betegfejlécet minden olyan képernyőn, amely egy beteg adatlapján cselekszik, és tartsátok láthatón.
  • A fejlécben szereplőtől eltérő adatlapon végzett művelet előtt erősítsétek meg a névvel, a születési dátummal és az azonosítóval.
  • A nem a betegről szóló bejegyzés (egy szülő kórtörténete, magzat, donor) először szavakkal mondja meg, kire vonatkozik: adjon a dokumentáció elemeinek subjectLabel („Anya”) értéket, hogy egy rokon diagnózisát soha ne olvassák a betegének (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Ne korlátozzátok, hány adatlapot nyithat meg egy klinikus: egy 3 356 klinikussal végzett randomizált vizsgálat (JAMA, 2019) szerint ez nem csökkentette a téves betegre szóló rendeléseket, és az emberek kijátsszák.
  • Egy dokumentumra vonatkozó műveleti menü először megnevezi azt a dokumentumot, a subjectLabel tulajdonsággal a context-menu vagy a dropdown-menu („Ada Lovelace, vérnyomás nov. 3.”) komponensen: egy nem interaktív első rész, amely a menü akadálymentes neve is.
  • Sorolja be minden műveletet aszerint, mit tesz, és tegye láthatóvá a szintet, mielőtt lefut. Rutin (megtekintés, nyomtatás) azonnal lefut. Dokumentált megmondja, mit fog a dokumentációba írni („Megjegyzést fűz a találkozóhoz”). Klinikai (leállítás, rendelés visszavonása) másodszor is rákérdez, egy alert-dialog elemben, amelynek megerősítő gombja az ige („Leállítás”), sosem „OK” vagy „Igen”. Felfedő (vészhelyzeti hozzáférés, megosztás az ellátó csapaton kívül) előbb indoklást kér, és rögzíti.
  • Ha több dokumentáció is nyitva van (lapok, ablakok, osztott panelek), minden lap látható szövege és akadálymentes neve tartalmazza a beteg nevét és egy második azonosítót, az aktív panel megismétli a sávot, és egyetlen művelet sem vonatkozik más betegre, mint a saját panelje betegére.
  • Mutassa szövegként az oldal fejlécében azt a helyet, amelyhez a bejegyzések tartoznak majd (a bejelentkezéskor választott osztályt, rendelőt vagy intézményt), és tegye kifejezett művelet tárgyává a módosítását.
  • Mutassa a sávban az aktív vizitet, vagy azt, hogy „Nincs aktív vizit”. Az az űrlap, amelyhez vizit kell, ezt megmondja és felajánlja egy indítását, ahelyett hogy mentéskor hibára futna.

A betegfejléc

Az összeállítás a medical-banner oldalán van dokumentálva, működő oldallal a /patient-banner címen a SvelteKit példaalkalmazásban:

  • két azonosító, és az életkor a születési dátum mellett;
  • allergiák allergialistán keresztül, hogy az „ismert allergia nincs”, a „nincs rögzítve” és a „nem elérhető” soha ne nézzen ki egyformán;
  • a hiányzó érték szavakkal van kifejezve („Nem ismert”), soha nem kérdőjellel, gondolatjellel vagy üres cellával;
  • elhunyt beteg: data-deceased a témához, és látható szövegsor, soha nem csak szín;
  • egyetlen mező sincs csonkolva, levágva vagy elrejtve semmilyen szélességen; tördelődik.
  • a beteg jelzései („Tolmácsra van szüksége”, „Fertőzésveszély”) egy feliratos tag-group szavakból, sosem csak ikonok vagy szín, és láthatók maradnak, amikor a sáv tördelődik.

Eredmények

  • Egyetlen megjelenítés egy eredményhez, bármelyik rendszerből is jött: az observation view.
  • A jelzés a ti fordításotokból származó szavak (flagLabel), a FHIR értelmezési kóddal data-interpretation néven a témához.
  • Különítsétek el az új eredményeket a korábbiaktól, és mutassatok trendet (sparkline-t, vagy vonaldiagramot az adattáblázatával): a klinikusok jelentős változást keresnek, nem csak a tartományt.
  • Az eredmény, amelyet soha nem rögzítettek, és az, amely nem elérhető, különböző állapotok, különböző szavakkal.
  • Az ismeretlen nem normális. Az az eredmény, amelynek referenciatartománya hiányzik, még töltődik vagy olvashatatlan, nem kap értelmezést, és ezt meg is mondja; observation-view sosem következtet ki egyet, így a tartománnyal rendelkező, de interpretation nélküli eredmény nem mutat jelzést.
  • A skálán kívüli eredmény a műszer határa egy összehasonlító jellel („> 33,3 mmol/l”: formatQuantity és ">") és az Ön kritikus jelzésével, sosem csupasz szám. Egy közelítő érték megtartja a ≈ jelét ("~").
  • Adja meg a további elnevezett tartományokat („Kritikus: 2,5 alatt”) rangesformában, mindegyiket külön részként.
  • A javított vagy módosított eredmény megtartja a lecserélt értéket egy <del>elemben, az Ön szavaival arról, mikor változott (previousValue, previousLabel), hogy a régi értéket olvasó klinikus tudja, hogy megváltozott.
  • Egy időszakos mérés megmondja a hosszát és a funkcióját („Átlag, 24 óra”), a mérés állapota és módszere („Ülve, nagy mandzsetta”) pedig látható szöveg mellette, sosem csak eszköztipp (openEHR INTERVAL_EVENT, state, protocol).
  • A trendhez összevethető pontok kellenek: ne rajzoljon vonalat a minimuma alatt, szakítsa meg a vonalat ott, ahol a módszer vagy a vizsgálat változott, és mondja ki szavakkal az irányt és a jelentést („csökken, javul”).
  • Az egyik mértékegység-rendszerben bevitt életjelek a másikat is mutathatják mellette, az Ön szövegeként („70 kg (154 lb)”); a Lily semmit nem vált át, ezért adja meg a kerekítését. Mennyiséget a quantity-input-divkomponenssel vigyen be, amelynek száma követi minden mértékegység határait.
  • A növekedési görbe egy line-chart az Ön percentilisvonalaival mint sorozatokkal, a gyermek pontjaival és az életkor és érték adattáblájával; a Lily nem számol percentilist, és nem szállít növekedési referenciát.

Gyógyszerek

  • A generikus nevek kisbetűvel, kivéve az FDA és az ISMP vagy a ti országotok listáin szereplő tall man betűket (Ausztrália és Kanada a sajátját teszi közzé). Jelöljétek őket a nameSegments mezőben; a Lily soha nem találgatja őket.
  • A hatáserősséget a formatQuantity függvénnyel írjátok: záró nulla nélkül, kezdő nullával, és törhetetlen szóközzel a mértékegység előtt.
  • Őrizzétek meg az eredmény összehasonlító jelét: formatQuantity(5, "mmol/L", locale, "<") ezt írja: „<5 mmol/L”. A FHIR Quantity.comparator értéke <, ≤, ≥ vagy >; ha elhagyjátok, a „kevesebb mint 5” „5”-té válik.
  • Írjatok mL-t, soha nem cc-t, és kerüljetek minden rövidítést az ISMP hibára hajlamos rövidítések listájáról.
  • Soha ne csonkoljátok a gyógyszer nevét vagy adagját.

Dátumok és időpontok

  • A hónapot szövegként írjátok, hogy a dátumot ne lehessen kétféleképpen olvasni (Intl.DateTimeFormat a month: "short" beállítással).
  • Az órarendszert szándékosan válasszátok: adjátok át kifejezetten az hourCycle értéket. Az NHS a 24 órás időkijelzést kéri; ez brit szabály, nem világszabály, ezért a Lily soha nem választja ki helyettetek.
  • Az életkorok a Common User Interface sávjait követik az ageParts() függvényen keresztül; más szokású szolgáltatás a saját szavait adja át.
  • A csak hónapra vagy évre ismert dátum az is marad: kérdezze a date-field precision="month" vagy "year"segítségével, tárolja 2019-03 vagy 2019formában, és írja ki a formatPartialDate()függvénnyel. Soha ne találjon ki napot.
  • Az időtartam egy duration-view, <time datetime="P3DT4H"> elem az Ön szavaival, a durationParts() és az Intl.DurationFormat.

Irányítópultok

  • Egy osztálytábla vagy egy irányítóközponti képernyő gyakran frissül. Soha ne jelentsetek be minden változást: tartsatok egy udvarias összefoglaló régiót („3 szabad ágy, 2 elbocsátás várható”), és hagyjátok, hogy az emberek olvassák a táblát.
  • A tábla minden állapota (ágy tiszta, foglalt, zárolt) szöveg vagy data-* állapot szavakkal, soha nem csak szín.
  • Semmi nem villog (WCAG 2.2.2, 2.3.1), és az időzítővel frissülő táblának van szünet vezérlője, vagy csak kérésre frissül; a frissítések sosem mozgatják a fókuszt. Egy késésben lévő bejegyzés ezt szavakkal mondja („Több mint 20 perce vár”), a data-overdue.
  • Egy darabszám vagy arány mutatja a nevezőjét („12 / 68”), és a mögötte álló listára mutat.
  • Egy lista vagy idővonal megmondja, minek a nézete: mit mutat, milyen sorrendben és időszakra, mi van elrejtve és miért, és mely források nem válaszoltak. Egy nem válaszoló forrás üres listája nem bizonyítja, hogy semmi sincs.
  • Az emlékeztető lista egy record-list , amelynek elemei határidőt (review-date) és határidő-állapotot hordoznak szavakkal, a data-due; az előállító szabály az Öné.

Űrlapok

  • Az „igen”, „nem” vagy „nem kérdezték” válaszú kérdés egy radio-group három válasszal, kezdetben egyik sincs kiválasztva, sosem jelölőnégyzet: a jelölőnégyzet nem különbözteti meg a „tagadja” és a „sosem kérdezték” válaszokat. A szervrendszerek áttekintése szervrendszerenként egy fieldset , és a „minden más nincs jelen” gomb csak a megválaszolatlanokat állítja be.
  • A válaszlistás kérdés (gyógyszerek, címek) egy repeatable-fieldset: egy elem hozzáadódik vagy eltávolítódik, a fókusz követi, és minden eltávolító gomb a saját eleméről kap nevet.
  • Tizedesvesszős szám: jelenítse meg a Intl.NumberFormat függvénnyel, és ahol a type="number" nem fogadja el a vesszőt, fogadja egy szövegmezőben a inputmode="decimal" attribútummal, és dolgozza fel a kódjában. Soha ne változtassa meg a személy által begépelt értéket, még tartományba szorításért sem: a tartományon kívüli érték olyan hiba, amelyet láthat.
  • Egy hosszú lista, amely egyszerre csak a lehetőségei egy részét jeleníti meg, beállítja az aria-setsize és az aria-posinset értéket minden lehetőségen, és számol azzal, hogy az oldalon belüli keresés nem látja a többit.

Dokumentáció, jegyzetek és eredetük

  • A sorok előtt mondja meg, minek a nézete a lista vagy a rács: az időszak és a sorrend, mit hagy ki és miért, és mely források nem válaszoltak („Utolsó 12 hónap, a legújabb elöl. A háziorvosi dokumentáció nem válaszolt.”). Adjon a record-list és a timeline-list komponensnek coverageLabelértéket, és a data-grid segédnek a saját coverageLabelértékét. Egy nem válaszoló forrás üres listája ezt szavakkal mondja meg, hogy soha ne olvassák „semmit sem rögzítettek”-ként.
  • Mondja meg a record-provenance-viewkomponenssel, honnan jött egy bejegyzés, és végleges-e: aláírva, aláírásra vár, módosítva, ezen az eszközön mentve és még el nem küldve. Egy aláíratlan piszkozat soha nem nézhet ki aláírtnak.
  • A valaki másról (szülő, magzat, donor) szóló bejegyzés először megmondja, kire vonatkozik, a dokumentációs elemek subjectLabeltulajdonságával.
  • Egy visszatartott bejegyzés az Ön szavaival a listában marad („Korlátozott: Ön számára nem elérhető”), egy tévesen rögzített bejegyzés pedig áthúzva marad „Tévesen rögzítve” felirattal: adjon a record-list-item vagy a timeline-list-item komponensnek entryState és entryStateLabelértéket. Soha ne távolítsa el egyiket sem csendben, mert a hiányt úgy olvassák: „nem történt semmi”.
  • Egy klinikai jegyzetben jelölje minden szakasz forrását (gépelt, diktált, sablon, továbbmásolt, generált) a data-source attribútummal és látható szavakkal, hogy a másolt vagy generált szöveget soha ne tartsák a mai vizsgálatnak.
  • A be nem tölthető szakasz unavailable állapotú az Ön szavaival, újrapróbálás gombbal; a technikai kód, ha egyáltalán megjelenik, egy lenyitható rész mögött van. A személy műveletéből fakadó hiba bejelentésre kerül, azzal az értékkel együtt, amelyet a dokumentáció most tartalmaz; az oldalbetöltési hiba nem.
  • Egy rendelés története egy timeline-list, lépésenként egy elemmel (tervezett, ütemezett, aktív, felfüggesztett, befejezett, visszavont) idővel és indokkal, és a jelenlegi állapottal az elemen is.

A FHIR-től a Lilyig

A Lily nem olvas FHIR-erőforrásokat; a ti kódotok képezi le őket a Lily propjaira. Ezek a táblázatok a HL7 FHIR International Patient Summary-t (IPS 2.0.1, FHIR R4) képezik le. A kódleképezés javaslat: a ti klinikai biztonsági felülvizsgálatotok dönt róla, és minden állapot szavai a ti saját szavaitok.

IPS-szakaszok és a nekik megfelelő Lily-komponensek
IPS-szakasz Lily
Allergiák és intoleranciák (48765-2) allergy-record-list és annak elemei
Gyógyszeres összefoglaló (10160-0) medication-record-list, minden elem ezt tartalmazza: medication-view
Problémalista (11450-4) problem-record-list és annak elemei
Oltások (11369-6) immunization-record-list és annak elemei
Eredmények (30954-2) observation-view, adattáblázatban vagy összefoglaló listában
Korábbi beavatkozások (47519-4) procedure-record-list és annak elemei
Orvostechnikai eszközök (46264-8) device-record-list és annak elemei
Riasztások (104605-1) Figyelmeztető szöveg vagy riasztás, soha nem összecsukott vezérlő mögött
Bármely más szakasz record-list és annak elemei
Kötelező szakasz, amelyet a dokumentum kihagy A szakasz listája ezzel: status="omitted"
FHIR-kódok és a nekik megfelelő Lily-értékek
FHIR Lily
emptyReason nilknown A lista értéke: status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", szavakkal, amelyek megmondják, melyik
Az IPS-kódok: no-known-allergies, no-known-medications és hasonlók status="none-known"
Az IPS-kódok: no-allergy-info, no-medication-info és hasonlók status="not-recorded"
AllergyIntolerance.criticality criticality, elkülönítve a reakció severity
clinicalStatus, verificationStatus Ugyanezek a propok az allergia- és problémaelemeken, ugyanazokkal a kódokkal
MedicationStatement.status A gyógyszerelem: status
Dosage.text medication-view dosageText
Observation.status observation-view status, ugyanazokkal a kódokkal
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (a dokumentációs listákon is)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Az entered-in-error állapotú bejegyzést képezzétek le erre az állapotra: entered-in-error, szavakkal, ahelyett hogy csendben elhagynátok: hogy egyáltalán megjelenjen-e, az a ti szolgáltatástok döntése.

Az openEHR-től a Lilyig

A Lily az openEHR-kompozíciókat sem olvassa. Az openEHR referenciamodell adattípusainak és kódjainak megfeleltetése javaslatként, amelyről a klinikai biztonsági felülvizsgálat dönt:

Az openEHR adattípusai és kódjai, és a nekik megfelelő Lily-értékek
openEHR Lily
DV_QUANTITY (bevitel) quantity-input-div; mértékegységek UCUM-kódként az Ön szavaival
DV_QUANTITY (megjelenítés), magnitude_status observation-view és formatQuantity(value, unit, locale, comparator) (~ jelentése ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges , egy meaning observation-view ranges
DV_DATE részleges (év, év és hónap) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view és durationParts()
DV_PROPORTION formatProportion() belül: observation-view
DV_ORDINAL, DV_SCALE egy radio-group , amelynek címkéi a számot és a szavait hordozzák
DV_CODED_TEXT az alábbi kódolt értékek mintája
DV_BOOLEAN checkbox-input, csak ha a „nem kérdezték” nem fordulhat elő
ELEMENT.null_flavour 253 ismeretlen, 271 nincs információ status="not-recorded" vagy "unavailable", szavakkal, amelyek megmondják, melyik
null_flavour 272 elfedett observation-view status="masked"
null_flavour 273 nem alkalmazható status="not-applicable"
PARTY_RELATED alany subjectLabel a dokumentációs elemeken
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Az Instruction State Machine lépései egy timeline-list lépésekből, a jelenlegi állapottal az elemen
archetípus-elem előfordulással 0..* repeatable-fieldset

Kódolt értékek

  • Mutassátok: Coding.display; ha nincs, akkor: CodeableConcept.text; ha egyik sincs, akkor: system|code. Soha nem üres cella.
  • Kínáljatok egy vezérlőt, amely minden érték mellett megmutatja a kódrendszert és a kódot, például egy „Kódok megjelenítése” feliratú kapcsológombot. A rejtett kódok addig nem kerülnek az olvasási sorrendbe, amíg meg nem jelennek.
  • A klinikai szöveget jelöljétek a dokumentum nyelvével (lang), amely eltérhet a felület nyelvétől. A felületet fordítsátok le; a klinikai tartalmat soha ne fordítsátok.
  • A Lily nem szállít terminológiát: nincs SNOMED CT-, LOINC-, ATC- vagy UCUM-keresés. Azt írjátok, amit a dokumentum mond. A SvelteKit-példa /patient-summary oldala mutatja a mintát.

Mit nem tesz a Lily

  • Korai figyelmeztető pontszámot, növekedési percentilist, adagot vagy referenciatartományt számítani.
  • Gyógyszeradatbázist, tall man listát, vagy SNOMED CT, BNO, LOINC vagy UCUM kódokat szállítani.
  • Licencelt műszert (Wong-Baker FACES) vagy más szervezet tervét (a NEWS2 táblázatot) reprodukálni.
  • Korlátozni az egyszerre megnyitott adatlapok számát.
  • Értelmezést kikövetkeztetni tartományból, mértékegységet átváltani, vagy relatív dátumot („jövő kedden”) feldolgozni.
  • Kapcsolót használni az „igen, nem vagy ismeretlen” válaszhoz: az ARIA switch elemének nincs harmadik állapota, ezért ez három választógomb.

Az útmutató mögötti kutatás, források és döntések a spec/healthcare-ui oldalon találhatók.