Interfaces utilisateur de santé

Un guide pour les équipes qui conçoivent des logiciels cliniques avec Lily : portails cliniques, résultats et comptes rendus, prescription et administration des médicaments, aide à la décision et tableaux de bord hospitaliers.

Cette traduction est un brouillon automatique non relu. La page en anglais fait foi.

Ce que Lily fait, et ce qu'il ne fait pas

Lily vous donne des contrats d'affichage : un balisage sémantique, ARIA, le comportement au clavier et des classes CSS pour ce que les écrans cliniques répètent. Il ne vous donne ni logique clinique, ni contenu clinique, ni allégation réglementaire.

Ce que Lily fournit, et ce que vous fournissez
Lily fournit Vous fournissez
observation-view : une valeur, une unité, un indicateur en toutes lettres, un intervalle et les états manquants La valeur, la décision d'indicateur, l'intervalle de référence
allergy-record-list et allergy-record-list-item : un statut qui n'est jamais vide Le dossier d'allergies et sa terminologie
medication-view : nom, dosage, forme, voie et fréquence, sans aucune troncature Les données sur les médicaments, les segments en lettres majuscules différenciées (tall man), le dosage mis en forme
decision-support-card : la forme de carte CDS Hooks Les règles, les actions suggérées, l'enregistrement de la décision
early-warning-score-view : un score, une tranche et une escalade, affichés Le système de score et son calcul validé
age-view et ageParts() : un âge dans les unités qui lui conviennent Les mots pour les unités (Intl.DurationFormat ou vos propres libellés)
formatQuantity() : 5 mg, jamais 5,0 mg ; 0,5 mg, jamais ,5 mg Le nombre, l'unité et la locale
La composition du bandeau patient Chaque libellé et chaque valeur, et qui peut voir les informations cliniques

Réglementation. Un logiciel qui calcule un score, un percentile, une dose ou une interaction médicamenteuse est généralement un dispositif médical. Lily ne calcule rien de tout cela, à dessein. Si votre produit est réglementé, c'est à vous que revient son dossier d'ingénierie de l'aptitude à l'utilisation (IEC 62366-1, les recommandations de la FDA sur les facteurs humains, le règlement européen MDR). Les tests de Lily, son rapport de conformité d'accessibilité auto-évalué et sa matrice de lecteurs d'écran peuvent servir de preuves dans ce dossier ; aucun n'est une déclaration de conformité, et la matrice n'a encore aucun résultat.

Alertes : n'interrompre que pour ce qui est critique

La fatigue d'alerte est un problème de sécurité : quand chaque alerte interrompt, on finit par toutes les ignorer. L'AHRQ recommande de hiérarchiser les alertes par gravité et de ne rendre interruptives que les plus graves.

  • Information (indicator="info") : en ligne, à côté de la tâche, une carte d'aide à la décision dans la page.
  • Avertissement (indicator="warning") : visible sans bloquer, la même carte, mise en forme pour se démarquer ; pas de fenêtre modale.
  • Critique (indicator="critical") : placez la carte dans une boîte de dialogue d'alerte, et proposez overrideReasons pour que son rejet demande un motif.
  • Une carte d'aide à la décision n'est jamais une région live à elle seule. Annoncez une nouvelle carte critique en déplaçant le focus dans la boîte de dialogue, et non par aria-live.
  • Retirez une carte quand l'événement auquel elle répondait se reproduit, et enregistrez chaque issue (acceptée, ou passée outre avec son motif).

Erreurs de patient : identifier, ne pas restreindre

  • Affichez deux identifiants partout où apparaissent les données d'un patient : le nom avec la date de naissance, et l'identifiant national avec son composant d'affichage (The Joint Commission, Quick Safety 45).
  • Utilisez le bandeau patient sur chaque écran qui agit sur le dossier d'un patient, et gardez-le visible.
  • Avant une action sur un dossier autre que celui du bandeau, faites-la confirmer avec le nom, la date de naissance et l'identifiant.
  • Une entrée qui concerne une autre personne que le patient (les antécédents d'un parent, un fœtus, un donneur) dit d'abord à qui elle se rapporte, en toutes lettres : donnez aux éléments du dossier un subjectLabel (« Mère »), afin que le diagnostic d'un proche ne soit jamais lu comme celui du patient (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • Ne limitez pas le nombre de dossiers qu'un clinicien peut ouvrir : un essai randomisé portant sur 3 356 cliniciens (JAMA, 2019) a montré que cela ne réduisait pas les prescriptions sur le mauvais patient, et les gens le contournent.
  • Un menu d'actions sur un dossier nomme d'abord ce dossier, avec subjectLabel sur context-menu ou dropdown-menu (« Ada Lovelace, tension artérielle 3 nov. ») : une première partie non interactive qui est aussi le nom accessible du menu.
  • Classez chaque action selon ce qu'elle fait, et rendez son niveau visible avant qu'elle ne s'exécute. Routine (consulter, imprimer) s'exécute immédiatement. Documentée dit ce qu'elle va écrire dans le dossier (« Ajoute une note à la consultation »). Clinique (arrêter, annuler une prescription) demande une seconde confirmation, dans un alert-dialog dont le bouton de confirmation est le verbe (« Arrêter »), jamais « OK » ni « Oui ». Divulgatrice (accès d'urgence, partage hors de l'équipe soignante) demande d'abord un motif et l'enregistre.
  • Quand plusieurs dossiers sont ouverts (onglets, fenêtres, volets), le texte visible et le nom accessible de chaque onglet incluent le nom du patient et un second identifiant, le volet actif répète le bandeau, et aucune action ne s'applique à un autre patient que celui de son volet.
  • Affichez sous forme de texte, dans l'en-tête de page, le lieu auquel les dossiers seront rattachés (le service, la consultation ou l'établissement choisi à la connexion), et faites de son changement une action explicite.
  • Affichez la venue en cours, ou « Aucune venue en cours », dans le bandeau. Un formulaire qui exige une venue le dit et propose d'en ouvrir une, au lieu d'échouer à l'enregistrement.

Le bandeau patient

La composition est documentée avec medical-banner, avec une page fonctionnelle à /patient-banner dans l'application d'exemple SvelteKit :

  • deux identifiants, et l'âge à côté de la date de naissance ;
  • les allergies par une liste d'allergies, pour que « aucune allergie connue », « non renseigné » et « indisponible » ne se ressemblent jamais ;
  • une valeur manquante s'écrit en mots (« Inconnu »), jamais par un point d'interrogation, un tiret ou une cellule vide ;
  • un patient décédé : data-deceased pour le thème, et une ligne de texte visible, jamais la couleur seule ;
  • aucun champ tronqué, rogné ou masqué, quelle que soit la largeur ; il passe à la ligne.
  • les alertes patient (« Besoin d'un interprète », « Risque infectieux ») forment un tag-group étiqueté de mots, jamais d'icônes ni de couleurs seules, et restent visibles quand le bandeau passe à la ligne.

Résultats

  • Un seul affichage pour un résultat, quel que soit le système dont il provient : la vue d'observation.
  • L'indicateur est en mots issus de votre traduction (flagLabel), avec le code d'interprétation FHIR en data-interpretation pour le thème.
  • Séparez les nouveaux résultats des précédents, et montrez une tendance (une sparkline, ou un graphique en courbes avec son tableau de données) : les cliniciens cherchent un changement significatif, pas seulement l'intervalle.
  • Un résultat jamais renseigné et un résultat indisponible sont deux états différents, avec des mots différents.
  • Inconnu ne veut pas dire normal. Un résultat dont l'intervalle de référence manque, est en cours de chargement ou illisible n'a pas d'interprétation et le dit ; observation-view n'en déduit jamais, si bien qu'un résultat avec un intervalle mais sans interpretation n'affiche aucun indicateur.
  • Un résultat hors échelle est la limite de l'appareil accompagnée d'un comparateur (« > 33,3 mmol/L » : formatQuantity avec ">") et de votre indicateur critique, jamais un nombre seul. Une valeur approchée garde son ≈ ("~").
  • Donnez les autres intervalles nommés (« Critique : inférieur à 2,5 ») sous forme de ranges, chacun dans sa propre partie.
  • Un résultat corrigé ou modifié conserve la valeur qu'il remplace, dans un <del>, avec vos mots pour dire quand il a changé (previousValue, previousLabel), afin qu'un clinicien qui a lu l'ancienne valeur sache qu'elle a changé.
  • Une mesure sur un intervalle indique sa durée et sa fonction (« Moyenne, 24 heures »), et l'état et la méthode d'une mesure (« Assis, grand brassard ») sont un texte visible à côté, jamais seulement une infobulle (openEHR INTERVAL_EVENT, state, protocol).
  • Une tendance exige des points comparables : ne tracez aucune ligne sous votre minimum, coupez la ligne là où la méthode ou le dosage a changé, et dites la direction et le sens avec des mots (« en baisse, amélioration »).
  • Des constantes saisies dans un système d'unités peuvent afficher l'autre à côté, en votre texte (« 70 kg (154 lb) ») ; Lily ne convertit rien, alors indiquez votre arrondi. Saisissez une quantité avec quantity-input-div, dont le nombre suit les limites de chaque unité.
  • Une courbe de croissance est un line-chart avec vos lignes de centiles comme séries, les points de l'enfant et son tableau de données d'âge et de valeur ; Lily ne calcule aucun centile et ne fournit aucune référence de croissance.

Médicaments

  • Les noms génériques en minuscules, sauf les lettres tall man des listes de la FDA et de l'ISMP ou de votre pays (l'Australie et le Canada publient les leurs). Marquez-les dans nameSegments ; Lily ne les devine jamais.
  • Écrivez le dosage avec formatQuantity : pas de zéro final, un zéro initial, une espace insécable avant l'unité.
  • Conservez le comparateur d'un résultat : formatQuantity(5, "mmol/L", locale, "<") écrit « <5 mmol/L ». Le Quantity.comparator de FHIR s'écrit <, ≤, ≥ ou > ; l'omettre transforme « moins de 5 » en « 5 ».
  • Écrivez mL, jamais cc, et évitez toutes les abréviations de la liste des abréviations sources d'erreurs de l'ISMP.
  • Ne tronquez jamais le nom ni la dose d'un médicament.

Dates et heures

  • Écrivez le mois en lettres pour qu'une date ne puisse pas se lire de deux façons (Intl.DateTimeFormat avec month: "short").
  • Choisissez l'horloge délibérément : passez hourCycle explicitement. Le NHS demande l'horloge de 24 heures ; c'est une règle britannique, pas mondiale, donc Lily ne la choisit jamais pour vous.
  • Les âges suivent les tranches de la Common User Interface au moyen de ageParts() ; un service qui suit une autre convention fournit ses propres mots.
  • Une date connue seulement au mois ou à l'année le reste : demandez-la avec date-field precision="month" ou "year", enregistrez 2019-03 ou 2019, et écrivez-la avec formatPartialDate(). N'inventez jamais de jour.
  • Une durée est un duration-view, un <time datetime="P3DT4H"> contenant vos mots, issus de durationParts() et Intl.DurationFormat.

Tableaux de bord

  • Un tableau de service ou un écran de centre de commandement se met souvent à jour. N'annoncez jamais chaque changement : gardez une seule région de synthèse polie (« 3 lits libres, 2 sorties prévues ») et laissez les gens lire le tableau.
  • Chaque état d'un tableau (lit nettoyé, occupé, bloqué) est un texte ou un état data-* accompagné de mots, jamais la couleur seule.
  • Rien ne clignote (WCAG 2.2.2, 2.3.1), et un tableau qui se met à jour selon un minuteur a un bouton de pause ou ne se met à jour qu'à la demande ; les mises à jour ne déplacent jamais le focus. Une entrée en retard le dit en mots (« En attente depuis plus de 20 minutes ») avec data-overdue.
  • Un nombre ou un taux indique son dénominateur (« 12 sur 68 ») et renvoie à la liste qui le sous-tend.
  • Une liste ou une chronologie dit de quoi elle est une vue : ce qu'elle montre, son ordre et sa période, ce qui est masqué et pourquoi, et quelles sources n'ont pas répondu. Une liste vide d'une source qui n'a pas répondu ne prouve pas que rien n'existe.
  • Une liste de rappels est une record-list dont les éléments portent une date d'échéance (review-date) et un état d'échéance en mots, avec data-due ; la règle qui l'a produite est la vôtre.

Formulaires

  • Une question à laquelle on répond « oui », « non » ou « non demandé » est un radio-group de trois réponses, aucune choisie au départ, jamais une case à cocher : une case à cocher ne distingue pas « nié » de « jamais demandé ». Un examen par appareils est un fieldset par appareil, et un bouton « tous les autres absents » ne règle que ceux qui n'ont pas de réponse.
  • Une question à plusieurs réponses (médicaments, adresses) est un repeatable-fieldset : on ajoute ou retire un élément, le focus suit, et chaque bouton de retrait est nommé d'après son élément.
  • Un nombre avec une virgule décimale : affichez-le avec Intl.NumberFormat et, là où type="number" n'accepte pas la virgule, saisissez-le dans un champ texte avec inputmode="decimal" et analysez-le dans votre code. Ne modifiez jamais une valeur saisie par la personne, même pour la ramener dans un intervalle : une valeur hors intervalle est une erreur qu'elle peut voir.
  • Une longue liste qui n'affiche qu'une partie de ses options à la fois définit aria-setsize et aria-posinset sur chaque option, et rappelle que la recherche dans la page ne voit pas le reste.

Dossiers, notes et leur provenance

  • Dites de quoi une liste ou une grille est une vue, avant ses lignes : sa période et son ordre, ce qu'elle omet et pourquoi, et quelles sources n'ont pas répondu (« 12 derniers mois, du plus récent au plus ancien. Le dossier du médecin traitant n'a pas répondu. »). Donnez à record-list et à timeline-list un coverageLabel, et à l'assistant data-grid son coverageLabel. Une liste vide issue d'une source qui n'a pas répondu le dit en mots, afin de n'être jamais lue comme « rien d'enregistré ».
  • Dites d'où vient un dossier et s'il est définitif avec record-provenance-view : signé, en attente de signature, modifié, enregistré sur cet appareil et pas encore envoyé. Un brouillon non signé ne doit jamais paraître signé.
  • Une entrée qui concerne quelqu'un d'autre (un parent, un fœtus, un donneur) dit d'abord à qui elle se rapporte, avec le subjectLabel.
  • Une entrée masquée reste dans la liste avec vos mots (« Restreint : non accessible pour vous »), et une entrée saisie par erreur reste barrée avec « Saisi par erreur » : donnez à record-list-item ou timeline-list-item un entryState et un entryStateLabel. Ne retirez jamais l'une ou l'autre en silence, car un trou se lit « rien ne s'est passé ».
  • Dans une note clinique, indiquez la source de chaque passage (saisi, dicté, modèle, recopié, généré) avec data-source et des mots visibles, afin qu'un texte recopié ou généré ne soit jamais pris pour l'examen du jour.
  • Une section qui ne peut pas se charger est unavailable en vos mots, avec un bouton pour réessayer ; un code technique, s'il est montré, se trouve derrière un dévoilement. Un échec causé par l'action d'une personne est annoncé, avec la valeur que le dossier contient désormais ; un échec au chargement de la page ne l'est pas.
  • L'historique d'une prescription est une timeline-list, un élément par étape (prévue, planifiée, active, suspendue, terminée, annulée) avec son heure et son motif, et l'état actuel aussi sur l'élément.

De FHIR à Lily

Lily ne lit pas les ressources FHIR ; votre code les met en correspondance avec les props de Lily. Ces tableaux traitent le HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). La correspondance des codes est une suggestion : votre revue de sécurité clinique la tranche, et les mots de chaque état sont les vôtres.

Sections de l'IPS et composants Lily correspondants
Section de l'IPS Lily
Allergies et intolérances (48765-2) allergy-record-list et ses éléments
Résumé des médicaments (10160-0) medication-record-list, chaque élément contenant un medication-view
Liste des problèmes (11450-4) problem-record-list et ses éléments
Vaccinations (11369-6) immunization-record-list et ses éléments
Résultats (30954-2) observation-view, dans un tableau de données ou une liste récapitulative
Antécédents d'interventions (47519-4) procedure-record-list et ses éléments
Dispositifs médicaux (46264-8) device-record-list et ses éléments
Alertes (104605-1) Un texte d'avertissement ou une alerte, jamais derrière un contrôle replié
Toute autre section record-list et ses éléments
Une section obligatoire que le document omet La liste de la section avec status="omitted"
Codes FHIR et valeurs Lily correspondantes
FHIR Lily
emptyReason nilknown Le status="none-known" de la liste
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", avec des mots qui précisent lequel
Les codes IPS no-known-allergies, no-known-medications et autres semblables status="none-known"
Les codes IPS no-allergy-info, no-medication-info et autres semblables status="not-recorded"
AllergyIntolerance.criticality criticality, distinct du severity d'une réaction
clinicalStatus, verificationStatus Les mêmes props sur les éléments d'allergie et de problème, avec les mêmes codes
MedicationStatement.status Le status de l'élément de médicament
Dosage.text medication-view dosageText
Observation.status observation-view status, avec les mêmes codes
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (aussi sur les listes de dossiers)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

Faites correspondre un enregistrement entered-in-error à son statut entered-in-error, avec des mots, plutôt que de l'écarter silencieusement : l'afficher ou non relève de la décision de votre service.

D'openEHR à Lily

Lily ne lit pas non plus les compositions openEHR. La correspondance pour les types de données et codes du modèle de référence openEHR, comme une suggestion que tranche votre revue de sécurité clinique :

Types de données et codes openEHR, et les valeurs Lily correspondantes
openEHR Lily
DV_QUANTITY (saisie) quantity-input-div ; unités en codes UCUM avec vos mots
DV_QUANTITY (affichage), magnitude_status observation-view avec formatQuantity(value, unit, locale, comparator) (~ vaut ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation : FHIR HU, HH, H, L, LL, LU
other_reference_ranges avec un meaning observation-view ranges
DV_DATE partielle (année, année et mois) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view avec durationParts()
DV_PROPORTION formatProportion() dans observation-view
DV_ORDINAL, DV_SCALE un radio-group dont les étiquettes portent le nombre et ses mots
DV_CODED_TEXT le modèle des valeurs codées ci-dessous
DV_BOOLEAN checkbox-input, seulement quand « non demandé » ne peut pas arriver
ELEMENT.null_flavour 253 inconnu, 271 aucune information status="not-recorded" ou "unavailable", avec des mots qui précisent lequel
null_flavour 272 masqué observation-view status="masked"
null_flavour 273 sans objet status="not-applicable"
PARTY_RELATED sujet subjectLabel sur les éléments du dossier
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
Étapes de l'automate d'état des instructions une timeline-list d'étapes, avec l'état actuel sur l'élément
un élément d'archétype d'occurrences 0..* repeatable-fieldset

Valeurs codées

  • Affichez Coding.display ; à défaut, CodeableConcept.text ; à défaut des deux, system|code. Jamais une cellule vide.
  • Proposez un contrôle qui révèle le système de codage et le code à côté de chaque valeur, par exemple un bouton à bascule qui dit « Afficher les codes ». Les codes masqués restent hors de l'ordre de lecture tant qu'ils ne sont pas affichés.
  • Marquez le texte clinique avec la langue du document (lang), qui peut différer de celle de l'interface. Traduisez l'interface ; ne traduisez jamais le contenu clinique.
  • Lily ne fournit aucune terminologie : aucune consultation de SNOMED CT, LOINC, ATC ou UCUM. Écrivez ce que dit le document. La page /patient-summary de l'exemple SvelteKit montre le modèle.

Ce que Lily ne fera pas

  • Calculer un score d'alerte précoce, un percentile de croissance, une dose ou un intervalle de référence.
  • Fournir une base de données de médicaments, une liste tall man, ou des codes SNOMED CT, CIM, LOINC ou UCUM.
  • Reproduire un instrument sous licence (Wong-Baker FACES) ou la conception d'un autre organisme (le tableau NEWS2).
  • Limiter le nombre de dossiers ouverts en même temps.
  • Déduire une interprétation d'un intervalle, convertir une unité ou analyser une date relative (« mardi prochain »).
  • Utiliser un interrupteur pour « oui, non ou inconnu » : le switch d'ARIA n'a pas de troisième état, il faut donc trois boutons radio.

Les recherches, les sources et les décisions derrière ce guide se trouvent dans spec/healthcare-ui.