واجهات المستخدم للرعاية الصحية
دليل للفرق التي تبني برمجيات سريرية باستخدام Lily: البوابات السريرية، والنتائج والتقارير، ووصف الأدوية وإعطاؤها، ودعم القرار، ولوحات معلومات المستشفى.
هذه الترجمة مسودة آلية غير مراجعة. الصفحة الإنجليزية هي النسخة المعتمدة.
ما تقدمه Lily وما لا تقدمه
تقدم لك Lily عقود عرض: ترميزًا دلاليًا، وسمات ARIA، وسلوك لوحة المفاتيح، وفئات CSS للعناصر التي تتكرر في الشاشات السريرية. ولا تقدم منطقًا سريريًا ولا محتوى سريريًا ولا ادعاءً تنظيميًا.
| تقدم 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(«الأم»)، كي لا يُقرأ تشخيص قريب أبدًا على أنه تشخيص المريض (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للسمة. - افصل النتائج الجديدة عن السابقة، واعرض الاتجاه (مخططًا مصغّرًا، أو مخططًا خطيًا مع جدول بياناته): يبحث الأطباء عن تغيّر مهم، لا عن النطاق فقط.
- النتيجة التي لم تُسجَّل قط والنتيجة غير المتاحة حالتان مختلفتان، بكلمات مختلفة.
-
المجهول ليس طبيعيًا. النتيجة التي ينقصها نطاقها المرجعي أو ما زالت تُحمَّل أو لا يمكن قراءتها لا تفسير لها وتقول ذلك؛
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-fieldprecision="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-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 |
الخصائص نفسها في عناصر الحساسية والمشكلة، مع الرموز نفسها |
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.