ממשקי משתמש לבריאות

מדריך לצוותים הבונים תוכנה קלינית עם Lily: פורטלים קליניים, תוצאות ודיווח, מתן מרשמים ומתן תרופות, תמיכה בהחלטות ולוחות מחוונים בבתי חולים.

תרגומים של עמוד זה הם טיוטות מכונה שלא נבדקו. העמוד באנגלית הוא הגרסה המחייבת.

מה Lily עושה ומה היא אינה עושה

Lily מספקת חוזי תצוגה: סימון סמנטי, ARIA, התנהגות מקלדת ווי מחלקות לדברים שמסכים קליניים חוזרים עליהם. היא אינה מספקת לוגיקה קלינית, תוכן קליני או הצהרה רגולטורית.

מה Lily מספקת ומה אתם מספקים
Lily מספקת אתם מספקים
observation-view: ערך, יחידה, דגל במילים, טווח ומצבי היעדר נתון הערך, ההחלטה על הדגל, טווח הייחוס
allergy-record-list ו-allergy-record-list-item: סטטוס שאינו ריק לעולם רשומת האלרגיה והטרמינולוגיה שלה
medication-view: שם, עוצמה, צורה, דרך מתן ותדירות, ללא קיצור כלשהו נתוני התרופה, מקטעי ה-tall man, העוצמה המעוצבת
decision-support-card: מבנה הכרטיס של CDS Hooks הכללים, פעולות ההצעה, תיעוד התוצאה
early-warning-score-view: ציון, פס והסלמה, מוצגים שיטת הניקוד והחישוב המאומת שלה
age-view ו-ageParts(): גיל ביחידות המתאימות לו המילים ליחידות (Intl.DurationFormat או התוויות שלכם)
formatQuantity(): 5 mg, לעולם לא 5.0 mg; 0.5 mg, לעולם לא .5 mg המספר, היחידה והלוקאל
הרכב כותרת המטופל כל תווית וכל ערך, ומי רשאי לראות מידע קליני

רגולציה. תוכנה שמחשבת ציון, אחוזון, מינון או אינטראקציה בין תרופות היא בדרך כלל מכשיר רפואי. Lily אינה מחשבת אף אחד מאלה, במכוון. אם המוצר שלכם מוסדר, תיק הנדסת השימושיות שלו הוא באחריותכם (IEC 62366-1, הנחיות הגורמים האנושיים של ה-FDA, EU MDR). הבדיקות של Lily, דוח ההתאמה לנגישות שהיא העריכה בעצמה ומטריצת קוראי המסך שלה יכולים לשמש ראיה בתיק זה; אף אחד מהם אינו הצהרת התאמה, ובמטריצה עדיין אין תוצאות.

התראות: להפריע רק במה שקריטי

עייפות מהתראות היא בעיית בטיחות: כשכל התראה מפריעה, אנשים דוחים את כולן. ההנחיה של AHRQ היא לדרג התראות לפי חומרה ולהפוך רק את החמורות למפריעות.

  • מידע (indicator="info"): בתוך הדף, לצד המשימה, כרטיס תמיכה בהחלטות בעמוד.
  • אזהרה (indicator="warning"): גלויה בלי לחסום, אותו כרטיס, מעוצב כך שיבלוט; בלי מודאל.
  • קריטי (indicator="critical"): הציבו את הכרטיס בתוך דיאלוג התראה, והציעו overrideReasons כך שסגירתו תדרוש סיבה.
  • כרטיס תמיכה בהחלטות אינו אזור חי בפני עצמו לעולם. הכריזו על כרטיס קריטי חדש על ידי העברת המיקוד אל הדיאלוג, לא באמצעות aria-live.
  • הסירו כרטיס כשהאירוע שהוא ענה עליו קורה שוב, ותעדו כל תוצאה (התקבל, או נדחה עם הסיבה).

טעויות בזיהוי מטופל: לזהות, לא להגביל

  • הציגו שני מזהים בכל מקום שבו מופיעים נתוני מטופל: השם יחד עם תאריך הלידה, והמזהה הלאומי עם רכיב ה-view שלו (The Joint Commission, Quick Safety 45).
  • השתמשו בכותרת המטופל בכל מסך הפועל על רשומה של מטופל אחד, והשאירו אותה גלויה.
  • לפני פעולה על רשומה שאינה זו שבכותרת, אשרו אותה עם השם, תאריך הלידה והמזהה.
  • רשומה על מישהו אחר מלבד המטופל (היסטוריה של הורה, עובר, תורם) אומרת קודם במילים של מי היא: תנו לפריטי הרשומה subjectLabel ("אם"), כדי שאבחנה של קרוב משפחה לא תיקרא לעולם כאבחנה של המטופל (openEHR PARTY_RELATED, FHIR FamilyMemberHistory).
  • אל תגבילו כמה רשומות רופא רשאי לפתוח: ניסוי אקראי עם 3,356 רופאים (JAMA, 2019) מצא שההגבלה לא הפחיתה הזמנות למטופל הלא נכון, ואנשים עוקפים אותה.
  • תפריט פעולות על רשומה אחת מציין קודם את הרשומה, באמצעות subjectLabel על context-menu או dropdown-menu ("Ada Lovelace, לחץ דם 3 בנוב׳"): חלק ראשון לא אינטראקטיבי שהוא גם השם הנגיש של התפריט.
  • סווגו כל פעולה לפי מה שהיא עושה, והציגו את הרמה לפני שהיא מתבצעת. שגרתית (הצגה, הדפסה) מתבצעת מיד. מתועדת אומרת מה תכתוב ברשומה ("מוסיפה הערה לביקור"). קלינית (הפסקה, ביטול הוראה) שואלת פעם שנייה, בתוך alert-dialog שכפתור האישור שלו הוא הפועל ("הפסק"), לעולם לא "אישור" או "כן". חושפת (גישת חירום, שיתוף מחוץ לצוות המטפל) מבקשת קודם סיבה ומתעדת אותה.
  • כשכמה רשומות פתוחות (כרטיסיות, חלונות, חלוניות מפוצלות), הטקסט הנראה והשם הנגיש של כל כרטיסייה כוללים את שם המטופל ומזהה שני, החלונית הפעילה חוזרת על הבאנר, ושום פעולה אינה חלה על מטופל שאינו המטופל של החלונית שלה.
  • הציגו את המקום שאליו ישויכו הרשומות (המחלקה, המרפאה או המוסד שנבחרו בכניסה) כטקסט בכותרת העמוד, והפכו את שינויו לפעולה מפורשת.
  • הציגו את הביקור הפעיל, או "אין ביקור פעיל", בבאנר. טופס שזקוק לביקור אומר זאת ומציע לפתוח אחד, במקום להיכשל בעת השמירה.

כותרת המטופל

ההרכב מתועד עם medical-banner, ועם עמוד עובד בכתובת /patient-banner באפליקציית הדוגמה של SvelteKit:

  • שני מזהים, והגיל לצד תאריך הלידה;
  • אלרגיות דרך רשימת אלרגיות, כך ש“אין אלרגיות ידועות”, “לא תועד” ו“לא זמין” לעולם לא ייראו אותו דבר;
  • ערך חסר הוא מילים (“לא ידוע”), לעולם לא סימן שאלה, מקף או תא ריק;
  • מטופל שנפטר: data-deceased עבור ערכת העיצוב, ושורת טקסט גלויה, לעולם לא צבע בלבד;
  • אף שדה אינו מקוצר, חתוך או מוסתר בשום רוחב; הוא עובר לשורה הבאה.
  • סימוני מטופל ("זקוק למתורגמן", "סיכון לזיהום") הם tag-group מתויגת של מילים, לעולם לא סמלים או צבע בלבד, ונשארים גלויים כשהבאנר נשבר לשורות.

תוצאות

  • תצוגה אחת לתוצאה, מכל מערכת שבאה: תצוגת התצפית.
  • הדגל הוא מילים מהתרגום שלכם (flagLabel), עם קוד הפרשנות של FHIR כ-data-interpretation עבור ערכת העיצוב.
  • הפרידו תוצאות חדשות מקודמות והציגו מגמה (sparkline, או תרשים קווי עם טבלת הנתונים שלו): רופאים מחפשים שינוי משמעותי, לא רק את הטווח.
  • תוצאה שמעולם לא תועדה ותוצאה שאינה זמינה הן מצבים שונים, עם מילים שונות.
  • לא ידוע אינו תקין. תוצאה שטווח הייחוס שלה חסר, עדיין נטען או אינו קריא אין לה פירוש והיא אומרת זאת; observation-view לעולם לא מסיק פירוש, ולכן תוצאה עם טווח וללא interpretation אינה מציגה סימון.
  • תוצאה מחוץ לסקאלה היא גבול המכשיר עם סימן השוואה ("> 33.3 mmol/L": formatQuantity עם ">") והסימון הקריטי שלכם, לעולם לא מספר חשוף. ערך משוער שומר על ה-≈ שלו ("~").
  • תנו טווחים נוספים בעלי שם ("קריטי: מתחת ל-2.5") כ- ranges, כל אחד כחלק נפרד.
  • תוצאה מתוקנת או משונה שומרת את הערך שהחליפה, בתוך <del>, עם המילים שלכם על מתי השתנתה (previousValue, previousLabel), כדי שקלינאי שקרא את הערך הישן יידע שהוא השתנה.
  • מדידת מרווח אומרת את הרוחב והפונקציה שלה ("ממוצע, 24 שעות"), ומצב המדידה ושיטתה ("בישיבה, שרוול גדול") הם טקסט נראה לצידה, לעולם לא רק תיאור צץ (openEHR INTERVAL_EVENT, state, protocol).
  • מגמה צריכה נקודות ברות השוואה: אל תציירו קו מתחת למינימום שלכם, קטעו את הקו היכן שהשיטה או הבדיקה השתנתה, ואמרו כיוון ומשמעות במילים ("יורד, משתפר").
  • סימנים חיוניים שהוזנו במערכת יחידות אחת יכולים להציג את האחרת לצידם כטקסט שלכם ("70 kg (154 lb)"); Lily לא ממירה דבר, לכן ציינו את העיגול שלכם. הזינו כמות באמצעות quantity-input-div, שהמספר שלו מקבל את הגבולות של כל יחידה.
  • עקומת גדילה היא line-chart עם קווי האחוזונים שלכם כסדרות, הנקודות של הילד וטבלת הנתונים של גיל וערך; Lily לא מחשבת אחוזון ולא מספקת ייחוס גדילה.

תרופות

  • שמות גנריים באותיות קטנות, פרט לאותיות tall man מרשימות ה-FDA וה-ISMP או מרשימות המדינה שלכם (אוסטרליה וקנדה מפרסמות רשימות משלהן). סמנו אותן ב-nameSegments; Lily לעולם לא מנחשת אותן.
  • כתבו את העוצמה עם formatQuantity: בלי אפס בסוף, עם אפס בהתחלה, ורווח בלתי שביר לפני היחידה.
  • שמרו את סימן ההשוואה של תוצאה: formatQuantity(5, "mmol/L", locale, "<") כותב “<5 mmol/L”. Quantity.comparator של FHIR נכתב <, ≤, ≥ או >; השמטתו הופכת “פחות מ-5” ל-“5”.
  • כתבו mL, לעולם לא cc, והימנעו מכל קיצור שנמצא ברשימת הקיצורים הנוטים לטעויות של ISMP.
  • לעולם אל תקצרו שם תרופה או מינון.

תאריכים ושעות

  • כתבו את החודש כטקסט כדי שאי אפשר יהיה לקרוא תאריך בשתי דרכים (Intl.DateTimeFormat עם month: "short").
  • בחרו את השעון במכוון: העבירו hourCycle במפורש. ה-NHS דורש שעון של 24 שעות; זה כלל בריטי, לא עולמי, ולכן Lily לעולם לא בוחרת אותו עבורכם.
  • גילאים עוקבים אחר פסי Common User Interface באמצעות ageParts(); שירות עם מוסכמה אחרת מעביר את המילים שלו.
  • תאריך שידוע רק עד החודש או השנה נשאר כך: בקשו אותו באמצעות date-field precision="month" או "year", שמרו 2019-03 או 2019, וכתבו אותו באמצעות formatPartialDate(). לעולם אל תמציאו יום.
  • משך זמן הוא duration-view, כלומר <time datetime="P3DT4H"> שמכיל את המילים שלכם, מתוך durationParts() ו- Intl.DurationFormat.

לוחות מחוונים

  • לוח מחלקה או מסך מרכז שליטה מתעדכנים לעיתים קרובות. לעולם אל תכריזו על כל שינוי: שמרו אזור סיכום מנומס אחד (“3 מיטות פנויות, 2 שחרורים צפויים”) ותנו לאנשים לקרוא את הלוח.
  • כל מצב בלוח (מיטה נקייה, תפוסה, חסומה) הוא טקסט או מצב data-* עם מילים, לעולם לא צבע בלבד.
  • שום דבר לא מהבהב (WCAG 2.2.2, 2.3.1), ולוח שמתעדכן לפי טיימר כולל פקד השהיה או מתעדכן רק לפי בקשה; עדכונים לעולם לא מזיזים את המיקוד. רשומה שעבר זמנה אומרת זאת במילים ("ממתין יותר מ-20 דקות") עם data-overdue.
  • ספירה או שיעור מציגים את המכנה שלהם ("12 מתוך 68") ומקשרים לרשימה שמאחוריהם.
  • רשימה או ציר זמן אומרים ממה הם תצוגה: מה הם מציגים, הסדר וחלון הזמן, מה מוסתר ולמה, ואילו מקורות לא ענו. רשימה ריקה ממקור שלא ענה אינה הוכחה שאין דבר.
  • רשימת תזכורות היא record-list שפריטיה נושאים תאריך יעד (review-date) ומצב יעד במילים, עם data-due; הכלל שיצר אותה הוא שלכם.

טפסים

  • שאלה שעונים עליה "כן", "לא" או "לא נשאל" היא radio-group של שלוש תשובות, אף אחת לא נבחרת בהתחלה, לעולם לא תיבת סימון: תיבת סימון לא יכולה להבחין בין "שלל" לבין "מעולם לא נשאל". סקירת מערכות היא fieldset אחד לכל מערכת בגוף, וכפתור "כל השאר חסרים" מגדיר רק את אלה שלא נענו.
  • שאלה עם רשימת תשובות (תרופות, כתובות) היא repeatable-fieldset: פריט מתווסף או מוסר, המיקוד עוקב, וכל כפתור הסרה נקרא על שם הפריט שלו.
  • מספר עם פסיק עשרוני: הציגו אותו באמצעות Intl.NumberFormat ו, היכן ש- type="number" לא מקבל את הפסיק, קבלו אותו בשדה טקסט עם inputmode="decimal" ונתחו אותו בקוד שלכם. לעולם אל תשנו ערך שאדם הקליד, גם לא כדי לתחום אותו בטווח: ערך מחוץ לטווח הוא שגיאה שהוא יכול לראות.
  • רשימה ארוכה שמציגה רק חלק מהאפשרויות בכל פעם מגדירה aria-setsize ו- aria-posinset על כל אפשרות, וזוכרת שחיפוש בעמוד לא רואה את השאר.

רשומות, הערות ומקורן

  • אמרו ממה רשימה או רשת היא תצוגה, לפני השורות: חלון הזמן והסדר, מה הושמט ולמה, ואילו מקורות לא ענו ("12 החודשים האחרונים, החדש קודם. רשומת רופא המשפחה לא ענתה."). תנו ל- record-list ול- timeline-list coverageLabel, ולעזר data-grid את coverageLabelשלו. רשימה ריקה ממקור שלא ענה אומרת זאת במילים, כדי שלא תיקרא לעולם כ"לא תועד דבר".
  • אמרו מאין הגיעה רשומה והאם היא סופית באמצעות record-provenance-view: חתומה, ממתינה לחתימה, תוקנה, נשמרה במכשיר זה ועדיין לא נשלחה. טיוטה לא חתומה לעולם לא צריכה להיראות חתומה.
  • רשומה על מישהו אחר (הורה, עובר, תורם) אומרת קודם של מי היא, באמצעות subjectLabel.
  • רשומה מוסתרת נשארת ברשימה עם המילים שלכם ("מוגבל: לא זמין עבורך"), ורשומה שהוזנה בטעות נשארת מחוקה בקו עם "הוזן בטעות": תנו ל- record-list-item או ל- timeline-list-item entryState ו- entryStateLabel. לעולם אל תסירו אף אחת מהן בשקט, כי פער נקרא כ"לא קרה דבר".
  • בהערה קלינית, סמנו את מקור כל קטע (הוקלד, הוכתב, תבנית, הועתק קדימה, נוצר) באמצעות data-source ומילים נראות, כדי שטקסט מועתק או שנוצר לעולם לא ייחשב לבדיקה של היום.
  • מקטע שאינו נטען הוא unavailable במילים שלכם, עם כפתור ניסיון חוזר; קוד טכני, אם מוצג בכלל, נמצא מאחורי חשיפה. כשל שנגרם מפעולה של אדם מוכרז, עם הערך שהרשומה מחזיקה כעת; כשל בטעינת העמוד לא.
  • ההיסטוריה של הוראה היא timeline-list, פריט אחד לכל שלב (מתוכנן, מתוזמן, פעיל, מושהה, הושלם, בוטל) עם השעה והסיבה, והמצב הנוכחי גם על הפריט.

מ-FHIR ל-Lily

Lily אינה קוראת משאבי FHIR; הקוד שלכם ממפה אותם ל-props של Lily. הטבלאות האלה ממפות את HL7 FHIR International Patient Summary (IPS 2.0.1, FHIR R4). מיפוי הקודים הוא הצעה: סקירת הבטיחות הקלינית שלכם מכריעה בו, והמילים לכל מצב הן שלכם.

מקטעי IPS ורכיבי Lily שלהם
מקטע IPS Lily
אלרגיות ואי-סבילויות (48765-2) allergy-record-list והפריטים שלה
סיכום תרופות (10160-0) medication-record-list, כאשר כל פריט מכיל medication-view
רשימת בעיות (11450-4) problem-record-list והפריטים שלה
חיסונים (11369-6) immunization-record-list והפריטים שלה
תוצאות (30954-2) observation-view, בטבלת נתונים או ברשימת סיכום
היסטוריית פרוצדורות (47519-4) procedure-record-list והפריטים שלה
מכשירים רפואיים (46264-8) device-record-list והפריטים שלה
התראות (104605-1) טקסט אזהרה או התראה, לעולם לא מאחורי פקד מכווץ
כל מקטע אחר record-list והפריטים שלה
מקטע נדרש שהמסמך משמיט רשימת המקטע עם status="omitted"
קודי FHIR וערכי Lily שלהם
FHIR Lily
emptyReason nilknown הרשימה עם status="none-known"
emptyReason notasked, notstarted status="not-recorded"
emptyReason unavailable, withheld, closed status="unavailable", עם מילים שאומרות איזה
קודי IPS no-known-allergies, no-known-medications וכדומה status="none-known"
קודי IPS no-allergy-info, no-medication-info וכדומה status="not-recorded"
AllergyIntolerance.criticality criticality, בנפרד מתגובה severity
clinicalStatus, verificationStatus אותם props בפריטי האלרגיה והבעיה, עם אותם קודים
MedicationStatement.status פריט התרופה: status
Dosage.text medication-view dosageText
Observation.status observation-view status, עם אותם קודים
Observation.dataAbsentReason masked status="masked"
dataAbsentReason not-applicable status="not-applicable" (גם ברשימות הרשומות)
Quantity.comparator formatQuantity(value, unit, locale, comparator)

מפו רשומה עם הסטטוס entered-in-error לסטטוס entered-in-error, עם מילים, במקום להשמיט אותה בשקט: אם להציג אותה בכלל היא החלטה של השירות שלכם.

מ-openEHR ל-Lily

Lily גם אינה קוראת קומפוזיציות של openEHR. המיפוי לסוגי הנתונים ולקודים של מודל הייחוס של openEHR, כהצעה שסקירת הבטיחות הקלינית שלכם מחליטה עליה:

סוגי נתונים וקודים של openEHR, וערכי Lily המתאימים להם
openEHR Lily
DV_QUANTITY (הזנה) quantity-input-div; יחידות כקודי UCUM עם המילים שלכם
DV_QUANTITY (תצוגה), magnitude_status observation-view עם formatQuantity(value, unit, locale, comparator) (~ הוא ≈)
DV_ORDERED.normal_status HHH, HH, H, L, LL, LLL observation-view interpretation: FHIR HU, HH, H, L, LL, LU
other_reference_ranges עם meaning observation-view ranges
DV_DATE חלקי (שנה, שנה וחודש) date-field precision; formatPartialDate(); date-time-view
DV_DURATION duration-view עם durationParts()
DV_PROPORTION formatProportion() בתוך observation-view
DV_ORDINAL, DV_SCALE radio-group שהתוויות שלו נושאות את המספר ואת מילותיו
DV_CODED_TEXT תבנית הערכים המקודדים בהמשך
DV_BOOLEAN checkbox-input, רק כש"לא נשאל" לא יכול לקרות
ELEMENT.null_flavour 253 לא ידוע, 271 אין מידע status="not-recorded" או "unavailable", עם מילים שאומרות איזה
null_flavour 272 מוסתר observation-view status="masked"
null_flavour 273 לא רלוונטי status="not-applicable"
PARTY_RELATED נושא subjectLabel על פריטי הרשומה
AUDIT_DETAILS, ATTESTATION, FEEDER_AUDIT record-provenance-view
שלבי מכונת המצבים של ההוראות timeline-list של שלבים, עם המצב הנוכחי על הפריט
פריט ארכיטיפ עם מופעים 0..* repeatable-fieldset

ערכים מקודדים

  • הציגו Coding.display; אם אין, CodeableConcept.text; אם אין אף אחד מהם, system|code. לעולם לא תא ריק.
  • הציעו פקד שחושף את מערכת הקודים ואת הקוד לצד כל ערך, כגון לחצן החלפה שאומר “הצג קודים”. קודים מוסתרים נשארים מחוץ לסדר הקריאה עד שהם מוצגים.
  • סמנו טקסט קליני בשפת המסמך (lang), שעשויה להיות שונה משפת הממשק. תרגמו את הממשק; לעולם אל תתרגמו את התוכן הקליני.
  • Lily אינה מספקת טרמינולוגיה: אין חיפושי SNOMED CT, LOINC, ATC או UCUM. כתבו את מה שהמסמך אומר. הדף /patient-summary בדוגמת SvelteKit מציג את התבנית.

מה Lily לא תעשה

  • לחשב ציון התראה מוקדמת, אחוזון גדילה, מינון או טווח ייחוס.
  • לספק מסד נתוני תרופות, רשימת tall man, או קודי SNOMED CT, ICD, LOINC או UCUM.
  • לשחזר מכשיר מדידה בעל רישיון (Wong-Baker FACES) או עיצוב של גוף אחר (תרשים NEWS2).
  • להגביל את מספר הרשומות הפתוחות בו-זמנית.
  • להסיק פירוש מטווח, להמיר יחידה, או לנתח תאריך יחסי ("ביום שלישי הבא").
  • להשתמש במתג עבור "כן, לא או לא ידוע": switch של ARIA אין מצב שלישי, לכן אלה שלושה כפתורי בחירה.

המחקר, המקורות וההחלטות שמאחורי מדריך זה נמצאים ב-spec/healthcare-ui.