Tervishoiu kasutajaliidesed
Juhend meeskondadele, kes loovad Lily abil kliinilist tarkvara: kliinilised portaalid, tulemused ja aruandlus, ravimite määramine ja manustamine, otsustustugi ning haiglate töölauad.
Selle lehe tõlked on läbivaatamata masintõlke mustandid. Ingliskeelne leht on kehtiv versioon.
Mida Lily teeb ja mida mitte
Lily annab teile kuvalepingud: semantilise märgenduse, ARIA, klaviatuurikäitumise ja klassikonksud asjadele, mida kliinilised ekraanid korduvalt vajavad. See ei anna kliinilist loogikat, kliinilist sisu ega regulatiivset väidet.
| Lily pakub | Teie pakute |
|---|---|
| observation-view: väärtus, ühik, sõnadega märge, vahemik ja puuduva väärtuse olekud | Väärtuse, märke otsuse, võrdlusvahemiku |
| allergy-record-list ja allergy-record-list-item: staatus, mis ei ole kunagi tühi | Allergiakirje ja selle terminoloogia |
| medication-view: nimi, tugevus, vorm, manustamistee ja sagedus, mitte midagi pole lühendatud | Ravimiandmed, tall man segmendid, vormindatud tugevus |
| decision-support-card: CDS Hooks kaardi kuju | Reeglid, ettepanekute toimingud, tulemuse salvestamine |
| early-warning-score-view: skoor, riskirühm ja eskaleerimine, kuvatud | Skoorimissüsteemi ja selle valideeritud arvutuse |
age-view ja ageParts(): vanus talle sobivates ühikutes |
Ühikute sõnad (Intl.DurationFormat või teie enda sildid) |
formatQuantity(): 5 mg, mitte kunagi 5,0 mg; 0,5 mg, mitte kunagi ,5 mg |
Arvu, ühiku ja lokaadi |
| Patsiendiriba kompositsiooni | Iga silt ja väärtus ning see, kes tohib kliinilist teavet näha |
Regulatsioon. Tarkvara, mis arvutab skoori, protsentiili, annuse või ravimite koostoime, on tavaliselt meditsiiniseade. Lily ei arvuta ühtegi neist, tahtlikult. Kui teie toode on reguleeritud, vastutate selle kasutatavuse inseneeria toimiku eest (IEC 62366-1, FDA inimfaktorite juhised, EU MDR). Lily testid, selle isehinnatud juurdepääsetavuse vastavusaruanne ja ekraanilugejate maatriks võivad olla selle toimiku tõendid; ükski neist ei ole vastavusväide ja maatriksis pole veel tulemusi.
Teavitused: katkestage ainult kriitilise puhul
Teavituste väsimus on ohutusprobleem: kui iga teavitus katkestab, lükkavad inimesed need kõik tagasi. AHRQ juhis on astmestada teavitused tõsiduse järgi ja lasta katkestada ainult tõsistel.
- Teave (
indicator="info"): reasisene, ülesande kõrval, otsustustoe kaart lehel. - Hoiatus (
indicator="warning"): nähtav ilma blokeerimata, sama kaart, silmatorkavalt kujundatud; ilma modaalaknata. - Kriitiline (
indicator="critical"): pange kaart hoiatusdialoogi ja pakkugeoverrideReasons, et selle tagasilükkamisel küsitaks põhjust. - Otsustustoe kaart ei ole kunagi iseenesest elav piirkond. Teatage uuest kriitilisest kaardist, viies fookuse dialoogi, mitte
aria-liveabil. - Eemaldage kaart, kui sündmus, millele see vastas, juhtub uuesti, ja salvestage iga tulemus (aktsepteeritud või tühistatud koos põhjusega).
Vale patsiendi vead: tuvastage, ärge piirake
- Näidake kahte identifikaatorit igal pool, kus patsiendi andmed ilmuvad: nimi koos sünnikuupäevaga ning riiklik identifikaator selle vaatekomponendiga (The Joint Commission, Quick Safety 45).
- Kasutage patsiendiriba igal ekraanil, mis tegutseb ühe patsiendi kirjega, ja hoidke see nähtaval.
- Enne toimingut kirjega, mis ei ole ribal olev kiri, kinnitage see nime, sünnikuupäeva ja identifikaatoriga.
-
Kanne kellegi teise kui patsiendi kohta (vanema haiguslugu, loode, doonor) ütleb kõigepealt sõnadega, kelle kohta see on: andke kirje elementidele
subjectLabel(„Ema“), et sugulase diagnoosi ei loetaks kunagi patsiendi omaks (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Ärge piirake, mitu kirjet kliinik avada tohib: randomiseeritud uuring 3356 kliinikuga (JAMA, 2019) leidis, et see ei vähendanud vale patsiendi tellimusi ja inimesed saavad sellest mööda.
-
Ühe kirje toimingute menüü nimetab kõigepealt selle kirje, kasutades
subjectLabelkomponendilcontext-menuvõidropdown-menu(„Ada Lovelace, vererõhk 3. nov“): mitteinteraktiivne esimene osa, mis on ühtlasi menüü juurdepääsetav nimi. -
Liigitage iga toiming selle järgi, mida see teeb, ja tehke tase nähtavaks enne käivitamist. Rutiinne (vaata, prindi) käivitub kohe. Dokumenteeritav ütleb, mida see kirjesse kirjutab („Lisab visiidile märkme“).
Kliiniline (lõpeta, tühista korraldus) küsib teist korda, komponendis
alert-dialog, mille kinnitusnupp on tegusõna („Lõpeta“), mitte kunagi „OK“ ega „Jah“. Avalikustav (hädajuurdepääs, jagamine väljaspool raviteemi) küsib kõigepealt põhjust ja salvestab selle. - Kui avatud on mitu kirjet (sakid, aknad, jagatud paneelid), sisaldavad iga saki nähtav tekst ja juurdepääsetav nimi patsiendi nime ja teist tunnust, aktiivne paneel kordab bännerit ning ükski toiming ei kehti muule patsiendile kui tema paneeli omale.
- Näidake kohta, millele kirjed omistatakse (sisselogimisel valitud osakond, vastuvõtt või asutus), tekstina lehe päises ja tehke selle muutmine selgeks eraldi toiminguks.
- Näidake bänneris aktiivset visiiti või „Aktiivne visiit puudub“. Vorm, mis vajab visiiti, ütleb seda ja pakub selle alustamist, selle asemel et salvestamisel ebaõnnestuda.
Patsiendiriba
Kompositsioon on dokumenteeritud komponendis medical-banner, töötava lehega aadressil /patient-banner SvelteKiti näiterakenduses:
- kaks identifikaatorit ja vanus sünnikuupäeva kõrval;
- allergiad allergiate loendi kaudu, et „teadaolevaid allergiaid pole“, „pole registreeritud“ ja „pole saadaval“ ei näeks kunagi ühesugused välja;
- puuduv väärtus on sõnad („Teadmata“), mitte kunagi küsimärk, kriips ega tühi lahter;
- surnud patsient:
data-deceasedteema jaoks ja nähtav tekstirida, mitte kunagi ainult värv; - ühtegi välja ei lühendata, ei lõigata ega peideta üheski laiuses; see murdub mitmele reale.
-
patsiendi märgistused („Vajab tõlki“, „Nakkusoht“) on sõnadest koosnev sildiga
tag-group, mitte kunagi ainult ikoonid või värv, ning jäävad nähtavaks, kui bänner murdub.
Tulemused
- Üks vaade tulemusele, olenemata sellest, millisest süsteemist see pärines: vaatluse vaade.
- Märge on sõnad teie tõlkest (
flagLabel), FHIR-i tõlgendamiskood on teema jaoksdata-interpretation. - Eraldage uued tulemused varasematest ja näidake trendi (sparkline või joondiagramm koos andmetabeliga): kliinikud otsivad olulist muutust, mitte ainult vahemikku.
- Tulemus, mida pole kunagi registreeritud, ja tulemus, mis pole saadaval, on erinevad olekud, erinevate sõnadega.
-
Teadmata ei ole normaalne. Tulemusel, mille referentsvahemik puudub, alles laadib või on loetamatu, pole tõlgendust ja see ütleb seda;
observation-viewei tuleta seda kunagi, seega vahemikuga, kuid ilmainterpretationtulemus ei näita märgistust. -
Skaalast väljas tulemus on mõõteriista piir koos võrdlusmärgiga („> 33,3 mmol/L“:
formatQuantitykoos">") ja teie kriitilise märgistusega, mitte kunagi paljas arv. Ligikaudne väärtus säilitab oma ≈ ("~"). - Andke täiendavad nimelised vahemikud („Kriitiline: alla 2,5“) kui
ranges, igaüks omaette osana. -
Parandatud või muudetud tulemus säilitab asendatud väärtuse elemendis
<del>, koos teie sõnadega selle kohta, millal see muutus (previousValue,previousLabel), et vana väärtust lugenud arst teaks, et see muutus. -
Intervallmõõtmine ütleb oma laiuse ja funktsiooni („Keskmine, 24 tundi“) ning mõõtmise seisund ja meetod („Istudes, suur mansett“) on nähtav tekst selle kõrval, mitte kunagi ainult kohtspikker (openEHR
INTERVAL_EVENT,state,protocol). - Trend vajab võrreldavaid punkte: ärge joonistage joont allapoole oma miinimumi, katkestage joon seal, kus meetod või analüüs muutus, ning öelge suund ja tähendus sõnadega („langev, paranev“).
-
Ühes ühikusüsteemis sisestatud elulised näitajad võivad näidata teist selle kõrval teie tekstina („70 kg (154 lb)“); Lily ei teisenda midagi, seega märkige oma ümardamine. Sisestage kogus komponendiga
quantity-input-div, mille arv järgib iga ühiku piire. -
Kasvukõver on
line-chartteie protsentiilijoontega seeriatena, lapse punktide ning vanuse ja väärtuse andmetabeliga; Lily ei arvuta ühtegi protsentiili ega tarni kasvureferentsi.
Ravimid
- Üldnimetused väiketähtedega, välja arvatud tall man tähed FDA ja ISMP loenditest või teie riigi loendist (Austraalia ja Kanada avaldavad omad). Märkige need
nameSegmentsväljal; Lily ei oleta neid kunagi. - Kirjutage tugevus funktsiooniga
formatQuantity: ilma lõpunullita, alguse nulliga, mittekatkestava tühikuga enne ühikut. - Säilitage tulemuse võrdlusmärk:
formatQuantity(5, "mmol/L", locale, "<")kirjutab „<5 mmol/L“. FHIR-iQuantity.comparatorkirjutatakse <, ≤, ≥ või >; selle väljajätmisel muutub „vähem kui 5“ väärtuseks „5“. - Kirjutage mL, mitte kunagi cc, ja vältige iga lühendit ISMP veaohtlike lühendite loendist.
- Ärge kunagi lühendage ravimi nime ega annust.
Kuupäevad ja kellaajad
- Kirjutage kuu tekstina, et kuupäeva ei saaks kahel viisil lugeda (
Intl.DateTimeFormatkoosmonth: "short"). - Valige kellaaja vorming teadlikult: andke
hourCycleselgesõnaliselt. NHS nõuab 24-tunnist kella; see on Ühendkuningriigi, mitte ülemaailmne reegel, seega ei vali Lily seda teie eest kunagi. - Vanused järgivad Common User Interface vanuserühmi funktsiooni
ageParts()kaudu; teine tava järgiv teenus annab oma sõnad. -
Ainult kuu või aasta täpsusega teada kuupäev jääbki selliseks: küsige seda komponendiga
date-fieldprecision="month"või"year", salvestage2019-03või2019ja kirjutage funktsioonigaformatPartialDate(). Ärge kunagi mõelge päeva välja. -
Ajavahemik on
duration-view,<time datetime="P3DT4H">, mis sisaldab teie sõnu, allikaksdurationParts()jaIntl.DurationFormat.
Töölauad
- Osakonna tahvel või juhtimiskeskuse ekraan uueneb sageli. Ärge kunagi teatage iga muudatust: hoidke üht viisakat kokkuvõtte piirkonda („3 vaba voodit, 2 oodatavat väljakirjutamist“) ja laske inimestel tahvlit lugeda.
- Iga tahvli olek (voodi puhas, hõivatud, blokeeritud) on tekst või sõnadega
data-*olek, mitte kunagi ainult värv. -
Miski ei vilgu (WCAG 2.2.2, 2.3.1) ning taimeriga uuenev tahvel omab pausinuppu või uueneb ainult soovi korral; uuendused ei liiguta kunagi fookust. Hilinenud kanne ütleb seda sõnadega („Ootab üle 20 minuti“) koos
data-overdue. - Arv või määr näitab oma nimetajat („12 / 68“) ja viitab selle taga olevale loendile.
- Loend või ajajoon ütleb, millest see vaade on: mida see näitab, selle järjekord ja ajavahemik, mis on peidetud ja miks ning millised allikad ei vastanud. Tühi loend allikast, mis ei vastanud, ei tõesta, et midagi pole.
-
Meeldetuletuste loend on
record-list, mille elementidel on tähtaeg (review-date) ja tähtaja olek sõnadega, koosdata-due; selle loonud reegel on teie oma.
Vormid
-
Küsimus, millele vastatakse „jah“, „ei“ või „ei küsitud“, on
radio-groupkolmest vastusest, millest ükski pole algul valitud, mitte kunagi märkeruut: märkeruut ei erista „eitatud“ ja „kunagi küsimata“. Elundkondade ülevaade on üksfieldsetelundkonna kohta ning nupp „kõik ülejäänud puuduvad“ seab ainult vastamata küsimused. -
Küsimus, millel on vastuste loend (ravimid, aadressid), on
repeatable-fieldset: element lisatakse või eemaldatakse, fookus järgneb ja iga eemaldusnupp on nimetatud oma elemendi järgi. -
Komakohaga arv: näidake seda funktsiooniga
Intl.NumberFormatja kustype="number"koma ei aktsepteeri, võtke see vastu tekstiväljas atribuudigainputmode="decimal"ja parsige oma koodis. Ärge kunagi muutke inimese sisestatud väärtust, isegi mitte vahemikku surumiseks: vahemikust väljas väärtus on viga, mida ta näeb. -
Pikk loend, mis näitab korraga ainult osa valikutest, seab
aria-setsizejaaria-posinsetigale valikule ning arvestab, et lehelt otsing ei näe ülejäänut.
Kirjed, märkmed ja nende päritolu
-
Öelge enne ridu, millest loend või ruudustik vaade on: ajavahemik ja järjekord, mis jääb välja ja miks ning millised allikad ei vastanud („Viimased 12 kuud, uusimad eespool. Perearsti kirje ei vastanud.“). Andke
record-listjatimeline-listcoverageLabel, ning abikomponendiledata-gridsellecoverageLabel. Tühi loend allikast, mis ei vastanud, ütleb seda sõnadega, et seda ei loetaks kunagi kui „midagi pole kirjas“. -
Öelge komponendiga
record-provenance-view, kust kirje pärineb ja kas see on lõplik: allkirjastatud, ootab allkirja, muudetud, sellesse seadmesse salvestatud ja veel saatmata. Allkirjastamata mustand ei tohi kunagi paista allkirjastatuna. - Kanne kellegi teise kohta (vanem, loode, doonor) ütleb kõigepealt, kelle kohta see on, kirje elementide atribuudiga
subjectLabel. -
Kinnipeetud kanne jääb loendisse teie sõnadega („Piiratud: teile pole kättesaadav“) ning ekslikult tehtud kanne jääb läbikriipsutatuks tekstiga „Sisestatud ekslikult“: andke
record-list-itemvõitimeline-list-itementryStatejaentryStateLabel. Ärge kunagi eemaldage kumbagi vaikselt, sest lünka loetakse kui „midagi ei juhtunud“. -
Märkige kliinilises märkmes iga lõigu allikas (trükitud, dikteeritud, mall, edasi kopeeritud, genereeritud) atribuudiga
data-sourceja nähtavate sõnadega, et kopeeritud või genereeritud teksti ei peetaks kunagi tänaseks läbivaatuseks. -
Jaotis, mis ei saa laadida, on
unavailableteie sõnadega, korduskatse nupuga; tehniline kood, kui seda üldse näidatakse, on avatava osa taga. Inimese toimingust põhjustatud tõrge teatatakse koos väärtusega, mis kirjel nüüd on; lehe laadimise tõrget mitte. -
Korralduse ajalugu on
timeline-list, üks element iga sammu kohta (planeeritud, ajastatud, aktiivne, peatatud, lõpetatud, tühistatud) koos aja ja põhjusega ning praegune olek ka elemendil.
FHIR-ist Lilysse
Lily ei loe FHIR-i ressursse; teie kood seob need Lily props'idega. Need tabelid seovad HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Koodide seos on soovitus: selle otsustab teie kliinilise ohutuse ülevaatus ja iga oleku sõnad on teie enda.
| IPS-i jaotis | Lily |
|---|---|
Allergiad ja talumatused (48765-2) |
allergy-record-list ja selle kirjed |
Ravimite kokkuvõte (10160-0) |
medication-record-list, kus iga kirje sisaldab medication-view |
Probleemide loend (11450-4) |
problem-record-list ja selle kirjed |
Immuniseerimised (11369-6) |
immunization-record-list ja selle kirjed |
Tulemused (30954-2) |
observation-view andmetabelis või kokkuvõtteloendis |
Protseduuride ajalugu (47519-4) |
procedure-record-list ja selle kirjed |
Meditsiiniseadmed (46264-8) |
device-record-list ja selle kirjed |
Hoiatused (104605-1) |
Hoiatustekst või hoiatus, mitte kunagi kokkupandud juhtelemendi taga |
| Mis tahes muu jaotis | record-list ja selle kirjed |
| Nõutav jaotis, mille dokument välja jätab | Jaotise loend väärtusega status="omitted" |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
Loendi status="none-known" |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable", sõnadega, mis ütlevad, milline neist |
IPS-i koodid no-known-allergies, no-known-medications ja sarnased |
status="none-known" |
IPS-i koodid no-allergy-info, no-medication-info ja sarnased |
status="not-recorded" |
AllergyIntolerance.criticality |
criticality, eraldi reaktsiooni severity väärtusest |
clinicalStatus, verificationStatus |
Samad props'id allergia- ja probleemikirjetel, samade koodidega |
MedicationStatement.status |
Ravimikirje status |
Dosage.text |
medication-view dosageText |
Observation.status |
observation-view status, samade koodidega |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (ka kirjeloenditel) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
Seostage kirje entered-in-error selle olekuga entered-in-error, sõnadega, mitte ei jätke seda vaikselt välja: kas seda üldse näidata, otsustab teie teenus.
openEHR-ist Lilyni
Lily ei loe ka openEHR-i kompositsioone. Vastavus openEHR-i viitemudeli andmetüüpidele ja koodidele, ettepanekuna, mille üle otsustab teie kliinilise ohutuse ülevaatus:
| openEHR | Lily |
|---|---|
DV_QUANTITY (sisestus) |
quantity-input-div; ühikud UCUM-koodidena teie sõnadega |
DV_QUANTITY (kuvamine), magnitude_status |
observation-view koos formatQuantity(value, unit, locale, comparator) (~ on ≈) |
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL |
observation-view interpretation: FHIR HU, HH, H, L, LL, LU |
other_reference_ranges koos meaning |
observation-view ranges |
DV_DATE osaline (aasta, aasta ja kuu) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view koos durationParts() |
DV_PROPORTION |
formatProportion() komponendis observation-view |
DV_ORDINAL, DV_SCALE |
radio-group , mille siltidel on arv ja selle sõnad |
DV_CODED_TEXT |
allpool kodeeritud väärtuste muster |
DV_BOOLEAN |
checkbox-input, ainult kui „ei küsitud“ ei saa esineda |
ELEMENT.null_flavour 253 teadmata, 271 teave puudub |
status="not-recorded" või "unavailable", sõnadega, mis ütlevad, milline neist |
null_flavour 272 varjatud |
observation-view status="masked" |
null_flavour 273 ei kohaldu |
status="not-applicable" |
PARTY_RELATED subjekt |
subjectLabel kirje elementidel |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| Instruction State Machine'i sammud | timeline-list sammudest, praegune olek elemendil |
arhetüübi element esinemiskordadega 0..* |
repeatable-fieldset |
Kodeeritud väärtused
- Kuvage
Coding.display; kui seda pole,CodeableConcept.text; kui kumbagi pole,system|code. Mitte kunagi tühja lahtrit. - Pakkuge juhtelementi, mis näitab iga väärtuse kõrval koodisüsteemi ja koodi, näiteks lülitusnuppu tekstiga „Näita koode“. Peidetud koodid jäävad lugemisjärjekorrast välja, kuni need kuvatakse.
- Märgistage kliiniline tekst dokumendi keelega (
lang), mis võib liidese keelest erineda. Tõlkige liides; ärge kunagi tõlkige kliinilist sisu. - Lily ei paku terminoloogiat: ei SNOMED CT, LOINC, ATC ega UCUM päringuid. Kirjutage see, mida dokument ütleb. Mustrit näitab SvelteKit-i näite leht
/patient-summary.
Mida Lily ei tee
- Ei arvuta varajase hoiatuse skoori, kasvu protsentiili, annust ega võrdlusvahemikku.
- Ei tarni ravimiandmebaasi, tall man loendit ega SNOMED CT, RHK, LOINC või UCUM koode.
- Ei reprodutseeri litsentseeritud instrumenti (Wong-Baker FACES) ega teise asutuse kujundust (NEWS2 diagramm).
- Ei piira samaaegselt avatud kirjete arvu.
- Tuletada vahemikust tõlgendust, teisendada ühikut või parsida suhtelist kuupäeva („järgmisel teisipäeval“).
- Kasutada lülitit vastusele „jah, ei või teadmata“: ARIA
switchei tunne kolmandat olekut, seega on see kolm raadionuppu.
Selle juhendi taga olevad uuringud, allikad ja otsused on lehel spec/healthcare-ui.