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.
| 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 tilbyoverrideReasonsslik 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelpåcontext-menuellerdropdown-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-dialogder 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-deceasedfor 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-groupav 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 somdata-interpretationfor 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-viewutleder aldri noen, så et resultat med område og uteninterpretationviser ingen markering. -
Et resultat utenfor skalaen er instrumentets grense med en sammenligningsoperator («> 33,3 mmol/L»:
formatQuantitymed">") 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-chartmed 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». FHIRsQuantity.comparatorskrives <, ≤, ≥ 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.DateTimeFormatmedmonth: "short"). - Velg klokke med vilje: oppgi
hourCycleeksplisitt. 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-fieldprecision="month"eller"year", lagre2019-03eller2019, og skriv den medformatPartialDate(). Dikt aldri opp en dag. -
Et tidsrom er
duration-view, et<time datetime="P3DT4H">som inneholder deres ord, fradurationParts()ogIntl.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-listder elementene har en forfallsdato (review-date) og en forfallsstatus med ord, meddata-due; regelen som laget den er deres.
Skjemaer
-
Et spørsmål som besvares «ja», «nei» eller «ikke spurt» er en
radio-groupmed tre svar, ingen valgt fra start, aldri en avkrysningsboks: en avkrysningsboks kan ikke skille «benektet» fra «aldri spurt». En systemgjennomgang er ettfieldsetper 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.NumberFormatog, dertype="number"ikke godtar kommaet, ta imot det i et tekstfelt medinputmode="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-setsizeogaria-posinsetpå 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-listogtimeline-listencoverageLabel, og hjelpekomponentendata-gridsincoverageLabel. 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-itemellertimeline-list-itemenentryStateog enentryStateLabel. 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-sourceog synlige ord, så kopiert eller generert tekst aldri tas for dagens undersøkelse. -
En seksjon som ikke kan lastes, er
unavailablemed 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 | 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 | 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 | 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-summaryviser 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
switchhar ingen tredje tilstand, så det blir tre radioknapper.
Forskningen, kildene og avgjørelsene bak denne veiledningen finnes i spec/healthcare-ui.