Gebruikersinterfaces voor de zorg

Een gids voor teams die met Lily klinische software bouwen: klinische portalen, uitslagen en rapportage, voorschrijven en toedienen van geneesmiddelen, beslisondersteuning en ziekenhuisdashboards.

Deze vertaling is een niet-gecontroleerd machineconcept. De Engelse pagina is de gezaghebbende versie.

Wat Lily doet, en wat niet

Lily geeft u weergavecontracten: semantische markup, ARIA, toetsenbordgedrag en class-hooks voor wat klinische schermen steeds herhalen. Het geeft u geen klinische logica, geen klinische inhoud en geen regelgevende claim.

Wat Lily levert, en wat u levert
Lily levert U levert
observation-view: een waarde, eenheid, markering in woorden, bereik en ontbrekende toestanden De waarde, de beslissing over de markering, het referentiebereik
allergy-record-list en allergy-record-list-item: een status die nooit leeg is Het allergiedossier en de terminologie ervan
medication-view: naam, sterkte, toedieningsvorm, toedieningsweg en frequentie, niets afgekapt De geneesmiddelgegevens, de tall-mansegmenten, de opgemaakte sterkte
decision-support-card: de kaartvorm van CDS Hooks De regels, de voorgestelde acties, het vastleggen van de uitkomst
early-warning-score-view: een score, categorie en escalatie, weergegeven Het scoresysteem en de gevalideerde berekening ervan
age-view en ageParts(): een leeftijd in de eenheden die erbij passen De woorden voor de eenheden (Intl.DurationFormat of uw eigen labels)
formatQuantity(): 5 mg, nooit 5,0 mg; 0,5 mg, nooit ,5 mg Het getal, de eenheid en de locale
De samenstelling van de patiëntbanner Elk label en elke waarde, en wie klinische informatie mag zien

Regelgeving. Software die een score, een percentiel, een dosis of een geneesmiddelinteractie berekent, is meestal een medisch hulpmiddel. Lily berekent daar niets van, met opzet. Valt uw product onder regelgeving, dan bent u eigenaar van het bruikbaarheidsdossier (IEC 62366-1, de human-factorsrichtlijnen van de FDA, de Europese MDR). De tests van Lily, het zelf beoordeelde toegankelijkheidsconformiteitsrapport en de schermlezermatrix kunnen bewijs zijn in dat dossier; geen van alle is een conformiteitsclaim, en de matrix heeft nog geen resultaten.

Waarschuwingen: onderbreek alleen voor wat kritiek is

Waarschuwingsmoeheid is een veiligheidsprobleem: als elke waarschuwing onderbreekt, klikken mensen ze allemaal weg. Het advies van de AHRQ is waarschuwingen naar ernst in te delen en alleen de ernstige onderbrekend te maken.

  • Informatie (indicator="info"): in de tekst, naast de taak, een beslisondersteuningskaart op de pagina.
  • Waarschuwing (indicator="warning"): zichtbaar zonder te blokkeren, dezelfde kaart, opvallend vormgegeven; geen modaal venster.
  • Kritiek (indicator="critical"): plaats de kaart in een waarschuwingsdialoog en bied overrideReasons aan, zodat wegklikken om een reden vraagt.
  • Een beslisondersteuningskaart is nooit vanzelf een live-regio. Kondig een nieuwe kritieke kaart aan door de focus naar de dialoog te verplaatsen, niet met aria-live.
  • Verwijder een kaart als de gebeurtenis waarop ze reageerde opnieuw plaatsvindt, en leg elke uitkomst vast (geaccepteerd, of genegeerd met de reden).

Patiëntverwisseling: identificeren, niet beperken

  • Toon twee identificatoren overal waar gegevens van een patiënt verschijnen: de naam met de geboortedatum, en het nationale nummer met zijn weergavecomponent (The Joint Commission, Quick Safety 45).
  • Gebruik de patiëntbanner op elk scherm dat op het dossier van één patiënt werkt, en houd hem zichtbaar.
  • Laat een handeling op een ander dossier dan dat in de banner eerst bevestigen met naam, geboortedatum en identificator.
  • Een vermelding over iemand anders dan de patiënt (de voorgeschiedenis van een ouder, een foetus, een donor) zegt eerst in woorden over wie het gaat: geef de dossieritems een subjectLabel ("Moeder"), zodat de diagnose van een familielid nooit wordt gelezen als die van de patiënt (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Beperk niet hoeveel dossiers een zorgverlener mag openen: een gerandomiseerde studie onder 3.356 zorgverleners (JAMA, 2019) vond dat dit voorschriften bij de verkeerde patiënt niet verminderde, en mensen omzeilen het.
  • Een menu met acties op één dossier noemt eerst dat dossier, met subjectLabel op context-menu of dropdown-menu ("Ada Lovelace, bloeddruk 3 nov"): een niet-interactief eerste deel dat ook de toegankelijke naam van het menu is.
  • Deel elke actie in naar wat ze doet, en maak het niveau zichtbaar voordat ze wordt uitgevoerd. Routine (bekijken, afdrukken) wordt meteen uitgevoerd. Gedocumenteerd zegt wat ze in het dossier zal schrijven ("Voegt een notitie toe aan het contact"). Klinisch (stoppen, een order annuleren) vraagt een tweede keer, in een alert-dialog waarvan de bevestigingsknop het werkwoord is ("Stoppen"), nooit "OK" of "Ja". Openbarend (noodtoegang, delen buiten het zorgteam) vraagt eerst om een reden en legt die vast.
  • Als er meerdere dossiers open zijn (tabbladen, vensters, gesplitste panelen), bevatten de zichtbare tekst en de toegankelijke naam van elk tabblad de naam van de patiënt en een tweede kenmerk, herhaalt het actieve paneel de banner, en geldt geen actie voor een andere patiënt dan die van het eigen paneel.
  • Toon de locatie waaraan vastleggingen worden toegeschreven (de afdeling, polikliniek of instelling gekozen bij het aanmelden) als tekst in de paginakop, en maak het wijzigen ervan een uitdrukkelijke actie.
  • Toon het actieve bezoek, of "Geen actief bezoek", in de banner. Een formulier dat een bezoek nodig heeft zegt dat en biedt aan er een te starten, in plaats van te mislukken bij het opslaan.

De patiëntbanner

De samenstelling is gedocumenteerd bij medical-banner, met een werkende pagina op /patient-banner in de SvelteKit-voorbeeldapp:

  • twee identificatoren, en de leeftijd naast de geboortedatum;
  • allergieën via een allergielijst, zodat „geen bekende allergieën”, „niet vastgelegd” en „niet beschikbaar” nooit op elkaar lijken;
  • een ontbrekende waarde staat in woorden („Onbekend”), nooit als vraagteken, streepje of lege cel;
  • een overleden patiënt: data-deceased voor het thema, en een zichtbare regel tekst, nooit alleen kleur;
  • geen veld afgekapt, bijgesneden of verborgen bij welke breedte ook; het loopt door naar de volgende regel.
  • patiëntsignaleringen ("Heeft een tolk nodig", "Infectierisico") zijn een gelabelde tag-group van woorden, nooit alleen pictogrammen of kleur, en blijven zichtbaar als de banner omloopt.

Uitslagen

  • Eén weergave voor een uitslag, uit welk systeem die ook komt: de observatieweergave.
  • De markering bestaat uit woorden uit uw vertaling (flagLabel), met de FHIR-interpretatiecode als data-interpretation voor het thema.
  • Scheid nieuwe uitslagen van eerdere en toon een trend (een sparkline, of een lijngrafiek met zijn gegevenstabel): zorgverleners zoeken een betekenisvolle verandering, niet alleen het bereik.
  • Een uitslag die nooit is vastgelegd en een die niet beschikbaar is, zijn verschillende toestanden, met verschillende woorden.
  • Onbekend is niet normaal. Een uitslag waarvan het referentiebereik ontbreekt, nog laadt of onleesbaar is, heeft geen interpretatie en zegt dat; observation-view leidt er nooit een af, dus een uitslag met een bereik en zonder interpretation toont geen markering.
  • Een uitslag buiten de schaal is de grens van het instrument met een vergelijkingsteken ("> 33,3 mmol/L": formatQuantity met ">") en uw kritieke markering, nooit een kaal getal. Een benaderde waarde houdt haar ≈ ("~").
  • Geef verdere benoemde bereiken ("Kritiek: onder 2,5") als ranges, elk als eigen deel.
  • Een gecorrigeerde of gewijzigde uitslag behoudt de waarde die ze verving, in een <del>, met uw woorden voor wanneer die veranderde (previousValue, previousLabel), zodat een zorgverlener die de oude waarde las weet dat die is veranderd.
  • Een intervalmeting noemt haar duur en functie ("Gemiddelde, 24 uur"), en de toestand en methode van een meting ("Zittend, grote manchet") staan als zichtbare tekst ernaast, nooit alleen in een tooltip (openEHR INTERVAL_EVENT, state, protocol).
  • Een trend heeft vergelijkbare punten nodig: teken geen lijn onder uw minimum, onderbreek de lijn waar de methode of bepaling veranderde, en zeg richting en betekenis in woorden ("dalend, verbeterend").
  • Vitale waarden die in één eenhedenstelsel zijn ingevoerd, kunnen het andere ernaast tonen als uw tekst ("70 kg (154 lb)"); Lily rekent niets om, dus vermeld uw afronding. Voer een hoeveelheid in met quantity-input-div, waarvan het getal de grenzen van elke eenheid volgt.
  • Een groeicurve is een line-chart met uw percentiellijnen als reeksen, de punten van het kind en de gegevenstabel van leeftijd en waarde; Lily berekent geen percentiel en levert geen groeireferentie.

Geneesmiddelen

  • Generieke namen in kleine letters, behalve tall-manletters uit de lijsten van de FDA en het ISMP of van uw eigen land (Australië en Canada publiceren hun eigen lijst). Markeer ze in nameSegments; Lily raadt ze nooit.
  • Schrijf de sterkte met formatQuantity: geen nul achteraan, wel een nul vooraan, een harde spatie vóór de eenheid.
  • Behoud het vergelijkingsteken van een uitslag: formatQuantity(5, "mmol/L", locale, "<") schrijft „<5 mmol/L”. Het Quantity.comparator van FHIR wordt geschreven als <, ≤, ≥ of >; laat u het weg, dan wordt „minder dan 5” tot „5”.
  • Schrijf mL, nooit cc, en vermijd elke afkorting op de ISMP-lijst van foutgevoelige afkortingen.
  • Kap nooit de naam of dosis van een geneesmiddel af.

Datums en tijden

  • Schrijf de maand als tekst, zodat een datum niet op twee manieren te lezen is (Intl.DateTimeFormat met month: "short").
  • Kies de klok bewust: geef hourCycle expliciet door. De NHS vraagt om de 24-uursklok; dat is een Britse regel, geen wereldwijde, dus Lily kiest hem nooit voor u.
  • Leeftijden volgen de categorieën van de Common User Interface via ageParts(); een dienst met een andere conventie geeft zijn eigen woorden door.
  • Een datum die alleen tot op de maand of het jaar bekend is, blijft zo: vraag erom met date-field precision="month" of "year", sla 2019-03 of 2019op en schrijf hem met formatPartialDate(). Verzin nooit een dag.
  • Een tijdsduur is duration-view, een <time datetime="P3DT4H"> met uw woorden, uit durationParts() en Intl.DurationFormat.

Dashboards

  • Een afdelingsbord of meldkamerscherm wordt vaak bijgewerkt. Kondig nooit elke wijziging aan: houd één beleefde samenvattingsregio („3 bedden vrij, 2 ontslagen gepland”) en laat mensen het bord lezen.
  • Elke toestand op een bord (bed schoon, bezet, geblokkeerd) is tekst of een data-*-toestand met woorden, nooit alleen kleur.
  • Niets knippert (WCAG 2.2.2, 2.3.1), en een bord dat op een timer bijwerkt heeft een pauzeknop of werkt alleen bij op verzoek; updates verplaatsen nooit de focus. Een achterstallige vermelding zegt dat in woorden ("Wacht al meer dan 20 minuten") met data-overdue.
  • Een aantal of percentage toont de noemer ("12 van 68") en linkt naar de lijst erachter.
  • Een lijst of tijdlijn zegt waarvan ze een weergave is: wat ze toont, haar volgorde en periode, wat verborgen is en waarom, en welke bronnen niet antwoordden. Een lege lijst van een bron die niet antwoordde, bewijst niet dat er niets is.
  • Een herinneringslijst is een record-list waarvan de items een vervaldatum (review-date) en een vervalstatus in woorden dragen, met data-due; de regel die haar maakte is van u.

Formulieren

  • Een vraag met de antwoorden "ja", "nee" of "niet gevraagd" is een radio-group van drie antwoorden, geen vooraf gekozen, nooit een selectievakje: een selectievakje kan "ontkend" niet onderscheiden van "nooit gevraagd". Een tractusanamnese is één fieldset per orgaansysteem, en een knop "alle overige afwezig" zet alleen de onbeantwoorde.
  • Een vraag met een lijst van antwoorden (medicijnen, adressen) is een repeatable-fieldset: een item wordt toegevoegd of verwijderd, de focus volgt, en elke verwijderknop is naar zijn item genoemd.
  • Een getal met een decimale komma: toon het met Intl.NumberFormat en, waar type="number" de komma niet accepteert, neem het op in een tekstveld met inputmode="decimal" en verwerk het in uw code. Verander nooit een waarde die iemand typte, ook niet om haar binnen een bereik te dwingen: een waarde buiten het bereik is een fout die men kan zien.
  • Een lange lijst die steeds maar een deel van haar opties toont, zet aria-setsize en aria-posinset op elke optie, en houdt er rekening mee dat zoeken op de pagina de rest niet ziet.

Dossiers, notities en hun herkomst

  • Zeg vóór de rijen waarvan een lijst of raster een weergave is: periode en volgorde, wat ze weglaat en waarom, en welke bronnen niet antwoordden ("Laatste 12 maanden, nieuwste eerst. Het huisartsdossier antwoordde niet."). Geef record-list en timeline-list een coverageLabel, en de hulpcomponent data-grid zijn coverageLabel. Een lege lijst van een bron die niet antwoordde zegt dat in woorden, zodat ze nooit wordt gelezen als "niets vastgelegd".
  • Zeg met record-provenance-viewwaar een vastlegging vandaan komt en of ze definitief is: ondertekend, wacht op ondertekening, gewijzigd, op dit apparaat opgeslagen en nog niet verzonden. Een niet-ondertekend concept mag er nooit ondertekend uitzien.
  • Een vermelding over iemand anders (een ouder, een foetus, een donor) zegt eerst over wie het gaat, met subjectLabel.
  • Een achtergehouden vermelding blijft in de lijst met uw woorden ("Beperkt: niet beschikbaar voor u"), en een foutief ingevoerde vermelding blijft doorgestreept met "Foutief ingevoerd": geef record-list-item of timeline-list-item een entryState en een entryStateLabel. Verwijder nooit een van beide stilzwijgend, want een gat wordt gelezen als "er is niets gebeurd".
  • Markeer in een klinische notitie de bron van elk fragment (getypt, gedicteerd, sjabloon, overgenomen, gegenereerd) met data-source en zichtbare woorden, zodat overgenomen of gegenereerde tekst nooit wordt aangezien voor het onderzoek van vandaag.
  • Een sectie die niet kan laden is unavailable in uw woorden, met een knop om het opnieuw te proberen; een technische code staat, als die al getoond wordt, achter een uitklapelement. Een fout door een handeling van de persoon wordt aangekondigd, met de waarde die het dossier nu heeft; een fout bij het laden van de pagina niet.
  • De geschiedenis van een order is een timeline-list, één item per stap (gepland, ingeroosterd, actief, opgeschort, voltooid, geannuleerd) met tijd en reden, en de huidige toestand ook op het item.

Van FHIR naar Lily

Lily leest geen FHIR-resources; uw code koppelt ze aan de props van Lily. Deze tabellen koppelen de HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). De codekoppeling is een suggestie: uw klinische veiligheidsbeoordeling beslist erover, en de woorden voor elke toestand zijn uw eigen.

IPS-secties en de Lily-componenten daarvoor
IPS-sectie Lily
Allergieën en intoleranties (48765-2) allergy-record-list en de items ervan
Medicatieoverzicht (10160-0) medication-record-list, elk item met een medication-view
Probleemlijst (11450-4) problem-record-list en de items ervan
Vaccinaties (11369-6) immunization-record-list en de items ervan
Uitslagen (30954-2) observation-view, in een gegevenstabel of samenvattingslijst
Eerdere ingrepen (47519-4) procedure-record-list en de items ervan
Medische hulpmiddelen (46264-8) device-record-list en de items ervan
Waarschuwingen (104605-1) Waarschuwingstekst of een waarschuwing, nooit achter een ingeklapt bedieningselement
Elke andere sectie record-list en de items ervan
Een verplichte sectie die het document weglaat De lijst van de sectie met status="omitted"
FHIR-codes en de Lily-waarden daarvoor
FHIR Lily
emptyReason nilknown Van de lijst: status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", met woorden die zeggen welke
De IPS-codes no-known-allergies, no-known-medications en dergelijke status="none-known"
De IPS-codes no-allergy-info, no-medication-info en dergelijke status="not-recorded"
AllergyIntolerance.criticality criticality, los van de reactie-severity
clinicalStatus, verificationStatus Dezelfde props op de allergie- en probleemitems, met dezelfde codes
MedicationStatement.status Van het medicatie-item: status
Dosage.text medication-view dosageText
Observation.status observation-view status, met dezelfde codes
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (ook op de dossierlijsten)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Koppel een entered-in-error-registratie aan de status entered-in-error, met woorden, in plaats van haar stilzwijgend weg te laten: of ze getoond wordt, beslist uw dienst.

Van openEHR naar Lily

Lily leest ook geen openEHR-composities. De koppeling voor de gegevenstypen en codes van het openEHR-referentiemodel, als suggestie waarover uw klinische veiligheidsbeoordeling beslist:

openEHR-gegevenstypen en -codes, en de Lily-waarden ervoor
openEHR Lily
DV_QUANTITY (invoer) quantity-input-div; eenheden als UCUM-codes met uw woorden
DV_QUANTITY (weergave), magnitude_status observation-view met formatQuantity(value, unit, locale, comparator) (~ is ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges met een meaning observation-view ranges
DV_DATE gedeeltelijk (jaar, jaar en maand) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view met durationParts()
DV_PROPORTION formatProportion() binnen observation-view
DV_ORDINAL, DV_SCALE een radio-group waarvan de labels het getal en zijn woorden dragen
DV_CODED_TEXT het patroon voor gecodeerde waarden hieronder
DV_BOOLEAN checkbox-input, alleen als "niet gevraagd" niet kan voorkomen
ELEMENT.null_flavour 253 onbekend, 271 geen informatie status="not-recorded" of "unavailable", met woorden die zeggen welke
null_flavour 272 afgeschermd observation-view status="masked"
null_flavour 273 niet van toepassing status="not-applicable"
PARTY_RELATED subject subjectLabel op de dossieritems
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Stappen van de Instruction State Machine een timeline-list van stappen, met de huidige toestand op het item
een archetype-item met voorkomen 0..* repeatable-fieldset

Gecodeerde waarden

  • Toon Coding.display; is die er niet, CodeableConcept.text; is geen van beide er, system|code. Nooit een lege cel.
  • Bied een bedieningselement dat het codesysteem en de code naast elke waarde toont, zoals een schakelknop met „Codes tonen”. Verborgen codes blijven buiten de leesvolgorde totdat ze worden getoond.
  • Markeer klinische tekst met de taal van het document (lang), die kan verschillen van die van de interface. Vertaal de interface; vertaal nooit de klinische inhoud.
  • Lily levert geen terminologie mee: geen opzoeken in SNOMED CT, LOINC, ATC of UCUM. Schrijf wat het document zegt. De pagina /patient-summary van het SvelteKit-voorbeeld toont het patroon.

Wat Lily niet zal doen

  • Een vroegewaarschuwingsscore, een groeipercentiel, een dosis of een referentiebereik berekenen.
  • Een geneesmiddeldatabase, een tall-manlijst, of codes uit SNOMED CT, ICD, LOINC of UCUM meeleveren.
  • Een gelicentieerd instrument (Wong-Baker FACES) of het ontwerp van een andere instantie (de NEWS2-kaart) nabootsen.
  • Het aantal tegelijk geopende dossiers beperken.
  • Een interpretatie afleiden uit een bereik, een eenheid omrekenen of een relatieve datum ("volgende dinsdag") interpreteren.
  • Een schakelaar gebruiken voor "ja, nee of onbekend": de switch van ARIA heeft geen derde toestand, dus het zijn drie keuzerondjes.

Het onderzoek, de bronnen en de beslissingen achter deze gids staan in spec/healthcare-ui.