ממשקי משתמש לבריאות
מדריך לצוותים הבונים תוכנה קלינית עם Lily: פורטלים קליניים, תוצאות ודיווח, מתן מרשמים ומתן תרופות, תמיכה בהחלטות ולוחות מחוונים בבתי חולים.
תרגומים של עמוד זה הם טיוטות מכונה שלא נבדקו. העמוד באנגלית הוא הגרסה המחייבת.
מה Lily עושה ומה היא אינה עושה
Lily מספקת חוזי תצוגה: סימון סמנטי, ARIA, התנהגות מקלדת ווי מחלקות לדברים שמסכים קליניים חוזרים עליהם. היא אינה מספקת לוגיקה קלינית, תוכן קליני או הצהרה רגולטורית.
| 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("אם"), כדי שאבחנה של קרוב משפחה לא תיקרא לעולם כאבחנה של המטופל (openEHRPARTY_RELATED, FHIRFamilyMemberHistory). - אל תגבילו כמה רשומות רופא רשאי לפתוח: ניסוי אקראי עם 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-fieldprecision="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-listcoverageLabel, ולעזרdata-gridאתcoverageLabelשלו. רשימה ריקה ממקור שלא ענה אומרת זאת במילים, כדי שלא תיקרא לעולם כ"לא תועד דבר". -
אמרו מאין הגיעה רשומה והאם היא סופית באמצעות
record-provenance-view: חתומה, ממתינה לחתימה, תוקנה, נשמרה במכשיר זה ועדיין לא נשלחה. טיוטה לא חתומה לעולם לא צריכה להיראות חתומה. - רשומה על מישהו אחר (הורה, עובר, תורם) אומרת קודם של מי היא, באמצעות
subjectLabel. -
רשומה מוסתרת נשארת ברשימה עם המילים שלכם ("מוגבל: לא זמין עבורך"), ורשומה שהוזנה בטעות נשארת מחוקה בקו עם "הוזן בטעות": תנו ל-
record-list-itemאו ל-timeline-list-itementryStateו-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 |
|---|---|
אלרגיות ואי-סבילויות (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 |
|---|---|
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 |
|---|---|
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.