Brukergrensesnitt for helsetjenesten

En veiledning for team som bygger klinisk programvare med Lily: kliniske portaler, prøvesvar og rapportering, forskrivning og administrering av legemidler, beslutningsstøtte og sykehusdashbord.

Denne oversettelsen er et ikke-gjennomgått maskinutkast. Den engelske siden er den gjeldende versjonen.

Hva Lily gjør, og hva det ikke gjør

Lily gir deg visningskontrakter: semantisk markup, ARIA, tastaturatferd og klassekroker for det kliniske skjermbilder gjentar. Det gir deg ikke klinisk logikk, klinisk innhold eller noen regulatorisk påstand.

Hva Lily leverer, og hva du leverer
Lily leverer Du leverer
observation-view: en verdi, en enhet, en markering i ord, et intervall og manglende tilstander Verdien, avgjørelsen om markering, referanseintervallet
allergy-record-list og allergy-record-list-item: en status som aldri er tom Allergiregistreringen og terminologien
medication-view: navn, styrke, legemiddelform, administrasjonsvei og hyppighet, ingenting avkortet Legemiddeldataene, tall man-segmentene, den formaterte styrken
decision-support-card: kortformen fra CDS Hooks Reglene, de foreslåtte handlingene, registreringen av utfallet
early-warning-score-view: en skår, et nivå og en eskalering, vist Skåringssystemet og den validerte beregningen
age-view og ageParts(): en alder i enhetene som passer Ordene for enhetene (Intl.DurationFormat eller dine egne etiketter)
formatQuantity(): 5 mg, aldri 5,0 mg; 0,5 mg, aldri ,5 mg Tallet, enheten og språkinnstillingen
Sammensetningen av pasientbanneret Hver etikett og verdi, og hvem som kan se klinisk informasjon

Regulering. Programvare som beregner en skår, en persentil, en dose eller en legemiddelinteraksjon, er vanligvis medisinsk utstyr. Lily beregner ingenting av dette, med vilje. Hvis produktet ditt er regulert, eier du dokumentasjonen for brukervennlighet (IEC 62366-1, FDAs veiledning om menneskelige faktorer, EUs MDR). Lilys tester, den egenvurderte rapporten om samsvar med tilgjengelighetskrav og skjermlesermatrisen kan være dokumentasjon der; ingen av dem er en samsvarserklæring, og matrisen har ennå ingen resultater.

Varsler: avbryt bare for det kritiske

Varseltretthet er et sikkerhetsproblem: når hvert varsel avbryter, klikker folk alle bort. AHRQ anbefaler å dele inn varsler etter alvorlighet og bare la de alvorlige avbryte.

  • Informasjon (indicator="info"): i teksten, ved siden av oppgaven, et beslutningsstøttekort på siden.
  • Advarsel (indicator="warning"): synlig uten å blokkere, det samme kortet, utformet for å skille seg ut; ingen modal.
  • Kritisk (indicator="critical"): legg kortet i en varseldialog, og tilby overrideReasons slik at det kreves en grunn for å avvise det.
  • Et beslutningsstøttekort er aldri i seg selv en live-region. Kunngjør et nytt kritisk kort ved å flytte fokus inn i dialogen, ikke med aria-live.
  • Fjern et kort når hendelsen det svarte på, skjer igjen, og registrer hvert utfall (godtatt, eller overstyrt med begrunnelse).

Pasientforveksling: identifiser, ikke begrens

  • Vis to identifikatorer overalt der en pasients data vises: navnet med fødselsdatoen, og det nasjonale identifikasjonsnummeret med visningskomponenten (The Joint Commission, Quick Safety 45).
  • Bruk pasientbanneret på hvert skjermbilde som handler på én pasients journal, og hold det synlig.
  • Før en handling på en annen journal enn den i banneret, bekreft den med navn, fødselsdato og identifikator.
  • En oppføring om en annen enn pasienten (en forelders sykehistorie, et foster, en donor) sier først med ord hvem den gjelder: gi journalens elementer et subjectLabel («Mor»), så en slektnings diagnose aldri leses som pasientens (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Ikke begrens hvor mange journaler en kliniker kan åpne: en randomisert studie med 3 356 klinikere (JAMA, 2019) fant at det ikke reduserte forordninger til feil pasient, og folk omgår det.
  • En meny med handlinger på én journal nevner først den journalen, med subjectLabel på context-menu eller dropdown-menu («Ada Lovelace, blodtrykk 3. nov.»): en ikke-interaktiv første del som også er menyens tilgjengelige navn.
  • Del inn hver handling etter hva den gjør, og gjør nivået synlig før den utføres. Rutine (vis, skriv ut) utføres straks. Dokumentert sier hva den vil skrive i journalen («Legger til et notat i kontakten»). Klinisk (seponere, avbestille en forordning) spør en gang til, i en alert-dialog der bekreftelsesknappen er verbet («Seponer»), aldri «OK» eller «Ja». Utleverende (nødtilgang, deling utenfor behandlingsteamet) ber først om en begrunnelse og logger den.
  • Når flere journaler er åpne (faner, vinduer, delte paneler), inneholder hver fanes synlige tekst og tilgjengelige navn pasientens navn og en annen identifikator, det aktive panelet gjentar banneret, og ingen handling gjelder en annen pasient enn panelets.
  • Vis stedet journaloppføringer blir knyttet til (posten, poliklinikken eller enheten valgt ved innlogging) som tekst i sidehodet, og gjør det til en uttrykkelig handling å bytte det.
  • Vis det aktive besøket, eller «Ingen aktivt besøk», i banneret. Et skjema som trenger et besøk sier det og tilbyr å starte et, i stedet for å feile når det lagres.

Pasientbanneret

Sammensetningen er beskrevet ved medical-banner, med en fungerende side på /patient-banner i SvelteKit-eksempelappen:

  • to identifikatorer, og alderen ved siden av fødselsdatoen;
  • allergier gjennom en allergiliste, slik at «ingen kjente allergier», «ikke registrert» og «ikke tilgjengelig» aldri ser like ut;
  • en manglende verdi skrives med ord («Ukjent»), aldri som spørsmålstegn, strek eller tom celle;
  • en avdød pasient: data-deceased for temaet, og en synlig tekstlinje, aldri bare farge;
  • ingen felt avkortet, beskåret eller skjult ved noen bredde; det brytes over til neste linje.
  • pasientmarkeringer («Trenger tolk», «Smitterisiko») er en merket tag-group av ord, aldri ikoner eller farge alene, og forblir synlige når banneret brytes.

Prøvesvar

  • Én visning for et prøvesvar, uansett hvilket system det kom fra: observasjonsvisningen.
  • Markeringen er ord fra oversettelsen din (flagLabel), med FHIR-tolkningskoden som data-interpretation for temaet.
  • Skill nye prøvesvar fra tidligere, og vis en utvikling (en sparkline, eller et linjediagram med datatabellen): klinikere ser etter en betydelig endring, ikke bare intervallet.
  • Et prøvesvar som aldri ble registrert og et som ikke er tilgjengelig, er ulike tilstander, med ulike ord.
  • Ukjent er ikke normalt. Et resultat der referanseområdet mangler, fortsatt lastes eller ikke kan leses, har ingen tolkning og sier det; observation-view utleder aldri noen, så et resultat med område og uten interpretation viser ingen markering.
  • Et resultat utenfor skalaen er instrumentets grense med en sammenligningsoperator («> 33,3 mmol/L»: formatQuantity med ">") og deres kritiske markering, aldri et nakent tall. En omtrentlig verdi beholder sin ≈ ("~").
  • Oppgi flere navngitte områder («Kritisk: under 2,5») som ranges, hvert som sin egen del.
  • Et rettet eller endret resultat beholder verdien det erstattet, i et <del>, med deres ord for når det endret seg (previousValue, previousLabel), så en kliniker som leste den gamle verdien vet at den er endret.
  • En intervallmåling sier sin lengde og funksjon («Gjennomsnitt, 24 timer»), og målingens tilstand og metode («Sittende, stor mansjett») er synlig tekst ved siden av, aldri bare et verktøytips (openEHR INTERVAL_EVENT, state, protocol).
  • En trend trenger sammenlignbare punkter: tegn ingen linje under deres minimum, bryt linjen der metoden eller analysen endret seg, og si retning og betydning med ord («fallende, bedring»).
  • Vitale verdier lagt inn i ett enhetssystem kan vise det andre ved siden av som deres tekst («70 kg (154 lb)»); Lily regner ikke om noe, så oppgi avrundingen. Legg inn en mengde med quantity-input-div, der tallet følger hver enhets grenser.
  • En vekstkurve er et line-chart med deres persentillinjer som serier, barnets punkter og datatabellen med alder og verdi; Lily beregner ingen persentil og leverer ingen vekstreferanse.

Legemidler

  • Generiske navn med små bokstaver, unntatt tall man-bokstaver fra listene til FDA og ISMP eller ditt eget land (Australia og Canada publiserer egne). Marker dem i nameSegments; Lily gjetter dem aldri.
  • Skriv styrken med formatQuantity: ingen avsluttende null, en innledende null, et hardt mellomrom før enheten.
  • Behold et resultats sammenligningstegn: formatQuantity(5, "mmol/L", locale, "<") skriver «<5 mmol/L». FHIRs Quantity.comparator skrives <, ≤, ≥ eller >; hvis det utelates, blir «mindre enn 5» til «5».
  • Skriv mL, aldri cc, og unngå enhver forkortelse på ISMPs liste over feilutsatte forkortelser.
  • Avkort aldri navnet eller dosen til et legemiddel.

Datoer og klokkeslett

  • Skriv måneden som tekst, slik at en dato ikke kan leses på to måter (Intl.DateTimeFormat med month: "short").
  • Velg klokke med vilje: oppgi hourCycle eksplisitt. NHS ber om 24-timersklokken; det er en britisk regel, ikke en verdensomspennende, så Lily velger den aldri for deg.
  • Aldre følger nivåene i Common User Interface gjennom ageParts(); en tjeneste med en annen konvensjon oppgir sine egne ord.
  • En dato som bare er kjent til måned eller år forblir slik: spør etter den med date-field precision="month" eller "year", lagre 2019-03 eller 2019, og skriv den med formatPartialDate(). Dikt aldri opp en dag.
  • Et tidsrom er duration-view, et <time datetime="P3DT4H"> som inneholder deres ord, fra durationParts() og Intl.DurationFormat.

Dashbord

  • En avdelingstavle eller et skjermbilde i en kommandosentral oppdateres ofte. Kunngjør aldri hver endring: ha én høflig oppsummeringsregion («3 senger ledige, 2 utskrivninger venter») og la folk lese tavlen.
  • Hver tilstand på en tavle (seng rengjort, opptatt, sperret) er tekst eller en data-*-tilstand med ord, aldri bare farge.
  • Ingenting blinker (WCAG 2.2.2, 2.3.1), og en tavle som oppdateres på tidtaker har en pauseknapp eller oppdateres bare på forespørsel; oppdateringer flytter aldri fokus. En forsinket oppføring sier det med ord («Venter over 20 minutter») med data-overdue.
  • Et antall eller en rate viser nevneren («12 av 68») og lenker til listen bak.
  • En liste eller tidslinje sier hva den er en visning av: hva den viser, rekkefølge og tidsvindu, hva som er skjult og hvorfor, og hvilke kilder som ikke svarte. En tom liste fra en kilde som ikke svarte, beviser ikke at ingenting finnes.
  • En påminnelsesliste er en record-list der elementene har en forfallsdato (review-date) og en forfallsstatus med ord, med data-due; regelen som laget den er deres.

Skjemaer

  • Et spørsmål som besvares «ja», «nei» eller «ikke spurt» er en radio-group med tre svar, ingen valgt fra start, aldri en avkrysningsboks: en avkrysningsboks kan ikke skille «benektet» fra «aldri spurt». En systemgjennomgang er ett fieldset per organsystem, og en knapp «alle øvrige fraværende» setter bare de ubesvarte.
  • Et spørsmål med en liste svar (legemidler, adresser) er et repeatable-fieldset: et element legges til eller fjernes, fokus følger, og hver fjern-knapp er navngitt etter sitt element.
  • Et tall med desimalkomma: vis det med Intl.NumberFormat og, der type="number" ikke godtar kommaet, ta imot det i et tekstfelt med inputmode="decimal" og tolk det i koden. Endre aldri en verdi personen skrev, heller ikke for å holde den innenfor et område: en verdi utenfor området er en feil de kan se.
  • En lang liste som bare viser en del av alternativene om gangen, setter aria-setsize og aria-posinset på hvert alternativ og husker at søk på siden ikke ser resten.

Journaler, notater og deres opphav

  • Si hva en liste eller et rutenett er en visning av, før radene: tidsvindu og rekkefølge, hva den utelater og hvorfor, og hvilke kilder som ikke svarte («Siste 12 måneder, nyeste først. Fastlegejournalen svarte ikke.»). Gi record-list og timeline-list en coverageLabel, og hjelpekomponenten data-grid sin coverageLabel. En tom liste fra en kilde som ikke svarte, sier det med ord, så den aldri leses som «ingenting registrert».
  • Si hvor en oppføring kom fra og om den er endelig med record-provenance-view: signert, venter på signatur, endret, lagret på denne enheten og ikke sendt ennå. Et usignert utkast må aldri se signert ut.
  • En oppføring om noen andre (en forelder, et foster, en donor) sier først hvem den gjelder, med journalelementenes subjectLabel.
  • En tilbakeholdt oppføring blir værende i listen med deres ord («Begrenset: ikke tilgjengelig for deg»), og en feilført oppføring forblir gjennomstreket med «Ført inn ved en feil»: gi record-list-item eller timeline-list-item en entryState og en entryStateLabel. Fjern aldri noen av dem i stillhet, for et hull leses som «ingenting skjedde».
  • I et klinisk notat merkes hvert avsnitts kilde (skrevet, diktert, mal, kopiert fram, generert) med data-source og synlige ord, så kopiert eller generert tekst aldri tas for dagens undersøkelse.
  • En seksjon som ikke kan lastes, er unavailable med deres ord, med en knapp for å prøve igjen; en teknisk kode står, hvis den vises i det hele tatt, bak en utfelling. En feil forårsaket av en persons handling kunngjøres, med verdien journalen nå har; en feil ved lasting av siden gjør ikke det.
  • En forordnings historikk er en timeline-list, ett element per trinn (planlagt, avtalt, aktiv, stanset, fullført, avbestilt) med tid og begrunnelse, og gjeldende tilstand også på elementet.

Fra FHIR til Lily

Lily leser ikke FHIR-ressurser; koden din tilordner dem til Lilys props. Disse tabellene tilordner HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Kodetilordningen er et forslag: din kliniske sikkerhetsvurdering avgjør den, og ordene for hver tilstand er dine egne.

IPS-avsnitt og Lily-komponentene for dem
IPS-avsnitt Lily
Allergier og intoleranser (48765-2) allergy-record-list og dens poster
Legemiddeloversikt (10160-0) medication-record-list, der hver post inneholder en medication-view
Problemliste (11450-4) problem-record-list og dens poster
Vaksinasjoner (11369-6) immunization-record-list og dens poster
Prøvesvar (30954-2) observation-view, i en datatabell eller sammendragsliste
Tidligere inngrep (47519-4) procedure-record-list og dens poster
Medisinsk utstyr (46264-8) device-record-list og dens poster
Varsler (104605-1) Varseltekst eller et varsel, aldri bak en sammenfoldet kontroll
Ethvert annet avsnitt record-list og dens poster
Et obligatorisk avsnitt som dokumentet utelater Avsnittets liste med status="omitted"
FHIR-koder og Lily-verdiene for dem
FHIR Lily
emptyReason nilknown Listens status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", med ord som angir hvilken
IPS-kodene no-known-allergies, no-known-medications og lignende status="none-known"
IPS-kodene no-allergy-info, no-medication-info og lignende status="not-recorded"
AllergyIntolerance.criticality criticality, atskilt fra en reaksjons severity
clinicalStatus, verificationStatus De samme props på allergi- og problempostene, med de samme kodene
MedicationStatement.status Legemiddelpostens status
Dosage.text medication-view dosageText
Observation.status observation-view status, med de samme kodene
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (også på journallistene)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Tilordne en entered-in-error-post til statusen entered-in-error, med ord, i stedet for å droppe den stille: om den i det hele tatt skal vises, er tjenestens beslutning.

Fra openEHR til Lily

Lily leser heller ikke openEHR-komposisjoner. Tilordningen for openEHR-referansemodellens datatyper og koder, som et forslag deres kliniske sikkerhetsgjennomgang avgjør:

openEHR-datatyper og -koder, og Lily-verdiene for dem
openEHR Lily
DV_QUANTITY (registrering) quantity-input-div; enheter som UCUM-koder med deres ord
DV_QUANTITY (visning), magnitude_status observation-view med formatQuantity(value, unit, locale, comparator) (~ er ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges med en meaning observation-view ranges
DV_DATE delvis (år, år og måned) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view med durationParts()
DV_PROPORTION formatProportion() inne i observation-view
DV_ORDINAL, DV_SCALE en radio-group der etikettene bærer tallet og ordene
DV_CODED_TEXT mønsteret for kodede verdier nedenfor
DV_BOOLEAN checkbox-input, bare når «ikke spurt» ikke kan skje
ELEMENT.null_flavour 253 ukjent, 271 ingen opplysninger status="not-recorded" eller "unavailable", med ord som angir hvilken
null_flavour 272 maskert observation-view status="masked"
null_flavour 273 ikke relevant status="not-applicable"
PARTY_RELATED subjekt subjectLabel på journalelementene
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Trinn i Instruction State Machine en timeline-list av trinn, med gjeldende tilstand på elementet
et arketype-element med forekomst 0..* repeatable-fieldset

Kodede verdier

  • Vis Coding.display; hvis den mangler, CodeableConcept.text; hvis ingen av dem finnes, system|code. Aldri en tom celle.
  • Tilby en kontroll som viser kodesystem og kode ved siden av hver verdi, for eksempel en vekslingsknapp med teksten «Vis koder». Skjulte koder står utenfor leserekkefølgen til de vises.
  • Merk klinisk tekst med dokumentets språk (lang), som kan avvike fra grensesnittets. Oversett grensesnittet; oversett aldri det kliniske innholdet.
  • Lily leverer ingen terminologi: ingen oppslag i SNOMED CT, LOINC, ATC eller UCUM. Skriv det dokumentet sier. SvelteKit-eksemplets side /patient-summary viser mønsteret.

Hva Lily ikke vil gjøre

  • Beregne en tidlig varslingsskår, en vekstpersentil, en dose eller et referanseintervall.
  • Levere en legemiddeldatabase, en tall man-liste eller koder fra SNOMED CT, ICD, LOINC eller UCUM.
  • Gjenskape et lisensiert instrument (Wong-Baker FACES) eller en annen organisasjons design (NEWS2-skjemaet).
  • Begrense antallet journaler som er åpne samtidig.
  • Utlede en tolkning fra et område, regne om en enhet eller tolke en relativ dato («neste tirsdag»).
  • Bruke en bryter for «ja, nei eller ukjent»: ARIAs switch har ingen tredje tilstand, så det blir tre radioknapper.

Forskningen, kildene og avgjørelsene bak denne veiledningen finnes i spec/healthcare-ui.