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.
| 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 biedoverrideReasonsaan, 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelopcontext-menuofdropdown-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-dialogwaarvan 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-deceasedvoor 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-groupvan 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 alsdata-interpretationvoor 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-viewleidt er nooit een af, dus een uitslag met een bereik en zonderinterpretationtoont geen markering. -
Een uitslag buiten de schaal is de grens van het instrument met een vergelijkingsteken ("> 33,3 mmol/L":
formatQuantitymet">") 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-chartmet 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”. HetQuantity.comparatorvan 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.DateTimeFormatmetmonth: "short"). - Kies de klok bewust: geef
hourCycleexpliciet 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-fieldprecision="month"of"year", sla2019-03of2019op en schrijf hem metformatPartialDate(). Verzin nooit een dag. -
Een tijdsduur is
duration-view, een<time datetime="P3DT4H">met uw woorden, uitdurationParts()enIntl.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-listwaarvan de items een vervaldatum (review-date) en een vervalstatus in woorden dragen, metdata-due; de regel die haar maakte is van u.
Formulieren
-
Een vraag met de antwoorden "ja", "nee" of "niet gevraagd" is een
radio-groupvan drie antwoorden, geen vooraf gekozen, nooit een selectievakje: een selectievakje kan "ontkend" niet onderscheiden van "nooit gevraagd". Een tractusanamnese is éénfieldsetper 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.NumberFormaten, waartype="number"de komma niet accepteert, neem het op in een tekstveld metinputmode="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-setsizeenaria-posinsetop 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-listentimeline-listeencoverageLabel, en de hulpcomponentdata-gridzijncoverageLabel. 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-itemoftimeline-list-itemeenentryStateen eenentryStateLabel. 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-sourceen zichtbare woorden, zodat overgenomen of gegenereerde tekst nooit wordt aangezien voor het onderzoek van vandaag. -
Een sectie die niet kan laden is
unavailablein 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-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 | 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 | 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-summaryvan 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
switchvan 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.