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.
| 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 tilbydoverrideReasons, 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelpåcontext-menuellerdropdown-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-deceasedtil 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-groupaf 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 somdata-interpretationtil 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-viewudleder aldrig en, så et resultat med et interval og udeninterpretationviser ingen markering. -
Et resultat uden for skalaen er instrumentets grænse med en sammenligningsoperator ("> 33,3 mmol/L":
formatQuantitymed">") 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-chartmed 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'sQuantity.comparatorskrives <, ≤, ≥ 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.DateTimeFormatmedmonth: "short"). - Vælg uret med vilje: angiv
hourCycleudtrykkeligt. 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-fieldprecision="month"eller"year", gem2019-03eller2019, og skriv den medformatPartialDate(). Opfind aldrig en dag. -
Et tidsrum er
duration-view, et<time datetime="P3DT4H">med jeres ord, fradurationParts()ogIntl.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, meddata-due; reglen, der lavede den, er jeres.
Formularer
-
Et spørgsmål, der besvares "ja", "nej" eller "ikke spurgt", er en
radio-groupmed tre svar, intet valgt fra start, aldrig et afkrydsningsfelt: et afkrydsningsfelt kan ikke skelne "benægtet" fra "aldrig spurgt". En systemgennemgang er etfieldsetpr. 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.NumberFormatog, hvortype="number"ikke accepterer kommaet, modtag det i et tekstfelt medinputmode="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-setsizeogaria-posinsetpå 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-listogtimeline-listetcoverageLabel, og hjælpepakkendata-gridsitcoverageLabel. 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-itemellertimeline-list-itemetentryStateog etentryStateLabel. 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-sourceog synlige ord, så kopieret eller genereret tekst aldrig tages for dagens undersøgelse. -
En sektion, der ikke kan indlæses, er
unavailablemed 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 | 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 | 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 | 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-summaryviser 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
switchhar ingen tredje tilstand, så det er tre radioknapper.
Undersøgelsen, kilderne og beslutningerne bag denne vejledning findes i spec/healthcare-ui.