شرح CDS Hooks: نقاط الربط، البطاقات، التحميل المسبق

إجابة مختصرة: CDS Hooks هو معيار HL7 يسمح لنظام السجلات الصحية الإلكترونية (EHR) باستدعاء خدمة دعم القرار السريري الخارجية في لحظات محددة (خطافات - hooks) ضمن سير عمل الطبيب: فتح ملف المريض (patient-view)، اختيار طلب (order-select)، توقيع الطلبات (order-sign)، بدء أو إنهاء زيارة المريض. يرسل نظام EHR السياق، وبيانات FHIR التي تم جلبها مسبقًا اختياريًا؛ وتجيب الخدمة في غضون ثوانٍ بـ بطاقات: قطع قصيرة من المعلومات، تحذيرات أو اقتراحات، وروابط يمكنها تشغيل تطبيق SMART on FHIR. يبقى الطبيب داخل نظام EHR؛ والذكاء يعيش خارجه.

الخطوات الثلاث

تعمل خطافات CDS بثلاث خطوات. أولاً، الاكتشاف: يقوم نظام السجلات الصحية الإلكترونية (EHR) بجلب GET /cds-services ويتعرف على الخطاف الذي تستجيب له كل خدمة والبيانات التي تتطلبها من FHIR مسبقًا. ثانيًا، استدعاء الخطاف: عند وقوع حدث في سير العمل مثل توقيع طلب، يقوم نظام EHR بإرسال السياق والموارد التي تم جلبها مسبقًا إلى الخدمة. ثالثًا، الاستجابة: تعيد الخدمة بطاقات يعرضها نظام EHR.

1. الاكتشاف. يجلب نظام EHR GET https://cds.example.org/cds-services ويتلقى قائمة بالخدمات، كل منها مع الخطاف الذي تستجيب له واستعلامات FHIR التي ترغب في جلبها مسبقًا:

{
  "services": [{
    "id": "renal-dosing",
    "hook": "order-sign",
    "title": "Renal dosing check",
    "description": "Flags drug orders whose dose needs review against the latest eGFR.",
    "prefetch": {
      "patient": "Patient/{{context.patientId}}",
      "egfr": "Observation?patient={{context.patientId}}&code=http://loinc.org|98979-8&_sort=-date&_count=1"
    }
  }]
}

2. استدعاء الخطاف. عندما يوقع الطبيب على الطلبات، يرسل نظام EHR طلب POST إلى /cds-services/renal-dosing:

{
  "hookInstance": "d1577c69-dfbe-44ad-ba6d-3e05e953b2ea",
  "hook": "order-sign",
  "fhirServer": "https://ehr.example.org/fhir",
  "fhirAuthorization": {"access_token": "…", "token_type": "Bearer", "expires_in": 300, "scope": "patient/*.read", "subject": "renal-dosing"},
  "context": {
    "userId": "Practitioner/42",
    "patientId": "123",
    "draftOrders": {"resourceType": "Bundle", "entry": [{"resource": {"resourceType": "MedicationRequest", "id": "draft-1", "status": "draft"}}]}
  },
  "prefetch": {
    "patient": {"resourceType": "Patient", "id": "123"},
    "egfr": {"resourceType": "Bundle", "type": "searchset", "entry": [{"resource": {"resourceType": "Observation", "id": "obs-9", "status": "final", "code": {"coding": [{"system": "http://loinc.org", "code": "98979-8"}]}, "valueQuantity": {"value": 38, "unit": "mL/min/1.73m2"}}}]}
  }
}

إذا كان شيء ما تحتاجه الخدمة لم يتم جلبه مسبقًا، فيمكنها الاستعلام عن خادم FHIR الخاص بنظام EHR بنفسها باستخدام الرمز المميز قصير الأجل في fhirAuthorization.

3. الاستجابة. البطاقات، وفي الإصدار 2.0 أيضًا إجراءات النظام:

{
  "cards": [{
    "uuid": "9a1d2f3e-…",
    "summary": "eGFR 38: dose review suggested",
    "indicator": "warning",
    "detail": "The most recent eGFR (38 mL/min/1.73m², 2026-03-10) is below the threshold in the local renal dosing guidance for this drug.",
    "source": {"label": "Hospital renal dosing guidance", "url": "https://intranet.example.org/renal"},
    "suggestions": [{"label": "Open renal dosing table", "uuid": "…", "actions": []}],
    "links": [{"label": "Dosing calculator", "url": "https://apps.example.org/renal/launch", "type": "smart"}]
  }]
}

يقتصر summary على 140 حرفًا؛ indicator هو info أو warning أو critical؛ source إلزامي حتى يعرف الطبيب من يتحدث. قد تقترح suggestions تغييرات ملموسة (إنشاء أو تحديث أو حذف مسودة مورد) يقبلها الطبيب بنقرة واحدة؛ الروابط من نوع smart تفتح تطبيق SMART في السياق. يعرض نظام EHR البطاقات بأسلوبه الخاص؛ الخدمة لا ترسم واجهة المستخدم الخاصة بها داخل نظام EHR.

إضافات الإصدار 2.0

أضافت خطافات CDS الإصدار 2.0، الذي نُشر في عام 2022، نقطة نهاية للملاحظات يمكن لنظام EHR من خلالها الإبلاغ عما إذا كانت البطاقة قد تم قبولها، أو تجاوزها مع ذكر الأسباب، أو تجاهلها؛ systemActions، وهي تغييرات يطبقها نظام EHR دون طلب، لأعمال الصيانة منخفضة المخاطر؛ حقل fhirAuthorization.subject؛ وقواعد selectionBehavior أوضح (at-most-one أو any) للاقتراحات.

نُشر في عام 2022: نقطة نهاية للتغذية الراجعة (POST /cds-services/{id}/feedback) والتي يبلغ من خلالها نظام EHR ما إذا كانت البطاقة قد تم قبولها، أو تجاوزها (مع الأسباب) أو تجاهلها؛ إجراءات النظام (systemActions)، وهي تغييرات يطبقها نظام EHR دون طلب، مخصصة للأعمال الروتينية منخفضة المخاطر مثل إضافة سبب مرمّز؛ fhirAuthorization.subject؛ وقواعد أوضح حول selectionBehavior (at-most-one أو any) للاقتراحات.

ما هي الخدمة، وما ليست كذلك

خدمة خطافات CDS هي برنامج يقرأ سياق سير العمل ويعيد المعلومات على شكل بطاقات؛ وهي ليست جهازًا طبيًا تلقائيًا. يعتمد ما إذا كانت قواعد الأجهزة الطبية تنطبق في الاتحاد الأوروبي والولايات المتحدة على المحتوى: تذكير الطبيب بوجود قيمة مخبرية هو معلومات، في حين أن توصية الجرعة الخاصة بالمريض هي دعم قرار منظم.

خدمة CDS هي برنامج يقرأ السياق ويعيد المعلومات. ما إذا كانت جهازًا طبيًا يعتمد على ما تقوله البطاقات: تذكير بوجود قيمة معملية هو معلومات؛ توصية بالجرعة لمريض معين هي دعم قرار يندرج تحت قواعد الأجهزة الطبية في الاتحاد الأوروبي والولايات المتحدة. انظر هل تطبيق الصحة جهاز طبي؟. المعيار محايد؛ المحتوى ليس كذلك.

الخطافات المعرفة اليوم: patient-view، order-select، order-sign، order-dispatch، encounter-start، encounter-discharge، appointment-book، مع كتالوج عام حيث يتم اقتراح خطافات جديدة.

العلاقة بـ SMART on FHIR

خطافات CDS و SMART on FHIR مكملان لبعضهما البعض. يقوم SMART on FHIR بتشغيل تطبيق يستحوذ على جزء من الشاشة ويستعلم من خادم FHIR بتفويض المستخدم؛ تعمل خطافات CDS في الخلفية وتعيد البطاقات إلى واجهة نظام EHR الخاصة. يمكن أن تحمل البطاقة رابط تشغيل SMART عندما تكون هناك حاجة لأكثر من مجرد بطاقة.

يقوم SMART on FHIR بتشغيل تطبيق يتولى جزءًا من الشاشة ويتحدث إلى خادم FHIR بإذن المستخدم. تعمل CDS Hooks في الخلفية وتعيد البطاقات؛ يمكن للبطاقة أن تحمل رابط تشغيل SMART عندما تكون هناك حاجة لأكثر من مجرد بطاقة. معظم منتجات دعم القرار تستخدم كليهما: خطافات للإشعار، وتطبيق SMART للتفاصيل.

أين يتناسب Anpheros

لا تقدم Anpheros خدمة CDS Hooks ولا تنتج توصيات سريرية. يمكن أن يكون سجل FHIR الخاص بها، بموافقة المريض، هو البيانات التي تقرأها خدمة دعم القرار الخاصة بالمستشفى (الأدوية، الحساسية، النتائج الحديثة)، من خلال نفس واجهة برمجة تطبيقات FHIR التي ستستخدمها خدمة الخطاف. انظر منصة موافقة المريض.

صفحات ذات صلة

مصادر

الأسئلة الشائعة

هل CDS Hooks جزء من FHIR؟

إنها مواصفات HL7 منفصلة تستخدم FHIR لبياناتها: تحمل بيانات الجلب المسبق والسياق موارد FHIR، ويعيد التفويض استخدام رموز SMART on FHIR. تنشرها HL7 جنبًا إلى جنب مع FHIR، وليس داخل مواصفات FHIR.

ما مدى سرعة استجابة خدمة CDS؟

لا تحدد المواصفات رقمًا، ولكن أنظمة EHR تطبق مهلات لبضع ثوانٍ وتتجاهل الاستجابات المتأخرة، لأن الطبيب ينتظر. الجلب المسبق موجود تحديدًا حتى لا تقضي الخدمة هذا الوقت في الاستعلام.

هل يمكن لخدمة CDS تغيير الطلب؟

فقط عن طريق اقتراح اقتراح يقبله الطبيب، أو في الإصدار 2.0، من خلال إجراءات النظام (systemActions) التي وافق نظام EHR على تطبيقها تلقائيًا لتلك الخدمة. لا تكتب الخدمة أبدًا في خادم FHIR الخاص بنظام EHR بمفردها أثناء الخطاف.

هل يستخدم تطبيق المريض CDS Hooks؟

لا. تم تصميم CDS Hooks لسير عمل EHR التي يواجهها الأطباء. تستخدم تطبيقات المرضى واجهة برمجة تطبيقات FHIR مباشرة و SMART on FHIR لتسجيل الدخول.

Anpheros Platform

جرّبه مجانًا في بيئة الاختبار

أول طلب FHIR خلال 5 دقائق. واجهة برمجة تطبيقات HL7 FHIR R4 مع موافقة المريض مدمجة: جربها في بيئة الاختبار، ثم اربط تطبيقك الخاص أو نظام عيادتك.

أنشئ بيئة اختبار مجانية اقرأ أدلة المطورين →

مجاني · 30 مريضًا اصطناعيًا · دون بطاقة

هذا الدليل هو للمعلومات فقط ولا يغني عن الاستشارة الطبية. لاتخاذ قرارات بشأن صحتك، تحدث مع طبيبك. في حالة الطوارئ، اتصل برقم الطوارئ المحلي (112 في أوروبا).

بقلم

فريق Anpheros

تبني Anpheros سجلًا طبيًا يتحكم فيه المريض ويمكن مشاركته مع أي عيادة، على منصة HL7 FHIR R4، مقرها في الاتحاد الأوروبي. تساعدك هذه الأدلة على فهم وتنظيم صحتك؛ ولا تغني عن استشارة طبيبك.

عن Anpheros →