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.
| 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áljatokoverrideReasonsé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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabeltulajdonsággal acontext-menuvagy adropdown-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-dialogelemben, 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-deceaseda 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-groupszavakbó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óddaldata-interpretationné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-viewsosem következtet ki egyet, így a tartománnyal rendelkező, deinterpretationné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-chartaz Ö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
nameSegmentsmezőben; a Lily soha nem találgatja őket. - A hatáserősséget a
formatQuantityfü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 FHIRQuantity.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.DateTimeFormatamonth: "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-fieldprecision="month"vagy"year"segítségével, tárolja2019-03vagy2019formában, és írja ki aformatPartialDate()függvénnyel. Soha ne találjon ki napot. -
Az időtartam egy
duration-view,<time datetime="P3DT4H">elem az Ön szavaival, adurationParts()és azIntl.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, adata-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-grouphá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 egyfieldset, é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.NumberFormatfüggvénnyel, és ahol atype="number"nem fogadja el a vesszőt, fogadja egy szövegmezőben ainputmode="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 azaria-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 atimeline-listkomponensnekcoverageLabelértéket, és adata-gridsegédnek a sajátcoverageLabelé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-itemvagy atimeline-list-itemkomponensnekentryStateésentryStateLabelé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-sourceattribú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-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 | 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:
| 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-summaryoldala 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
switchelemé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.