Terveydenhuollon käyttöliittymät
Opas tiimeille, jotka rakentavat kliinisiä ohjelmistoja Lilyllä: kliiniset portaalit, tulokset ja raportointi, lääkkeiden määrääminen ja antaminen, päätöksenteon tuki ja sairaaloiden koontinäytöt.
Tämä käännös on tarkistamaton konekäännösluonnos. Englanninkielinen sivu on virallinen versio.
Mitä Lily tekee ja mitä ei
Lily antaa sinulle esityssopimuksia: semanttisen merkinnän, ARIAn, näppäimistön toiminnan ja luokkakoukut asioille, jotka toistuvat kliinisissä näkymissä. Se ei anna sinulle kliinistä logiikkaa, kliinistä sisältöä eikä sääntelyyn liittyvää väitettä.
| Lily tarjoaa | Sinä tarjoat |
|---|---|
| observation-view: arvo, yksikkö, merkintä sanoin, viitealue ja puuttuvat tilat | Arvon, merkintää koskevan päätöksen, viitealueen |
| allergy-record-list ja allergy-record-list-item: tila, joka ei ole koskaan tyhjä | Allergiatiedot ja niiden terminologian |
| medication-view: nimi, vahvuus, lääkemuoto, antoreitti ja antotiheys, mitään katkaisematta | Lääketiedot, tall man -osat, muotoillun vahvuuden |
| decision-support-card: CDS Hooksin korttimuoto | Säännöt, ehdotetut toimet, lopputuloksen kirjaamisen |
| early-warning-score-view: pistemäärä, luokka ja eskalointi, näytettyinä | Pisteytysjärjestelmän ja sen validoidun laskennan |
age-view ja ageParts(): ikä sille sopivissa yksiköissä |
Yksiköiden sanat (Intl.DurationFormat tai omat nimikkeesi) |
formatQuantity(): 5 mg, ei koskaan 5,0 mg; 0,5 mg, ei koskaan ,5 mg |
Luvun, yksikön ja kieliasetuksen |
| Potilasbannerin koostamisen | Jokaisen nimikkeen ja arvon, ja kuka saa nähdä kliiniset tiedot |
Sääntely. Ohjelmisto, joka laskee pistemäärän, persentiilin, annoksen tai lääkkeiden yhteisvaikutuksen, on yleensä lääkinnällinen laite. Lily ei laske mitään näistä, tarkoituksella. Jos tuotteesi on säännelty, sen käytettävyystekninen tiedosto on sinun (IEC 62366-1, FDA:n inhimillisten tekijöiden ohjeistus, EU:n MDR). Lilyn testit, sen itse arvioitu saavutettavuuden vaatimustenmukaisuusraportti ja sen ruudunlukijamatriisi voivat olla näyttöä tuossa tiedostossa; mikään niistä ei ole vaatimustenmukaisuusväite, eikä matriisissa ole vielä tuloksia.
Hälytykset: keskeytä vain kriittisestä
Hälytysväsymys on turvallisuusongelma: kun jokainen hälytys keskeyttää, ihmiset kuittaavat ne kaikki. AHRQ:n ohje on porrastaa hälytykset vakavuuden mukaan ja tehdä vain vakavista keskeyttäviä.
- Tieto (
indicator="info"): tekstin seassa, tehtävän vieressä, päätöstukikortti sivulla. - Varoitus (
indicator="warning"): näkyvä estämättä, sama kortti, erottuvaksi tyyliteltynä; ei modaali-ikkunaa. - Kriittinen (
indicator="critical"): sijoita kortti hälytysvalintaikkunaan ja tarjoaoverrideReasons, jotta sen hylkääminen vaatii syyn. - Päätöstukikortti ei ole koskaan itsessään live-alue. Ilmoita uudesta kriittisestä kortista siirtämällä kohdistus valintaikkunaan, ei
aria-live-määreellä. - Poista kortti, kun tapahtuma, johon se vastasi, toistuu, ja kirjaa jokainen lopputulos (hyväksytty tai ohitettu syineen).
Potilasvirheet: tunnista, älä rajoita
- Näytä kaksi tunnistetta kaikkialla, missä potilaan tietoja näkyy: nimi syntymäajan kanssa sekä kansallinen tunniste näyttökomponentteineen (The Joint Commission, Quick Safety 45).
- Käytä potilasbanneria jokaisessa näkymässä, joka käsittelee yhden potilaan tietoja, ja pidä se näkyvissä.
- Ennen toimintoa muulle kuin bannerissa näkyvälle potilastiedolle vahvista se nimellä, syntymäajalla ja tunnisteella.
-
Merkintä, joka koskee muuta henkilöä kuin potilasta (vanhemman sairaushistoria, sikiö, luovuttaja), kertoo ensin sanoin, ketä se koskee: anna kirjausten kohteille
subjectLabel("Äiti"), jotta sukulaisen diagnoosia ei koskaan lueta potilaan diagnoosiksi (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - Älä rajoita, kuinka monta potilastietoa kliinikko saa avata: satunnaistettu tutkimus 3 356 kliinikolla (JAMA, 2019) osoitti, ettei se vähentänyt väärälle potilaalle tehtyjä määräyksiä, ja ihmiset kiertävät sen.
-
Yhden kirjauksen toimintovalikko nimeää ensin kyseisen kirjauksen, käyttäen
subjectLabelkomponentissacontext-menutaidropdown-menu("Ada Lovelace, verenpaine 3.11."): ei-vuorovaikutteinen ensimmäinen osa, joka on myös valikon saavutettava nimi. -
Luokittele jokainen toiminto sen mukaan, mitä se tekee, ja tee taso näkyväksi ennen sen suorittamista. Rutiini (näytä, tulosta) suoritetaan heti. Kirjattava kertoo, mitä se kirjoittaa potilaskertomukseen ("Lisää muistiinpanon käyntiin").
Kliininen (lopeta, peru määräys) kysyy toisen kerran komponentissa
alert-dialog, jonka vahvistuspainike on verbi ("Lopeta"), ei koskaan "OK" tai "Kyllä". Tietoja luovuttava (hätäkäyttö, jakaminen hoitotiimin ulkopuolelle) kysyy ensin perustelun ja kirjaa sen. - Kun useita kirjauksia on auki (välilehdet, ikkunat, jaetut paneelit), jokaisen välilehden näkyvä teksti ja saavutettava nimi sisältävät potilaan nimen ja toisen tunnisteen, aktiivinen paneeli toistaa bannerin, eikä mikään toiminto kohdistu muuhun potilaaseen kuin paneelinsa potilaaseen.
- Näytä paikka, johon kirjaukset kohdistetaan (osasto, poliklinikka tai yksikkö, joka valittiin kirjautuessa), tekstinä sivun ylätunnisteessa, ja tee sen vaihtamisesta erillinen toiminto.
- Näytä aktiivinen käynti tai "Ei aktiivista käyntiä" bannerissa. Lomake, joka tarvitsee käynnin, kertoo sen ja tarjoaa aloittaa sellaisen sen sijaan, että epäonnistuisi tallennettaessa.
Potilasbanneri
Koostaminen on dokumentoitu kohdassa medical-banner, ja toimiva sivu on osoitteessa /patient-banner SvelteKit-esimerkkisovelluksessa:
- kaksi tunnistetta ja ikä syntymäajan vieressä;
- allergiat allergialuettelon kautta, jotta ”ei tunnettuja allergioita”, ”ei kirjattu” ja ”ei saatavilla” eivät koskaan näytä samalta;
- puuttuva arvo kirjoitetaan sanoin (”Ei tiedossa”), ei koskaan kysymysmerkkinä, viivana tai tyhjänä soluna;
- kuollut potilas:
data-deceasedteemalle ja näkyvä tekstirivi, ei koskaan pelkkä väri; - yhtään kenttää ei katkaista, rajata tai piiloteta millään leveydellä; teksti rivittyy.
-
potilaan huomiomerkinnät ("Tarvitsee tulkin", "Tartuntavaara") ovat nimetty
tag-groupsanoista, ei koskaan pelkkiä kuvakkeita tai värejä, ja ne pysyvät näkyvissä, kun banneri rivittyy.
Tulokset
- Yksi esitys tulokselle, tuli se mistä järjestelmästä tahansa: havaintonäkymä.
- Merkintä on sanoja käännöksestäsi (
flagLabel), ja FHIR-tulkintakoodi ondata-interpretation-määreenä teemaa varten. - Erota uudet tulokset aiemmista ja näytä kehitys (sparkline tai viivakaavio datataulukkoineen): kliinikot etsivät merkittävää muutosta, eivät pelkkää viitealuetta.
- Tulos, jota ei koskaan kirjattu, ja tulos, joka ei ole saatavilla, ovat eri tiloja, joilla on eri sanat.
-
Tuntematon ei ole normaali. Tulos, jonka viiteväli puuttuu, latautuu yhä tai on lukukelvoton, ei saa tulkintaa ja kertoo sen;
observation-viewei koskaan päättele tulkintaa, joten tulos, jolla on viiteväli mutta eiinterpretation, ei näytä merkintää. -
Asteikon ulkopuolinen tulos on laitteen raja vertailuoperaattorilla ("> 33,3 mmol/L":
formatQuantityja">") sekä kriittinen merkintänne, ei koskaan pelkkä luku. Likimääräinen arvo säilyttää ≈:nsä ("~"). - Anna muut nimetyt välit ("Kriittinen: alle 2,5") muodossa
ranges, kukin omana osanaan. -
Korjattu tai muutettu tulos säilyttää korvaamansa arvon elementissä
<del>, ja sananne siitä, milloin se muuttui (previousValue,previousLabel), jotta vanhan arvon lukenut kliinikko tietää sen muuttuneen. -
Aikavälimittaus kertoo pituutensa ja funktionsa ("Keskiarvo, 24 tuntia"), ja mittauksen tila ja menetelmä ("Istuen, iso mansetti") ovat näkyvää tekstiä sen vieressä, ei koskaan pelkkä työkaluvihje (openEHR
INTERVAL_EVENT,state,protocol). - Trendi tarvitsee vertailukelpoisia pisteitä: älä piirrä viivaa minimisi alapuolelle, katkaise viiva, missä menetelmä tai määritys muuttui, ja kerro suunta ja merkitys sanoin ("laskeva, paraneva").
-
Yhdessä yksikköjärjestelmässä syötetyt vitaalit voivat näyttää toisen järjestelmän vieressä tekstinänne ("70 kg (154 lb)"); Lily ei muunna mitään, joten kerro pyöristyksenne. Syötä määrä komponentilla
quantity-input-div, jonka luku noudattaa kunkin yksikön rajoja. -
Kasvukäyrä on
line-chartsarjoina persentiiliviivanne, lapsen pisteet ja tietotaulukko iästä ja arvosta; Lily ei laske persentiilejä eikä toimita kasvuviitteitä.
Lääkkeet
- Geneeriset nimet pienillä kirjaimilla, paitsi tall man -kirjaimet FDA:n ja ISMP:n tai oman maasi luetteloista (Australia ja Kanada julkaisevat omansa). Merkitse ne kohtaan
nameSegments; Lily ei koskaan arvaa niitä. - Kirjoita vahvuus funktiolla
formatQuantity: ei loppunollaa, etunolla, sitova välilyönti ennen yksikköä. - Säilytä tuloksen vertailumerkki:
formatQuantity(5, "mmol/L", locale, "<")kirjoittaa ”<5 mmol/L”. FHIR:nQuantity.comparatorkirjoitetaan <, ≤, ≥ tai >; jos se jätetään pois, ”alle 5” muuttuu muotoon ”5”. - Kirjoita mL, ei koskaan cc, ja vältä kaikkia ISMP:n virhealttiiden lyhenteiden luettelon lyhenteitä.
- Älä koskaan katkaise lääkkeen nimeä tai annosta.
Päivämäärät ja kellonajat
- Kirjoita kuukausi tekstinä, jotta päivämäärää ei voi lukea kahdella tavalla (
Intl.DateTimeFormatjamonth: "short"). - Valitse kello harkiten: anna
hourCyclenimenomaisesti. NHS edellyttää 24 tunnin kelloa; se on brittiläinen sääntö, ei maailmanlaajuinen, joten Lily ei koskaan valitse sitä puolestasi. - Iät noudattavat Common User Interfacen luokkia funktion
ageParts()kautta; palvelu, jolla on toinen käytäntö, antaa omat sanansa. -
Vain kuukauden tai vuoden tarkkuudella tunnettu päivämäärä pysyy sellaisena: kysy sitä komponentilla
date-fieldprecision="month"tai"year", tallenna2019-03tai2019ja kirjoita se funktiollaformatPartialDate(). Älä koskaan keksi päivää. -
Ajan pituus on
duration-view,<time datetime="P3DT4H">joka sisältää sananne, lähteinädurationParts()jaIntl.DurationFormat.
Koontinäytöt
- Osastotaulu tai johtokeskuksen näyttö päivittyy usein. Älä koskaan ilmoita jokaisesta muutoksesta: pidä yksi kohtelias yhteenvetoalue (”3 vuodepaikkaa vapaana, 2 kotiutusta tulossa”) ja anna ihmisten lukea taulua.
- Jokainen taulun tila (vuode siivottu, varattu, estetty) on tekstiä tai
data-*-tila sanoineen, ei koskaan pelkkä väri. -
Mikään ei vilku (WCAG 2.2.2, 2.3.1), ja ajastimella päivittyvässä taulussa on taukopainike tai se päivittyy vain pyydettäessä; päivitykset eivät koskaan siirrä kohdistusta. Myöhässä oleva merkintä kertoo sen sanoin ("Odottanut yli 20 minuuttia") ja
data-overdue. - Määrä tai osuus näyttää nimittäjänsä ("12/68") ja linkittää taustalla olevaan luetteloon.
- Luettelo tai aikajana kertoo, minkä näkymä se on: mitä se näyttää, sen järjestys ja aikaikkuna, mitä on piilotettu ja miksi, ja mitkä lähteet eivät vastanneet. Tyhjä luettelo lähteestä, joka ei vastannut, ei todista, ettei mitään ole.
-
Muistutusluettelo on
record-list, jonka kohteilla on eräpäivä (review-date) ja erän tila sanoin, sekädata-due; sen tuottanut sääntö on teidän.
Lomakkeet
-
Kysymys, johon vastataan "kyllä", "ei" tai "ei kysytty", on
radio-groupkolmesta vastauksesta, joista mitään ei ole valittu valmiiksi, ei koskaan valintaruutu: valintaruutu ei erota "kielletty" ja "ei koskaan kysytty". Elinjärjestelmäkatsaus on yksifieldsetelinjärjestelmää kohden, ja painike "kaikki muut poissa" asettaa vain vastaamattomat. -
Kysymys, jolla on luettelo vastauksia (lääkkeet, osoitteet), on
repeatable-fieldset: kohde lisätään tai poistetaan, kohdistus seuraa, ja jokainen poistopainike on nimetty kohteensa mukaan. -
Desimaalipilkullinen luku: näytä se funktiolla
Intl.NumberFormatja, missätype="number"ei hyväksy pilkkua, ota se vastaan tekstikentässä attribuutillainputmode="decimal"ja jäsennä se koodissanne. Älä koskaan muuta henkilön kirjoittamaa arvoa, et edes rajataksesi sen väliin: välin ulkopuolinen arvo on virhe, jonka hän voi nähdä. -
Pitkä luettelo, joka näyttää vain osan vaihtoehdoistaan kerrallaan, asettaa
aria-setsizejaaria-posinsetjokaiselle vaihtoehdolle ja muistaa, ettei sivulta haku näe loppuja.
Kirjaukset, muistiinpanot ja niiden alkuperä
-
Kerro ennen rivejä, minkä näkymä luettelo tai ruudukko on: aikaikkuna ja järjestys, mitä se jättää pois ja miksi, ja mitkä lähteet eivät vastanneet ("Viimeiset 12 kuukautta, uusin ensin. Terveyskeskuksen kertomus ei vastannut."). Anna
record-listjatimeline-listcoverageLabel, ja apukomponentilledata-gridsencoverageLabel. Tyhjä luettelo lähteestä, joka ei vastannut, kertoo sen sanoin, jotta sitä ei koskaan lueta "mitään ei kirjattu". -
Kerro komponentilla
record-provenance-view, mistä kirjaus tuli ja onko se lopullinen: allekirjoitettu, odottaa allekirjoitusta, muutettu, tallennettu tälle laitteelle eikä vielä lähetetty. Allekirjoittamaton luonnos ei saa koskaan näyttää allekirjoitetulta. - Merkintä toisesta henkilöstä (vanhempi, sikiö, luovuttaja) kertoo ensin, ketä se koskee, kirjausten kohteiden ominaisuudella
subjectLabel. -
Salattu merkintä pysyy luettelossa sanoillanne ("Rajoitettu: ei saatavilla sinulle"), ja virheellisesti tehty merkintä pysyy yliviivattuna tekstillä "Kirjattu virheellisesti": anna
record-list-itemtaitimeline-list-itementryStatejaentryStateLabel. Älä koskaan poista kumpaakaan hiljaa, sillä aukko luetaan "mitään ei tapahtunut". -
Merkitse kliinisessä muistiinpanossa jokaisen kohdan lähde (kirjoitettu, sanelu, malli, kopioitu eteenpäin, generoitu) attribuutilla
data-sourceja näkyvin sanoin, jotta kopioitua tai generoitua tekstiä ei koskaan pidetä tämän päivän tutkimuksena. -
Osio, joka ei lataudu, on
unavailablesanoillanne, uudelleenyrityspainikkeen kanssa; tekninen koodi, jos sitä näytetään lainkaan, on avattavan osan takana. Henkilön toiminnan aiheuttama virhe ilmoitetaan, sekä arvo, joka kirjauksessa nyt on; sivun latauksen virhettä ei. -
Määräyksen historia on
timeline-list, yksi kohde vaihetta kohden (suunniteltu, ajoitettu, aktiivinen, keskeytetty, valmis, peruttu) aikoineen ja syineen, ja nykyinen tila myös kohteessa.
FHIR:stä Lilyyn
Lily ei lue FHIR-resursseja; koodisi kuvaa ne Lilyn propseiksi. Nämä taulukot kuvaavat HL7 FHIR International Patient Summaryn (IPS 2.0.1, FHIR R4). Koodikuvaus on ehdotus: kliininen turvallisuusarviosi ratkaisee sen, ja kunkin tilan sanat ovat omiasi.
| IPS-osio | Lily |
|---|---|
Allergiat ja intoleranssit (48765-2) |
allergy-record-list ja sen kohteet |
Lääkitysyhteenveto (10160-0) |
medication-record-list, ja jokainen kohde sisältää komponentin medication-view |
Ongelmaluettelo (11450-4) |
problem-record-list ja sen kohteet |
Rokotukset (11369-6) |
immunization-record-list ja sen kohteet |
Tulokset (30954-2) |
observation-view, datataulukossa tai yhteenvetoluettelossa |
Toimenpidehistoria (47519-4) |
procedure-record-list ja sen kohteet |
Lääkinnälliset laitteet (46264-8) |
device-record-list ja sen kohteet |
Hälytykset (104605-1) |
Varoitusteksti tai hälytys, ei koskaan suljetun kontrollin takana |
| Mikä tahansa muu osio | record-list ja sen kohteet |
| Pakollinen osio, jonka dokumentti jättää pois | Osion luettelo, jossa on status="omitted" |
| FHIR | Lily |
|---|---|
emptyReason nilknown |
Luettelon status="none-known" |
emptyReason notasked, notstarted |
status="not-recorded" |
emptyReason unavailable, withheld, closed |
status="unavailable", ja sanat kertovat, mistä on kyse |
IPS-koodit no-known-allergies, no-known-medications ja vastaavat |
status="none-known" |
IPS-koodit no-allergy-info, no-medication-info ja vastaavat |
status="not-recorded" |
AllergyIntolerance.criticality |
criticality, erillään reaktion severity |
clinicalStatus, verificationStatus |
Samat propsit allergia- ja ongelmakohteissa, samoilla koodeilla |
MedicationStatement.status |
Lääkekohteen status |
Dosage.text |
medication-view dosageText |
Observation.status |
observation-view status, samoilla koodeilla |
Observation.dataAbsentReason masked |
status="masked" |
dataAbsentReason not-applicable |
status="not-applicable" (myös kirjausluetteloissa) |
Quantity.comparator |
formatQuantity(value, unit, locale, comparator) |
Kuvaa entered-in-error-tieto tilaan entered-in-error, sanoin, sen sijaan että se jätetään äänettömästi pois: näytetäänkö se lainkaan, on palvelusi päätös.
openEHR:stä Lilyyn
Lily ei lue myöskään openEHR-koosteita. Vastaavuus openEHR-viitemallin tietotyypeille ja koodeille ehdotuksena, josta kliininen turvallisuusarvionne päättää:
| openEHR | Lily |
|---|---|
DV_QUANTITY (syöttö) |
quantity-input-div; yksiköt UCUM-koodeina sanojenne kanssa |
DV_QUANTITY (näyttö), magnitude_status |
observation-view ja 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 ja meaning |
observation-view ranges |
DV_DATE osittainen (vuosi, vuosi ja kuukausi) |
date-field precision; formatPartialDate(); date-time-view |
DV_DURATION |
duration-view ja durationParts() |
DV_PROPORTION |
formatProportion() komponentin sisällä observation-view |
DV_ORDINAL, DV_SCALE |
radio-group , jonka nimiöissä ovat luku ja sen sanat |
DV_CODED_TEXT |
koodattujen arvojen malli alla |
DV_BOOLEAN |
checkbox-input, vain kun "ei kysytty" ei voi esiintyä |
ELEMENT.null_flavour 253 tuntematon, 271 ei tietoa |
status="not-recorded" tai "unavailable", ja sanat kertovat, mistä on kyse |
null_flavour 272 peitetty |
observation-view status="masked" |
null_flavour 273 ei sovellu |
status="not-applicable" |
PARTY_RELATED kohde |
subjectLabel kirjausten kohteissa |
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT |
record-provenance-view |
| Instruction State Machine -vaiheet | timeline-list vaiheista, nykyinen tila kohteessa |
arkkityypin kohde, esiintymiä 0..* |
repeatable-fieldset |
Koodatut arvot
- Näytä
Coding.display; jos sitä ei ole,CodeableConcept.text; jos kumpaakaan ei ole,system|code. Ei koskaan tyhjää solua. - Tarjoa kontrolli, joka näyttää koodijärjestelmän ja koodin kunkin arvon vieressä, esimerkiksi vaihtopainike, jossa lukee ”Näytä koodit”. Piilotetut koodit pysyvät lukujärjestyksen ulkopuolella, kunnes ne näytetään.
- Merkitse kliininen teksti dokumentin kielellä (
lang), joka voi poiketa käyttöliittymän kielestä. Käännä käyttöliittymä; älä koskaan käännä kliinistä sisältöä. - Lily ei sisällä terminologiaa: ei SNOMED CT-, LOINC-, ATC- tai UCUM-hakuja. Kirjoita se, mitä dokumentti sanoo. SvelteKit-esimerkin sivu
/patient-summarynäyttää mallin.
Mitä Lily ei tee
- Laske varhaisen varoituksen pistemäärää, kasvupersentiiliä, annosta tai viitealuetta.
- Toimita lääketietokantaa, tall man -luetteloa tai SNOMED CT-, ICD-, LOINC- tai UCUM-koodeja.
- Jäljittele lisensoitua mittaria (Wong-Baker FACES) tai toisen tahon suunnittelua (NEWS2-kaaviota).
- Rajoita samanaikaisesti avoinna olevien potilastietojen määrää.
- Päätellä tulkintaa viitevälistä, muuntaa yksikköä tai jäsentää suhteellista päivämäärää ("ensi tiistaina").
- Käyttää kytkintä vastaukselle "kyllä, ei tai tuntematon": ARIA:n
switchei tunne kolmatta tilaa, joten se on kolme valintanappia.
Tämän oppaan taustalla oleva tutkimus, lähteet ja päätökset ovat kohdassa spec/healthcare-ui.