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ä.

Mitä Lily tarjoaa ja mitä sinä tarjoat
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 tarjoa overrideReasons, 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 (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Ä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 subjectLabel komponentissa context-menu tai dropdown-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-deceased teemalle 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-group sanoista, 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 on data-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-view ei koskaan päättele tulkintaa, joten tulos, jolla on viiteväli mutta ei interpretation , ei näytä merkintää.
  • Asteikon ulkopuolinen tulos on laitteen raja vertailuoperaattorilla ("> 33,3 mmol/L": formatQuantity ja ">") 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-chart sarjoina 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:n Quantity.comparator kirjoitetaan <, ≤, ≥ 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.DateTimeFormat ja month: "short").
  • Valitse kello harkiten: anna hourCycle nimenomaisesti. 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-field precision="month" tai "year", tallenna 2019-03 tai 2019ja kirjoita se funktiolla formatPartialDate(). Älä koskaan keksi päivää.
  • Ajan pituus on duration-view, <time datetime="P3DT4H"> joka sisältää sananne, lähteinä durationParts() ja Intl.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-group kolmesta vastauksesta, joista mitään ei ole valittu valmiiksi, ei koskaan valintaruutu: valintaruutu ei erota "kielletty" ja "ei koskaan kysytty". Elinjärjestelmäkatsaus on yksi fieldset elinjä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.NumberFormat ja, missä type="number" ei hyväksy pilkkua, ota se vastaan tekstikentässä attribuutilla inputmode="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-setsize ja aria-posinset jokaiselle 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-list ja timeline-list coverageLabel, ja apukomponentille data-grid sen coverageLabel. 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-item tai timeline-list-item entryState ja entryStateLabel. Ä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-source ja näkyvin sanoin, jotta kopioitua tai generoitua tekstiä ei koskaan pidetä tämän päivän tutkimuksena.
  • Osio, joka ei lataudu, on unavailable sanoillanne, 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-osiot ja niitä vastaavat Lily-komponentit
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-koodit ja niitä vastaavat Lily-arvot
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-tietotyypit ja -koodit sekä niitä vastaavat Lily-arvot
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-summary nä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 switch ei 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.