Användargränssnitt för vården

En guide för team som bygger klinisk programvara med Lily: kliniska portaler, provsvar och rapportering, förskrivning och administrering av läkemedel, beslutsstöd och instrumentpaneler för sjukhus.

Den här översättningen är ett ogranskat maskinutkast. Den engelska sidan är den gällande versionen.

Vad Lily gör, och vad det inte gör

Lily ger dig visningskontrakt: semantisk markup, ARIA, tangentbordsbeteende och klasskrokar för det som kliniska skärmar upprepar. Det ger dig inte klinisk logik, kliniskt innehåll eller något regulatoriskt påstående.

Vad Lily tillhandahåller, och vad du tillhandahåller
Lily tillhandahåller Du tillhandahåller
observation-view: ett värde, en enhet, en markering i ord, ett intervall och saknade tillstånd Värdet, beslutet om markering, referensintervallet
allergy-record-list och allergy-record-list-item: en status som aldrig är tom Allergiposten och dess terminologi
medication-view: namn, styrka, beredningsform, administreringsväg och frekvens, inget avkortat Läkemedelsdata, tall man-segmenten, den formaterade styrkan
decision-support-card: kortformen från CDS Hooks Reglerna, de föreslagna åtgärderna, registreringen av utfallet
early-warning-score-view: en poäng, en nivå och en eskalering, visade Poängsystemet och dess validerade beräkning
age-view och ageParts(): en ålder i de enheter som passar den Orden för enheterna (Intl.DurationFormat eller dina egna etiketter)
formatQuantity(): 5 mg, aldrig 5,0 mg; 0,5 mg, aldrig ,5 mg Talet, enheten och språkinställningen
Sammansättningen av patientbannern Varje etikett och värde, och vem som får se klinisk information

Reglering. Programvara som beräknar en poäng, en percentil, en dos eller en läkemedelsinteraktion är oftast en medicinteknisk produkt. Lily beräknar inget av detta, med avsikt. Om din produkt är reglerad äger du dess dokumentation för användbarhetsteknik (IEC 62366-1, FDA:s vägledning om mänskliga faktorer, EU:s MDR). Lilys tester, dess självbedömda rapport om tillgänglighetsöverensstämmelse och dess skärmläsarmatris kan vara underlag i den dokumentationen; inget av dem är ett påstående om överensstämmelse, och matrisen har ännu inga resultat.

Varningar: avbryt bara för det som är kritiskt

Varningströtthet är ett säkerhetsproblem: när varje varning avbryter klickar man bort dem alla. AHRQ:s råd är att nivåindela varningar efter allvarlighet och bara låta de allvarliga avbryta.

  • Information (indicator="info"): i flödet, bredvid uppgiften, ett beslutsstödskort på sidan.
  • Varning (indicator="warning"): synlig utan att blockera, samma kort, utformat för att synas; ingen modal.
  • Kritisk (indicator="critical"): lägg kortet i en varningsdialog och erbjud overrideReasons så att det kräver ett skäl att stänga det.
  • Ett beslutsstödskort är aldrig en levande region i sig. Meddela ett nytt kritiskt kort genom att flytta fokus in i dialogen, inte med aria-live.
  • Ta bort ett kort när händelsen det svarade på inträffar igen, och registrera varje utfall (accepterat, eller åsidosatt med sitt skäl).

Patientförväxling: identifiera, begränsa inte

  • Visa två identifierare överallt där en patients uppgifter syns: namnet med födelsedatumet, och den nationella identifieraren med sin visningskomponent (The Joint Commission, Quick Safety 45).
  • Använd patientbannern på varje skärm som påverkar en patients journal, och håll den synlig.
  • Bekräfta en åtgärd på en annan journal än den i bannern med namn, födelsedatum och identifierare innan den utförs.
  • En post om någon annan än patienten (en förälders sjukdomshistoria, ett foster, en donator) säger först med ord vem den gäller: ge journalens poster ett subjectLabel ("Mamma"), så att en anhörigs diagnos aldrig läses som patientens (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Begränsa inte hur många journaler en kliniker får öppna: en randomiserad studie med 3 356 kliniker (JAMA, 2019) fann att det inte minskade ordinationer på fel patient, och folk kringgår det.
  • En meny med åtgärder på en journal nämner först den journalen, med subjectLabel på context-menu eller dropdown-menu ("Ada Lovelace, blodtryck 3 nov"): en icke-interaktiv första del som också är menyns tillgängliga namn.
  • Dela in varje åtgärd efter vad den gör, och gör nivån synlig innan den körs. Rutin (visa, skriv ut) körs direkt. Dokumenterad säger vad den kommer att skriva i journalen ("Lägger till en anteckning i vårdkontakten"). Klinisk (sätta ut, avbryta en ordination) frågar en andra gång, i en alert-dialog vars bekräftelseknapp är verbet ("Sätt ut"), aldrig "OK" eller "Ja". Utlämnande (nödåtkomst, delning utanför vårdteamet) ber först om ett skäl och loggar det.
  • När flera journaler är öppna (flikar, fönster, delade paneler) innehåller varje fliks synliga text och tillgängliga namn patientens namn och en andra identifierare, den aktiva panelen upprepar bannern, och ingen åtgärd gäller en annan patient än panelens.
  • Visa platsen som journalposter kommer att knytas till (avdelningen, mottagningen eller enheten som valdes vid inloggningen) som text i sidhuvudet, och gör det till en uttrycklig åtgärd att byta den.
  • Visa det aktiva besöket, eller "Inget aktivt besök", i bannern. Ett formulär som kräver ett besök säger det och erbjuder att starta ett, i stället för att misslyckas när det sparas.

Patientbannern

Sammansättningen beskrivs vid medical-banner, med en fungerande sida på /patient-banner i SvelteKits exempelapp:

  • två identifierare, och åldern bredvid födelsedatumet;
  • allergier genom en allergilista, så att ”inga kända allergier”, ”inte registrerat” och ”inte tillgängligt” aldrig ser likadana ut;
  • ett saknat värde skrivs i ord (”Okänt”), aldrig som ett frågetecken, ett streck eller en tom cell;
  • en avliden patient: data-deceased för temat, och en synlig textrad, aldrig enbart färg;
  • inget fält avkortat, beskuret eller dolt vid någon bredd; det radbryts.
  • patientmarkeringar ("Behöver tolk", "Smittrisk") är en märkt tag-group av ord, aldrig ikoner eller färg ensamma, och förblir synliga när bannern radbryts.

Provsvar

  • En enda visning för ett provsvar, oavsett vilket system det kom från: observationsvyn.
  • Markeringen är ord från din översättning (flagLabel), med FHIR:s tolkningskod som data-interpretation för temat.
  • Skilj nya provsvar från tidigare och visa en trend (en sparkline, eller ett linjediagram med sin datatabell): kliniker letar efter en betydande förändring, inte bara intervallet.
  • Ett provsvar som aldrig registrerats och ett som inte är tillgängligt är olika tillstånd, med olika ord.
  • Okänt är inte normalt. Ett resultat vars referensintervall saknas, fortfarande laddas eller inte går att läsa har ingen tolkning och säger det; observation-view härleder aldrig någon, så ett resultat med intervall och utan interpretation visar ingen markering.
  • Ett resultat utanför skalan är instrumentets gräns med en jämförelseoperator ("> 33,3 mmol/L": formatQuantity med ">") och er kritiska markering, aldrig ett naket tal. Ett ungefärligt värde behåller sitt ≈ ("~").
  • Ange ytterligare namngivna intervall ("Kritiskt: under 2,5") som ranges, vart och ett som en egen del.
  • Ett rättat eller ändrat resultat behåller värdet det ersatte, i ett <del>, med era ord för när det ändrades (previousValue, previousLabel), så att en kliniker som läste det gamla värdet vet att det ändrats.
  • En intervallmätning anger sin längd och funktion ("Medelvärde, 24 timmar"), och en mätnings tillstånd och metod ("Sittande, stor manschett") är synlig text bredvid, aldrig bara ett verktygstips (openEHR INTERVAL_EVENT, state, protocol).
  • En trend kräver jämförbara punkter: rita ingen linje under ert minimum, bryt linjen där metoden eller analysen ändrades, och säg riktning och innebörd med ord ("sjunkande, förbättras").
  • Vitalparametrar som matats in i ett enhetssystem kan visa det andra bredvid som er text ("70 kg (154 lb)"); Lily räknar inte om något, så ange er avrundning. Mata in en mängd med quantity-input-div, vars tal följer varje enhets gränser.
  • En tillväxtkurva är ett line-chart med era percentillinjer som serier, barnets punkter och dess datatabell med ålder och värde; Lily beräknar ingen percentil och levererar ingen tillväxtreferens.

Läkemedel

  • Generiska namn med små bokstäver, utom tall man-bokstäver från FDA:s och ISMP:s listor eller ditt lands (Australien och Kanada publicerar egna). Markera dem i nameSegments; Lily gissar dem aldrig.
  • Skriv styrkan med formatQuantity: ingen avslutande nolla, en inledande nolla, ett hårt mellanslag före enheten.
  • Behåll ett resultats jämförelsetecken: formatQuantity(5, "mmol/L", locale, "<") skriver ”<5 mmol/L”. FHIR:s Quantity.comparator skrivs <, ≤, ≥ eller >; om det utelämnas blir ”mindre än 5” till ”5”.
  • Skriv mL, aldrig cc, och undvik alla förkortningar på ISMP:s lista över felbenägna förkortningar.
  • Avkorta aldrig ett läkemedels namn eller dos.

Datum och tider

  • Skriv månaden som text så att ett datum inte kan läsas på två sätt (Intl.DateTimeFormat med month: "short").
  • Välj klocka med avsikt: ange hourCycle uttryckligen. NHS begär 24-timmarsklockan; det är en brittisk regel, inte en världsomfattande, så Lily väljer den aldrig åt dig.
  • Åldrar följer Common User Interfaces nivåer genom ageParts(); en tjänst med en annan konvention anger sina egna ord.
  • Ett datum som bara är känt till månad eller år förblir så: fråga efter det med date-field precision="month" eller "year", spara 2019-03 eller 2019, och skriv det med formatPartialDate(). Hitta aldrig på en dag.
  • En tidslängd är duration-view, ett <time datetime="P3DT4H"> som innehåller era ord, från durationParts() och Intl.DurationFormat.

Instrumentpaneler

  • En avdelningstavla eller en ledningscentralsskärm uppdateras ofta. Meddela aldrig varje ändring: behåll en enda artig sammanfattningsregion (”3 lediga sängar, 2 utskrivningar väntar”) och låt folk läsa tavlan.
  • Varje tillstånd på en tavla (säng städad, upptagen, spärrad) är text eller ett data-*-tillstånd med ord, aldrig enbart färg.
  • Inget blinkar (WCAG 2.2.2, 2.3.1), och en tavla som uppdateras på timer har en pausknapp eller uppdateras bara på begäran; uppdateringar flyttar aldrig fokus. En försenad post säger det med ord ("Väntar sedan över 20 minuter") med data-overdue.
  • Ett antal eller en andel visar sin nämnare ("12 av 68") och länkar till listan bakom.
  • En lista eller tidslinje säger vad den är en vy av: vad den visar, dess ordning och tidsfönster, vad som är dolt och varför, och vilka källor som inte svarade. En tom lista från en källa som inte svarade bevisar inte att inget finns.
  • En påminnelselista är en record-list vars poster har ett förfallodatum (review-date) och en förfallostatus med ord, med data-due; regeln som skapade den är er.

Formulär

  • En fråga som besvaras med "ja", "nej" eller "inte frågat" är en radio-group med tre svar, inget valt från början, aldrig en kryssruta: en kryssruta kan inte skilja "förnekat" från "aldrig frågat". En systemgenomgång är ett fieldset per organsystem, och en knapp "alla övriga utan anmärkning" sätter bara de obesvarade.
  • En fråga med en lista av svar (läkemedel, adresser) är ett repeatable-fieldset: en post läggs till eller tas bort, fokus följer med, och varje ta bort-knapp är namngiven efter sin post.
  • Ett tal med decimalkomma: visa det med Intl.NumberFormat och, där type="number" inte godtar kommat, ta emot det i ett textfält med inputmode="decimal" och tolka det i er kod. Ändra aldrig ett värde som personen skrev, inte ens för att hålla det inom ett intervall: ett värde utanför intervallet är ett fel de kan se.
  • En lång lista som bara visar en del av sina alternativ åt gången sätter aria-setsize och aria-posinset på varje alternativ och kommer ihåg att sökning på sidan inte ser resten.

Journaler, anteckningar och deras ursprung

  • Säg vad en lista eller ett rutnät är en vy av, före raderna: tidsfönster och ordning, vad den utelämnar och varför, och vilka källor som inte svarade ("Senaste 12 månaderna, nyast först. Vårdcentralens journal svarade inte."). Ge record-list och timeline-list en coverageLabel, och hjälpkomponenten data-grid sin coverageLabel. En tom lista från en källa som inte svarade säger det med ord, så att den aldrig läses som "inget registrerat".
  • Säg var en post kom ifrån och om den är slutgiltig med record-provenance-view: signerad, väntar på signering, ändrad, sparad på den här enheten och ännu inte skickad. Ett osignerat utkast får aldrig se signerat ut.
  • En post om någon annan (en förälder, ett foster, en donator) säger först vem den gäller, med journalposternas subjectLabel.
  • En undanhållen post stannar i listan med era ord ("Begränsad: inte tillgänglig för dig"), och en post som förts in av misstag förblir överstruken med "Införd av misstag": ge record-list-item eller timeline-list-item ett entryState och en entryStateLabel. Ta aldrig bort någon av dem i tysthet, eftersom en lucka läses som "inget hände".
  • Markera i en klinisk anteckning varje stycke källa (skriven, dikterad, mall, kopierad framåt, genererad) med data-source och synliga ord, så att kopierad eller genererad text aldrig tas för dagens undersökning.
  • En sektion som inte kan laddas är unavailable med era ord, med en knapp för att försöka igen; en teknisk kod, om den alls visas, ligger bakom en utfällning. Ett fel orsakat av en persons handling meddelas, med värdet journalen nu har; ett fel vid sidladdning gör det inte.
  • En ordinations historik är en timeline-list, en post per steg (planerad, bokad, aktiv, pausad, slutförd, avbruten) med tid och skäl, och det aktuella tillståndet även på posten.

Från FHIR till Lily

Lily läser inte FHIR-resurser; din kod mappar dem till Lilys props. Tabellerna nedan mappar HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). Kodmappningen är ett förslag: din kliniska säkerhetsgranskning avgör den, och orden för varje tillstånd är dina egna.

IPS-avsnitt och Lily-komponenterna för dem
IPS-avsnitt Lily
Allergier och intoleranser (48765-2) allergy-record-list och dess poster
Läkemedelssammanfattning (10160-0) medication-record-list, där varje post innehåller en medication-view
Problemlista (11450-4) problem-record-list och dess poster
Vaccinationer (11369-6) immunization-record-list och dess poster
Provsvar (30954-2) observation-view, i en datatabell eller sammanfattningslista
Tidigare ingrepp (47519-4) procedure-record-list och dess poster
Medicintekniska produkter (46264-8) device-record-list och dess poster
Varningar (104605-1) Varningstext eller en varning, aldrig bakom en hopfälld kontroll
Valfritt annat avsnitt record-list och dess poster
Ett obligatoriskt avsnitt som dokumentet utelämnar Avsnittets lista med status="omitted"
FHIR-koder och Lily-värdena för dem
FHIR Lily
emptyReason nilknown Listans status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", med ord som anger vilket
IPS-koderna no-known-allergies, no-known-medications och liknande status="none-known"
IPS-koderna no-allergy-info, no-medication-info och liknande status="not-recorded"
AllergyIntolerance.criticality criticality, skilt från en reaktions severity
clinicalStatus, verificationStatus Samma props på allergi- och problemposterna, med samma koder
MedicationStatement.status Läkemedelspostens status
Dosage.text medication-view dosageText
Observation.status observation-view status, med samma koder
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (även på journallistorna)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Mappa en entered-in-error-post till statusen entered-in-error, med ord, i stället för att tyst släppa den: om den alls ska visas är din tjänsts beslut.

Från openEHR till Lily

Lily läser inte heller openEHR-kompositioner. Mappningen för openEHR-referensmodellens datatyper och koder, som ett förslag som er kliniska säkerhetsgranskning avgör:

openEHR-datatyper och -koder, och Lily-värdena för dem
openEHR Lily
DV_QUANTITY (inmatning) quantity-input-div; enheter som UCUM-koder med era ord
DV_QUANTITY (visning), magnitude_status observation-view med formatQuantity(value, unit, locale, comparator) (~ är ≈)
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 partiellt (år, år och månad) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view med durationParts()
DV_PROPORTION formatProportion() inuti observation-view
DV_ORDINAL, DV_SCALE en radio-group vars etiketter bär talet och dess ord
DV_CODED_TEXT mönstret för kodade värden nedan
DV_BOOLEAN checkbox-input, bara när "inte frågat" inte kan inträffa
ELEMENT.null_flavour 253 okänt, 271 ingen information status="not-recorded" eller "unavailable", med ord som anger vilket
null_flavour 272 maskerad observation-view status="masked"
null_flavour 273 inte tillämpligt status="not-applicable"
PARTY_RELATED subjekt subjectLabel på journalposterna
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Steg i Instruction State Machine en timeline-list av steg, med det aktuella tillståndet på posten
ett arketypelement med förekomst 0..* repeatable-fieldset

Kodade värden

  • Visa Coding.display; om det saknas, CodeableConcept.text; om inget av dem finns, system|code. Aldrig en tom cell.
  • Erbjud en kontroll som visar kodsystem och kod bredvid varje värde, till exempel en växlingsknapp med texten ”Visa koder”. Dolda koder ligger utanför läsordningen tills de visas.
  • Markera kliniskt innehåll med dokumentets språk (lang), som kan skilja sig från gränssnittets. Översätt gränssnittet; översätt aldrig det kliniska innehållet.
  • Lily levereras utan terminologi: inga uppslag av SNOMED CT, LOINC, ATC eller UCUM. Skriv det dokumentet säger. SvelteKit-exemplets sida /patient-summary visar mönstret.

Vad Lily inte kommer att göra

  • Beräkna en tidig varningspoäng, en tillväxtpercentil, en dos eller ett referensintervall.
  • Leverera en läkemedelsdatabas, en tall man-lista eller koder från SNOMED CT, ICD, LOINC eller UCUM.
  • Återskapa ett licensierat instrument (Wong-Baker FACES) eller en annan organisations design (NEWS2-diagrammet).
  • Begränsa antalet journaler som är öppna samtidigt.
  • Härleda en tolkning ur ett intervall, räkna om en enhet eller tolka ett relativt datum ("nästa tisdag").
  • Använda en strömbrytare för "ja, nej eller okänt": ARIAs switch har inget tredje tillstånd, så det blir tre radioknappar.

Forskningen, källorna och besluten bakom den här guiden finns i spec/healthcare-ui.