واجهات المستخدم للرعاية الصحية

دليل للفرق التي تبني برمجيات سريرية باستخدام Lily: البوابات السريرية، والنتائج والتقارير، ووصف الأدوية وإعطاؤها، ودعم القرار، ولوحات معلومات المستشفى.

هذه الترجمة مسودة آلية غير مراجعة. الصفحة الإنجليزية هي النسخة المعتمدة.

ما تقدمه Lily وما لا تقدمه

تقدم لك Lily عقود عرض: ترميزًا دلاليًا، وسمات ARIA، وسلوك لوحة المفاتيح، وفئات CSS للعناصر التي تتكرر في الشاشات السريرية. ولا تقدم منطقًا سريريًا ولا محتوى سريريًا ولا ادعاءً تنظيميًا.

ما تقدمه 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.
  • أزل البطاقة عندما يتكرر الحدث الذي ردّت عليه، وسجّل كل نتيجة (مقبولة، أو متجاوَزة مع سببها).

أخطاء المريض الخطأ: عرّف ولا تقيّد

  • اعرض معرّفين حيثما ظهرت بيانات المريض: الاسم مع تاريخ الميلاد، والمعرّف الوطني مع مكوّن العرض الخاص به (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 للسمة.
  • افصل النتائج الجديدة عن السابقة، واعرض الاتجاه (مخططًا مصغّرًا، أو مخططًا خطيًا مع جدول بياناته): يبحث الأطباء عن تغيّر مهم، لا عن النطاق فقط.
  • النتيجة التي لم تُسجَّل قط والنتيجة غير المتاحة حالتان مختلفتان، بكلمات مختلفة.
  • المجهول ليس طبيعيًا. النتيجة التي ينقصها نطاقها المرجعي أو ما زالت تُحمَّل أو لا يمكن قراءتها لا تفسير لها وتقول ذلك؛ 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 نظام الأربع والعشرين ساعة؛ وهذه قاعدة بريطانية لا عالمية، لذا لا تختاره Lily نيابةً عنك.
  • تتبع الأعمار شرائح Common User Interface عبر ageParts()؛ والخدمة ذات العُرف المختلف تمرر كلماتها الخاصة.
  • التاريخ المعروف حتى الشهر أو السنة فقط يبقى كذلك: اطلبه باستخدام date-field precision="month" أو "year"، واحفظه 2019-03 أو 2019، واكتبه باستخدام formatPartialDate(). لا تختلق يومًا أبدًا.
  • المدة هي duration-view، أي <time datetime="P3DT4H"> يحمل كلماتك، من durationParts() و Intl.DurationFormat.

لوحات المعلومات

  • لوحة الجناح أو شاشة مركز القيادة تتحدث كثيرًا. لا تُعلن كل تغيير أبدًا: أبقِ منطقة ملخص مهذبة واحدة («3 أسرّة شاغرة، وخروج مريضين مرتقب») ودع الناس يقرؤون اللوحة.
  • كل حالة على اللوحة (سرير نظيف، مشغول، محجوب) نص أو حالة 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 الخصائص نفسها في عناصر الحساسية والمشكلة، مع الرموز نفسها
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.