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.
| 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 proposezoverrideReasonspour 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 (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - 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
subjectLabelsurcontext-menuoudropdown-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-dialogdont 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-deceasedpour 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 endata-interpretationpour 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-viewn'en déduit jamais, si bien qu'un résultat avec un intervalle mais sansinterpretationn'affiche aucun indicateur. -
Un résultat hors échelle est la limite de l'appareil accompagnée d'un comparateur (« > 33,3 mmol/L » :
formatQuantityavec">") 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-chartavec 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 ». LeQuantity.comparatorde 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.DateTimeFormatavecmonth: "short"). - Choisissez l'horloge délibérément : passez
hourCycleexplicitement. 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-fieldprecision="month"ou"year", enregistrez2019-03ou2019, et écrivez-la avecformatPartialDate(). N'inventez jamais de jour. -
Une durée est un
duration-view, un<time datetime="P3DT4H">contenant vos mots, issus dedurationParts()etIntl.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-listdont les éléments portent une date d'échéance (review-date) et un état d'échéance en mots, avecdata-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-groupde 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 unfieldsetpar 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.NumberFormatet, là oùtype="number"n'accepte pas la virgule, saisissez-le dans un champ texte avecinputmode="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-setsizeetaria-posinsetsur 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-listet àtimeline-listuncoverageLabel, et à l'assistantdata-gridsoncoverageLabel. 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-itemoutimeline-list-itemunentryStateet unentryStateLabel. 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-sourceet 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
unavailableen 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.
| 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" |
| 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 :
| 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-summaryde 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
switchd'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.