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.

Mida pakub Lily ja mida pakute teie
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 pakkuge overrideReasons, 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-live abil.
  • 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 (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Ä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 subjectLabel komponendil context-menu või dropdown-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-deceased teema 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 jaoks data-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-view ei tuleta seda kunagi, seega vahemikuga, kuid ilma interpretation tulemus ei näita märgistust.
  • Skaalast väljas tulemus on mõõteriista piir koos võrdlusmärgiga („> 33,3 mmol/L“: formatQuantity koos ">") 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-chart teie 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 nameSegments vä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-i Quantity.comparator kirjutatakse <, ≤, ≥ 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.DateTimeFormat koos month: "short").
  • Valige kellaaja vorming teadlikult: andke hourCycle selgesõ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-field precision="month" või "year", salvestage 2019-03 või 2019ja kirjutage funktsiooniga formatPartialDate(). Ärge kunagi mõelge päeva välja.
  • Ajavahemik on duration-view, <time datetime="P3DT4H"> , mis sisaldab teie sõnu, allikaks durationParts() ja Intl.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, koos data-due; selle loonud reegel on teie oma.

Vormid

  • Küsimus, millele vastatakse „jah“, „ei“ või „ei küsitud“, on radio-group kolmest vastusest, millest ükski pole algul valitud, mitte kunagi märkeruut: märkeruut ei erista „eitatud“ ja „kunagi küsimata“. Elundkondade ülevaade on üks fieldset elundkonna 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.NumberFormat ja kus type="number" koma ei aktsepteeri, võtke see vastu tekstiväljas atribuudiga inputmode="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-setsize ja aria-posinset igale 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-list ja timeline-list coverageLabel, ning abikomponendile data-grid selle coverageLabel. 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-item või timeline-list-item entryState ja entryStateLabel. Ä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-source ja nähtavate sõnadega, et kopeeritud või genereeritud teksti ei peetaks kunagi tänaseks läbivaatuseks.
  • Jaotis, mis ei saa laadida, on unavailable teie 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 jaotised ja neile vastavad Lily komponendid
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-i koodid ja neile vastavad Lily väärtused
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-i andmetüübid ja koodid ning neile vastavad Lily väärtused
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 switch ei tunne kolmandat olekut, seega on see kolm raadionuppu.

Selle juhendi taga olevad uuringud, allikad ja otsused on lehel spec/healthcare-ui.