Brugergrænseflader til sundhedsvæsenet

En vejledning til teams, der bygger klinisk software med Lily: kliniske portaler, prøvesvar og rapportering, ordination og administration af lægemidler, beslutningsstøtte og hospitalsdashboards.

Denne oversættelse er et ugennemset maskinudkast. Den engelske side er den gældende version.

Hvad Lily gør, og hvad det ikke gør

Lily giver dig visningskontrakter: semantisk markup, ARIA, tastaturadfærd og klassehooks til det, kliniske skærme gentager. Det giver dig ikke klinisk logik, klinisk indhold eller en regulatorisk påstand.

Hvad Lily leverer, og hvad du leverer
Lily leverer Du leverer
observation-view: en værdi, en enhed, en markering i ord, et interval og manglende tilstande Værdien, beslutningen om markering, referenceintervallet
allergy-record-list og allergy-record-list-item: en status, der aldrig er tom Allergiregistreringen og dens terminologi
medication-view: navn, styrke, form, indgiftsvej og hyppighed, intet afkortet Lægemiddeldata, tall man-segmenterne, den formaterede styrke
decision-support-card: kortformen fra CDS Hooks Reglerne, de foreslåede handlinger, registreringen af udfaldet
early-warning-score-view: en score, et niveau og en eskalering, vist Scoringssystemet og dets validerede beregning
age-view og ageParts(): en alder i de enheder, der passer til den Ordene for enhederne (Intl.DurationFormat eller dine egne etiketter)
formatQuantity(): 5 mg, aldrig 5,0 mg; 0,5 mg, aldrig ,5 mg Tallet, enheden og sprogindstillingen
Sammensætningen af patientbanneret Hver etiket og værdi, og hvem der må se kliniske oplysninger

Regulering. Software, der beregner en score, en percentil, en dosis eller en lægemiddelinteraktion, er som regel medicinsk udstyr. Lily beregner intet af dette, med vilje. Hvis dit produkt er reguleret, ejer du dets dokumentation for brugervenlighed (IEC 62366-1, FDA's vejledning om menneskelige faktorer, EU's MDR). Lilys tests, dets selvvurderede rapport om tilgængelighedsoverensstemmelse og dets skærmlæsermatrix kan være dokumentation i den; ingen af dem er en påstand om overensstemmelse, og matrixen har endnu ingen resultater.

Advarsler: afbryd kun for det kritiske

Advarselstræthed er et sikkerhedsproblem: når hver advarsel afbryder, klikker folk dem alle væk. AHRQ anbefaler at inddele advarsler efter alvor og kun lade de alvorlige afbryde.

  • Information (indicator="info"): i teksten, ved siden af opgaven, et beslutningsstøttekort på siden.
  • Advarsel (indicator="warning"): synlig uden at blokere, det samme kort, udformet til at skille sig ud; ingen modal.
  • Kritisk (indicator="critical"): læg kortet i en advarselsdialog, og tilbyd overrideReasons, så det kræver en begrundelse at afvise det.
  • Et beslutningsstøttekort er aldrig i sig selv en live-region. Annoncér et nyt kritisk kort ved at flytte fokus ind i dialogen, ikke med aria-live.
  • Fjern et kort, når den hændelse, det besvarede, sker igen, og registrér hvert udfald (accepteret eller tilsidesat med begrundelse).

Patientforveksling: identificér, begræns ikke

  • Vis to identifikatorer overalt, hvor en patients data vises: navnet med fødselsdatoen og det nationale id med dets visningskomponent (The Joint Commission, Quick Safety 45).
  • Brug patientbanneret på hver skærm, der handler på én patients journal, og hold det synligt.
  • Før en handling på en anden journal end den i banneret skal den bekræftes med navn, fødselsdato og identifikator.
  • En indførsel om en anden end patienten (en forælders sygehistorie, et foster, en donor) siger først med ord, hvem den handler om: giv journalens elementer et subjectLabel ("Mor"), så en slægtnings diagnose aldrig læses som patientens (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Begræns ikke, hvor mange journaler en kliniker må åbne: et randomiseret forsøg med 3.356 klinikere (JAMA, 2019) viste, at det ikke reducerede ordinationer til den forkerte patient, og folk omgår det.
  • En menu med handlinger på én journal nævner først den journal, med subjectLabel på context-menu eller dropdown-menu ("Ada Lovelace, blodtryk 3. nov."): en ikke-interaktiv første del, som også er menuens tilgængelige navn.
  • Inddel hver handling efter, hvad den gør, og gør niveauet synligt, før den udføres. Rutine (se, udskriv) udføres med det samme. Dokumenteret siger, hvad den vil skrive i journalen ("Tilføjer et notat til kontakten"). Klinisk (seponere, annullere en ordination) spørger en gang til, i en alert-dialog , hvis bekræftelsesknap er verbet ("Seponér"), aldrig "OK" eller "Ja". Videregivende (nødadgang, deling uden for behandlerteamet) beder først om en begrundelse og registrerer den.
  • Når flere journaler er åbne (faner, vinduer, delte paneler), indeholder hver fanes synlige tekst og tilgængelige navn patientens navn og en anden identifikator, det aktive panel gentager banneret, og ingen handling gælder en anden patient end panelets.
  • Vis det sted, journalindførsler vil blive tilknyttet (afsnittet, ambulatoriet eller institutionen valgt ved login), som tekst i sidehovedet, og gør det til en udtrykkelig handling at skifte det.
  • Vis det aktive besøg, eller "Intet aktivt besøg", i banneret. En formular, der kræver et besøg, siger det og tilbyder at starte et, i stedet for at fejle, når den gemmes.

Patientbanneret

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

  • to identifikatorer, og alderen ved siden af fødselsdatoen;
  • allergier gennem en allergiliste, så „ingen kendte allergier“, „ikke registreret“ og „ikke tilgængelig“ aldrig ligner hinanden;
  • en manglende værdi skrives med ord („Ukendt“), aldrig som spørgsmålstegn, bindestreg eller tom celle;
  • en afdød patient: data-deceased til temaet og en synlig tekstlinje, aldrig kun farve;
  • intet felt afkortet, beskåret eller skjult ved nogen bredde; det ombrydes.
  • patientmarkeringer ("Har brug for tolk", "Smitterisiko") er en mærket tag-group af ord, aldrig ikoner eller farve alene, og forbliver synlige, når banneret ombrydes.

Prøvesvar

  • Én visning af et prøvesvar, uanset hvilket system det kom fra: observationsvisningen.
  • Markeringen er ord fra din oversættelse (flagLabel), med FHIR-fortolkningskoden som data-interpretation til temaet.
  • Adskil nye prøvesvar fra tidligere, og vis en udvikling (en sparkline eller et kurvediagram med sin datatabel): klinikere leder efter en betydelig ændring, ikke kun intervallet.
  • Et prøvesvar, der aldrig er registreret, og et, der ikke er tilgængeligt, er forskellige tilstande med forskellige ord.
  • Ukendt er ikke normalt. Et resultat, hvis referenceinterval mangler, stadig indlæses eller ikke kan læses, har ingen fortolkning og siger det; observation-view udleder aldrig en, så et resultat med et interval og uden interpretation viser ingen markering.
  • Et resultat uden for skalaen er instrumentets grænse med en sammenligningsoperator ("> 33,3 mmol/L": formatQuantity med ">") og jeres kritiske markering, aldrig et nøgent tal. En omtrentlig værdi beholder sit ≈ ("~").
  • Angiv yderligere navngivne intervaller ("Kritisk: under 2,5") som ranges, hver som sin egen del.
  • Et rettet eller ændret resultat beholder den værdi, det erstattede, i et <del>, med jeres ord for, hvornår det ændrede sig (previousValue, previousLabel), så en kliniker, der læste den gamle værdi, ved, at den er ændret.
  • En intervalmåling angiver sin varighed og funktion ("Gennemsnit, 24 timer"), og en målings tilstand og metode ("Siddende, stor manchet") er synlig tekst ved siden af, aldrig kun et værktøjstip (openEHR INTERVAL_EVENT, state, protocol).
  • En tendens kræver sammenlignelige punkter: tegn ingen linje under jeres minimum, afbryd linjen, hvor metoden eller analysen ændrede sig, og sig retning og betydning med ord ("faldende, bedring").
  • Vitale værdier indtastet i ét enhedssystem kan vise det andet ved siden af som jeres tekst ("70 kg (154 lb)"); Lily omregner intet, så oplys jeres afrunding. Indtast en mængde med quantity-input-div, hvis tal følger hver enheds grænser.
  • En vækstkurve er et line-chart med jeres percentillinjer som serier, barnets punkter og dets datatabel med alder og værdi; Lily beregner ingen percentil og leverer ingen vækstreference.

Lægemidler

  • Generiske navne med små bogstaver, undtagen tall man-bogstaver fra FDA's og ISMP's lister eller dit lands (Australien og Canada udgiver deres egne). Markér dem i nameSegments; Lily gætter dem aldrig.
  • Skriv styrken med formatQuantity: intet efterstillet nul, et foranstillet nul, et hårdt mellemrum før enheden.
  • Bevar et resultats sammenligningstegn: formatQuantity(5, "mmol/L", locale, "<") skriver „<5 mmol/L“. FHIR's Quantity.comparator skrives <, ≤, ≥ eller >; hvis det udelades, bliver „mindre end 5“ til „5“.
  • Skriv mL, aldrig cc, og undgå enhver forkortelse på ISMP's liste over fejlbehæftede forkortelser.
  • Afkort aldrig et lægemiddels navn eller dosis.

Datoer og klokkeslæt

  • Skriv måneden som tekst, så en dato ikke kan læses på to måder (Intl.DateTimeFormat med month: "short").
  • Vælg uret med vilje: angiv hourCycle udtrykkeligt. NHS beder om 24-timersuret; det er en britisk regel, ikke en global, så Lily vælger det aldrig for dig.
  • Aldre følger Common User Interfaces niveauer gennem ageParts(); en tjeneste med en anden konvention angiver sine egne ord.
  • En dato, der kun kendes til måned eller år, forbliver sådan: spørg efter den med date-field precision="month" eller "year", gem 2019-03 eller 2019, og skriv den med formatPartialDate(). Opfind aldrig en dag.
  • Et tidsrum er duration-view, et <time datetime="P3DT4H"> med jeres ord, fra durationParts() og Intl.DurationFormat.

Dashboards

  • En afdelingstavle eller en kommandocentralskærm opdateres ofte. Annoncér aldrig hver ændring: hold én høflig opsummeringsregion („3 senge ledige, 2 udskrivelser forestående“), og lad folk læse tavlen.
  • Hver tilstand på en tavle (seng rengjort, optaget, spærret) er tekst eller en data-*-tilstand med ord, aldrig kun farve.
  • Intet blinker (WCAG 2.2.2, 2.3.1), og en tavle, der opdateres på en timer, har en pauseknap eller opdateres kun på forespørgsel; opdateringer flytter aldrig fokus. En forsinket indførsel siger det med ord ("Venter over 20 minutter") med data-overdue.
  • Et antal eller en rate viser sin nævner ("12 af 68") og linker til listen bag den.
  • En liste eller tidslinje siger, hvad den er en visning af: hvad den viser, dens rækkefølge og tidsrum, hvad der er skjult og hvorfor, og hvilke kilder der ikke svarede. En tom liste fra en kilde, der ikke svarede, beviser ikke, at intet findes.
  • En påmindelsesliste er en record-list , hvis elementer har en forfaldsdato (review-date) og en forfaldsstatus med ord, med data-due; reglen, der lavede den, er jeres.

Formularer

  • Et spørgsmål, der besvares "ja", "nej" eller "ikke spurgt", er en radio-group med tre svar, intet valgt fra start, aldrig et afkrydsningsfelt: et afkrydsningsfelt kan ikke skelne "benægtet" fra "aldrig spurgt". En systemgennemgang er et fieldset pr. organsystem, og en knap "alle øvrige fraværende" sætter kun de ubesvarede.
  • Et spørgsmål med en liste af svar (medicin, adresser) er et repeatable-fieldset: et element tilføjes eller fjernes, fokus følger med, og hver fjern-knap er navngivet efter sit element.
  • Et tal med decimalkomma: vis det med Intl.NumberFormat og, hvor type="number" ikke accepterer kommaet, modtag det i et tekstfelt med inputmode="decimal" og fortolk det i jeres kode. Ændr aldrig en værdi, personen skrev, heller ikke for at holde den inden for et interval: en værdi uden for intervallet er en fejl, de kan se.
  • En lang liste, der kun viser en del af sine valgmuligheder ad gangen, sætter aria-setsize og aria-posinset på hver mulighed og husker, at søgning på siden ikke kan se resten.

Journaler, notater og deres oprindelse

  • Sig, hvad en liste eller et gitter er en visning af, før rækkerne: tidsrum og rækkefølge, hvad den udelader og hvorfor, og hvilke kilder der ikke svarede ("Seneste 12 måneder, nyeste først. Den praktiserende læges journal svarede ikke."). Giv record-list og timeline-list et coverageLabel, og hjælpepakken data-grid sit coverageLabel. En tom liste fra en kilde, der ikke svarede, siger det med ord, så den aldrig læses som "intet registreret".
  • Sig, hvor en indførsel kom fra, og om den er endelig, med record-provenance-view: underskrevet, afventer underskrift, ændret, gemt på denne enhed og endnu ikke sendt. Et ikke-underskrevet udkast må aldrig se underskrevet ud.
  • En indførsel om en anden (en forælder, et foster, en donor) siger først, hvem den handler om, med journalelementernes subjectLabel.
  • En tilbageholdt indførsel bliver i listen med jeres ord ("Begrænset: ikke tilgængelig for dig"), og en fejlindtastet indførsel forbliver overstreget med "Indtastet ved en fejl": giv record-list-item eller timeline-list-item et entryState og et entryStateLabel. Fjern aldrig nogen af dem i stilhed, for et hul læses som "intet skete".
  • I et klinisk notat skal hver passages kilde (skrevet, dikteret, skabelon, kopieret frem, genereret) markeres med data-source og synlige ord, så kopieret eller genereret tekst aldrig tages for dagens undersøgelse.
  • En sektion, der ikke kan indlæses, er unavailable med jeres ord, med en knap til at prøve igen; en teknisk kode står, hvis den overhovedet vises, bag en udfoldning. En fejl forårsaget af en persons handling annonceres, med den værdi journalen nu har; en fejl ved indlæsning af siden gør ikke.
  • En ordinations historik er en timeline-list, ét element pr. trin (planlagt, booket, aktiv, pauseret, afsluttet, annulleret) med tid og begrundelse, og den aktuelle tilstand også på elementet.

Fra FHIR til Lily

Lily læser ikke FHIR-ressourcer; din kode afbilder dem til Lilys props. Disse tabeller afbilder HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Kodeafbildningen er et forslag: din kliniske sikkerhedsgennemgang afgør den, og ordene for hver tilstand er dine egne.

IPS-afsnit og Lily-komponenterne til dem
IPS-afsnit Lily
Allergier og intolerancer (48765-2) allergy-record-list og dens poster
Medicinoversigt (10160-0) medication-record-list, hvor hver post rummer en medication-view
Problemliste (11450-4) problem-record-list og dens poster
Vaccinationer (11369-6) immunization-record-list og dens poster
Prøvesvar (30954-2) observation-view, i en datatabel eller oversigtsliste
Tidligere indgreb (47519-4) procedure-record-list og dens poster
Medicinsk udstyr (46264-8) device-record-list og dens poster
Advarsler (104605-1) Advarselstekst eller en advarsel, aldrig bag en foldet kontrol
Ethvert andet afsnit record-list og dens poster
Et obligatorisk afsnit, som dokumentet udelader Afsnittets liste med status="omitted"
FHIR-koder og Lily-værdierne for dem
FHIR Lily
emptyReason nilknown Listens status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", med ord, der angiver hvilken
IPS-koderne no-known-allergies, no-known-medications og lignende status="none-known"
IPS-koderne no-allergy-info, no-medication-info og lignende status="not-recorded"
AllergyIntolerance.criticality criticality, adskilt fra en reaktions severity
clinicalStatus, verificationStatus De samme props på allergi- og problemposterne, med de samme koder
MedicationStatement.status Medicinpostens status
Dosage.text medication-view dosageText
Observation.status observation-view status, med de samme koder
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (også på journallisterne)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Afbild en entered-in-error-post til dens status entered-in-error, med ord, i stedet for at tabe den lydløst: om den overhovedet skal vises, er din tjenestes beslutning.

Fra openEHR til Lily

Lily læser heller ikke openEHR-kompositioner. Tilknytningen for openEHR-referencemodellens datatyper og koder, som et forslag, jeres kliniske sikkerhedsgennemgang tager stilling til:

openEHR-datatyper og -koder og Lily-værdierne for dem
openEHR Lily
DV_QUANTITY (indtastning) quantity-input-div; enheder som UCUM-koder med jeres 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() inde i observation-view
DV_ORDINAL, DV_SCALE en radio-group , hvis etiketter bærer tallet og dets ord
DV_CODED_TEXT mønsteret for kodede værdier nedenfor
DV_BOOLEAN checkbox-input, kun når "ikke spurgt" ikke kan forekomme
ELEMENT.null_flavour 253 ukendt, 271 ingen oplysninger status="not-recorded" eller "unavailable", med ord, der angiver hvilken
null_flavour 272 skjult observation-view status="masked"
null_flavour 273 ikke relevant status="not-applicable"
PARTY_RELATED subjekt subjectLabel på journalelementerne
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Trin i Instruction State Machine en timeline-list af trin, med den aktuelle tilstand på elementet
et arketype-element med forekomst 0..* repeatable-fieldset

Kodede værdier

  • Vis Coding.display; hvis der ingen er, CodeableConcept.text; hvis ingen af dem findes, system|code. Aldrig en tom celle.
  • Tilbyd en kontrol, der viser kodesystem og kode ved siden af hver værdi, for eksempel en til/fra-knap med teksten „Vis koder“. Skjulte koder står uden for læserækkefølgen, indtil de vises.
  • Marker klinisk tekst med dokumentets sprog (lang), som kan afvige fra grænsefladens. Oversæt grænsefladen; oversæt aldrig det kliniske indhold.
  • Lily leverer ingen terminologi: ingen opslag i SNOMED CT, LOINC, ATC eller UCUM. Skriv det, dokumentet siger. SvelteKit-eksemplets side /patient-summary viser mønsteret.

Hvad Lily ikke vil gøre

  • Beregne en tidlig varslingsscore, en vækstpercentil, en dosis eller et referenceinterval.
  • Levere en lægemiddeldatabase, en tall man-liste eller koder fra SNOMED CT, ICD, LOINC eller UCUM.
  • Gengive et licenseret instrument (Wong-Baker FACES) eller en anden organisations design (NEWS2-skemaet).
  • Begrænse antallet af journaler, der er åbne på én gang.
  • Udlede en fortolkning af et interval, omregne en enhed eller fortolke en relativ dato ("næste tirsdag").
  • Bruge en kontakt til "ja, nej eller ukendt": ARIAs switch har ingen tredje tilstand, så det er tre radioknapper.

Undersøgelsen, kilderne og beslutningerne bag denne vejledning findes i spec/healthcare-ui.