التقنية في الصحة الأدلة التقنية

السجل الصحي الإلكتروني EMR مع OpenEMR وOpenMRS

كيف تشغل سجلاً سريرياً مفتوح المصدر بواجهة عربية، وتسجل فيه مريضاً وزيارة ووصفة، ثم تتكامل معه عبر OAuth2 وFHIR وتعرف ما يتغير في الطريق.

السجل الصحي الإلكتروني EMR مع OpenEMR وOpenMRS

في مقال المستشفى من الداخل عرفنا السجل السريري الإلكتروني Electronic Medical Record واختصاراً EMR بأجزائه: الملاحظات، وقائمة المشاكل، والحساسية، والطلبات، والوصفات. ورأينا أن المستشفيات الكبيرة تشتري أنظمة تجارية بعقود طويلة. ولكن ماذا عن عيادة خاصة صغيرة، أو مستوصف في منطقة نائية، أو شركة ناشئة تريد أن تبني خدمة طبية وتحتاج سجلاً سريرياً تبدأ منه بدل أن تكتبه من الصفر؟ هنا يظهر سؤال تسمعه كثيراً من المطورين: هل يوجد سجل طبي مفتوح المصدر يصلح للاستخدام الفعلي، ويعمل بالعربية، ويتكامل مع بقية الأنظمة عبر FHIR؟

والإجابة المختصرة نعم، ولكن بشروط لن تعرفها حتى تشغله بنفسك. لذلك سوف نشغل في هذا المقال OpenEMR بالـ Image الرسمية، ونمر فيه بما يفعله أي مستخدم في عيادة، ثم ما يفعله أي مطور يريد التكامل معه، ونقارنه بالمشروع الآخر الكبير OpenMRS. وسوف نناقش ما يلي:

  • الخيارات مفتوحة المصدر للسجل السريري، ولمن صمم كل من OpenEMR وOpenMRS.
  • تشغيل OpenEMR 8.5.0 مع MariaDB على Docker، وما يحدث في أول تشغيل.
  • الواجهة العربية واتجاهها من اليمين إلى اليسار، وكم منها مترجم فعلاً، وترجمات حرفية رأيناها في الشاشات.
  • تسجيل مريضة وزيارة عبر الواجهة القياسية REST API، ووصفة طبية من الواجهة، ومريضة تكررت لأن أحداً لم يمنع ذلك.
  • تسجيل تطبيق بـ OAuth2، والرفض الذي يأتي قبل موافقة المدير، والتوكن ونطاقاته Scopes.
  • واجهة FHIR: ما الذي وصل كما أدخلناه وما الذي تغير في الطريق، ومنه الوحدة والتوقيت.
  • سجل التدقيق Audit Log وسجل الـ API الذي يحفظ الردود كاملة، والنسخ الاحتياطي، والثغرات التي أغلقها الإصدار 8.5.0.

أي سجل سريري مفتوح المصدر؟

المشاريع كثيرة، ولكن اثنين منها فقط لهما مجتمع كبير وتاريخ طويل وتحديثات مستمرة، وكل منهما صمم لعالم مختلف:

  • OpenEMR: بدأ قبل أكثر من عشرين سنة كنظام لإدارة العيادات في الولايات المتحدة، فيه السجل السريري والمواعيد والفوترة والوصفات وبوابة المريض، ومكتوب بلغة PHP على MySQL أو MariaDB، برخصة GPL. ويقدم واجهة FHIR R4 ويدعم SMART on FHIR، وحصل على شهادات برنامج ONC الأمريكي، ولذلك تجد فيه كثيراً من المتطلبات الأمريكية مثل US Core والفوترة الأمريكية. وموقعه open-emr.org.
  • OpenMRS: بدأ في 2004 لعلاج مرضى الإيدز في أفريقيا، وصمم ليكون منصة يبني عليها كل بلد نظامه، وليس منتجاً جاهزاً لعيادة. وهو مكتوب بلغة Java، ونموذج بياناته يقوم على قاموس مفاهيم Concept Dictionary تعرف فيه كل ملاحظة وسؤال وتشخيص، والإصدار الثالث منه O3 واجهة حديثة مبنية من وحدات صغيرة في المتصفح. ويعمل في عشرات الدول في المستشفيات والمراكز الصحية الحكومية والمنظمات الإنسانية.

وستسمع أيضاً عن مشاريع أخرى. فـ Bahmni توزيعة مبنية فوق OpenMRS تجمع معه نظام المختبر OpenELIS الذي نقارنه في مقال المختبر، ونظام Odoo للمخزون والفوترة، وتستهدف المستشفيات في البيئات محدودة الموارد. وGNU Health نظام آخر برخصة GPL مبني على إطار Tryton، ويهتم بالصحة العامة إلى جانب السجل السريري. والقاعدة التي تنطبق على كل هذه المشاريع واحدة: لا تحكم على السجل السريري من صفحة المزايا، وإنما من مختبر صغير تمر فيه بما يفعله الاستقبال والطبيب والصيدلي والمطور، وهذا ما سوف نفعله الآن.

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

تجهيز المختبر: OpenEMR 8.5.0 مع MariaDB

الصورة التالية تبين مكونات المختبر:

مخطط المختبر: المتصفح يفتح الواجهة بالعربية على https://localhost:9584، وتطبيق تكامل يسجل نفسه بـ OAuth2 ويستدعي /apis/default/api و/apis/default/fhir، وكلاهما يصل إلى OpenEMR 8.5.0 على Apache 2.4.71 وPHP 8.5.12 الذي احتاج 223 ثانية للإعداد التلقائي، ومعه Volume للمواقع فيه المستندات ومفاتيح OAuth2، وقاعدة MariaDB 11.8 فيها 286 جدولاً بحجم 41.5 ميغابايت، ومنها patient_data وform_encounter وprescriptions وlog وapi_log وoauth_clients
مكونات المختبر: OpenEMR وقاعدته وتطبيق تكامل يتصل بالـ API

والإعداد مبني على المثال في توثيق الـ Image الرسمية، مع كلمات مرور عشوائية بدل القيم الافتراضية، وتفعيل الواجهتين من البداية:

name: hi2-emr
services:
  db:
    image: mariadb:11.8.9
    container_name: hi2-emr-db
    command: ["mariadbd", "--character-set-server=utf8mb4"]
    environment:
      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD:?set DB_ROOT_PASSWORD in .env}
    volumes:
      - hi2-emr-db:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 5s
      retries: 20

  openemr:
    image: openemr/openemr:8.5.0
    container_name: hi2-emr
    depends_on:
      db:
        condition: service_healthy
    environment:
      MYSQL_HOST: db
      MYSQL_ROOT_PASS: ${DB_ROOT_PASSWORD}
      MYSQL_USER: openemr
      MYSQL_PASS: ${DB_PASSWORD:?set DB_PASSWORD in .env}
      OE_USER: admin
      OE_PASS: ${OE_PASSWORD:?set OE_PASSWORD in .env}
      OPENEMR_SETTING_rest_api: 1
      OPENEMR_SETTING_rest_fhir_api: 1
      OPENEMR_SETTING_site_addr_oath: https://localhost:9584
      OPENEMR_SETTING_oauth_password_grant: 3
    volumes:
      - hi2-emr-sites:/var/www/localhost/htdocs/openemr/sites
      - hi2-emr-logs:/var/log
    ports:
      - "127.0.0.1:9583:80"
      - "127.0.0.1:9584:443"

volumes:
  hi2-emr-db:
    name: hi2-emr-db
  hi2-emr-sites:
    name: hi2-emr-sites
  hi2-emr-logs:
    name: hi2-emr-logs

networks:
  default:
    name: hi2-emr-net

في الإعداد أعلاه لاحظ التالي:

  • الخيار --character-set-server=utf8mb4 للقاعدة ليس تفصيلاً، فالأسماء العربية تحتاجه، وهو موجود في المثال الرسمي نفسه.
  • كل إعداد من مئات الإعدادات العامة في OpenEMR يضبط بمتغير يبدأ بـ OPENEMR_SETTING_ ثم اسم الإعداد كما في قائمة الإعدادات العامة. فعلنا الواجهة القياسية وواجهة FHIR، وحددنا العنوان الذي يستخدمه OAuth2 في التوكنات، وفعلنا منح كلمة المرور Password Grant لأننا سوف نستدعي الـ API من سطر الأوامر دون متصفح، وهذا للمختبر فقط كما سوف نشرح.
  • الـ Volume sites فيه أكثر مما تظن: المستندات التي ترفع، وملف الاتصال بالقاعدة، ومفاتيح التوقيع التي يوقع بها OAuth2 التوكنات، وسوف نعود إليه في النسخ الاحتياطي.
  • المنفذ 443 بشهادة ذاتية التوقيع تولدها الـ Image، وفي الإنتاج ضع OpenEMR خلف Reverse Proxy بشهادة حقيقية، أو استخدم المتغير DOMAIN الذي يطلب شهادة Let's Encrypt.
printf 'DB_ROOT_PASSWORD=%s\nDB_PASSWORD=%s\nOE_PASSWORD=%s\n' $(openssl rand -hex 16) $(openssl rand -hex 16) $(openssl rand -hex 10) > .env
docker compose up -d
docker logs -f hi2-emr 2>&1 | grep -E "TIMING|Setup Complete|Starting Apache"
[TIMING] Auto-configuration took 223.0s
Setup Complete!
[TIMING] Total script execution time: 226.0s before Apache start
Starting Apache!

قرابة أربع دقائق في أول تشغيل، يقضيها السكربت في إنشاء القاعدة وجداولها البالغة 286 جدولاً وتحميل البيانات الأساسية مثل الرموز والقوائم والترجمات. وفي التشغيل التالي يبدأ في ثوان، لأن القاعدة موجودة. ونتحقق من الإصدار من داخل الـ Container:

docker exec hi2-emr sh -c 'grep -E "v_(major|minor|patch|database)" /var/www/localhost/htdocs/openemr/version.php; php -v | head -1; httpd -v | head -1'
$v_major = '8';
$v_minor = '5';
$v_patch = '0';
$v_database = 555;
PHP 8.5.12 (cli) (built: Oct 21 2026 16:29:26) (NTS)
Server version: Apache/2.4.71 (Unix)

ورقم القاعدة 555 مهم عند الترقية، لأن سكربتات الترقية تعرف منه من أي نسخة تبدأ، فلا تنسخ قاعدة من إصدار إلى آخر دون أن تمر بها.

الواجهة العربية: الاتجاه صحيح والترجمة نصفها

في صفحة الدخول قائمة لغات، والعربية فيها، فاخترناها ودخلنا بحساب المدير. والصورة التالية أول ما ظهر:

لقطة من الشاشة الرئيسية في OpenEMR بعد الدخول بالعربية: القائمة العلوية من اليمين فيها التقويم وFinder والجرايان وRecalls والرسائل ومريض وModules وتقارير، والتقويم على اليمين بشهر نوفمبر 2026، وفي الوسط نافذة OpenEMR Product Registration بالإنجليزية تطلب بريداً إلكترونياً، وفيها خانة الموافقة على مشاركة بيانات الاستخدام مع مؤسسة OpenEMR محددة مسبقاً، وزرا Ask again later وتسليم
الشاشة الرئيسية بالعربية، ونافذة التسجيل وخانة مشاركة بيانات الاستخدام محددة مسبقاً

في الصورة ثلاث ملاحظات. الأولى أن الاتجاه انقلب فعلاً، فالقائمة تبدأ من اليمين والتقويم في اليمين، والسبب أن العربية معرفة في جدول اللغات بالحقل lang_is_rtl بالقيمة 1. والثانية أن الترجمة مختلطة: «Modules» و«Recalls» و«Finder» بقيت بالإنجليزية بجانب «التقويم» و«الرسائل». والثالثة نافذة تسجيل المنتج: تطلب بريداً إلكترونياً، وفيها خانة الموافقة على إرسال بيانات استخدام مجهولة إلى مؤسسة OpenEMR، وهي محددة مسبقاً. والنافذة نفسها تقول إن البيانات لا تحتوي معلومات صحية للمرضى، ولكن قرار إرسال أي بيانات من نظام سريري إلى جهة خارجية يجب أن يكون قرار المنشأة ومسؤول حماية البيانات فيها، وليس خانة يضغط عليها أول من دخل، فأزل التحديد أو اقرأ ما يرسل قبل أن توافق.

ولنعرف حجم الترجمة بدقة سألنا القاعدة نفسها، فكل نص في الواجهة له سطر في جدول الثوابت، وكل ترجمة سطر في جدول التعريفات:

docker exec hi2-emr-db mariadb -uroot -p$DB_ROOT_PASSWORD openemr -e "
select lang_id, lang_code, lang_description, lang_is_rtl from lang_languages where lang_description like 'Arab%';
select count(*) total_constants from lang_constants;
select l.lang_description, count(d.def_id) translated from lang_definitions d join lang_languages l on l.lang_id=d.lang_id
 where l.lang_description in ('Arabic','French','Spanish (Spain)','German') group by 1;"
lang_id	lang_code	lang_description	lang_is_rtl
20	ar	Arabic	1
total_constants
13234
lang_description	translated
Arabic	6290
German	5587
Spanish (Spain)	6196

أي 6290 ترجمة عربية من 13234 نصاً، قرابة 48%، وهي أكثر من الإسبانية والألمانية في نفس القاعدة. وهذا يفسر الخليط في الشاشات: الأجزاء القديمة الأساسية مترجمة، والأجزاء الأحدث مثل فريق الرعاية وخطط الرعاية بالإنجليزية. ثم فتحنا لوحة المريض بعد أن سجلناها:

لقطة من لوحة سجل المريضة نورة عبدالله الأحمد بالعربية: العنوان Medical Record Dashboard، وبطاقات المحسسات والمشاكل الطبية والأدوية بعبارة لم يتم تسجيل اي شيئ، والوصفات الدوائية ولا واحد، ثم بطاقات بالإنجليزية Care Team وTreatment Intervention Preferences وCare Experience Preferences وCare Plan، ثم المعلومات الشخصية والفاتورة والتأمين والرسائل وتنبيهات المريض والإفصاحات وتعديلات أو إضافات ومختبرات والعلامات الحيوية والمواعيد والتطعيمات
لوحة المريضة: نصف البطاقات بالعربية ونصفها بالإنجليزية

ومع الخليط هناك ترجمات حرفية لا يفهمها الطبيب، وجمعناها من الشاشات ثم تحققنا منها في جدول الترجمات:

constant_name	definition
Allergies	المحسسات
Back	الظهر
Disclosures	الإفصاحات
HTML	لغة رقم النص الفائق (إتش تي أم إل)
Prescriptions	الوصفات الدوائية

زر الرجوع «Back» ترجم «الظهر» أي ظهر الإنسان، والصيغة HTML صارت جملة لا معنى لها، و«Allergies» صارت «المحسسات» والمعروف «الحساسية»، وفي قائمة أشكال الدواء في الوصفة ظهرت «Suspension» أي المعلق الدوائي بترجمة «إيقاف عن العمل». والصورة التالية تجمع ذلك:

مخطط الترجمة العربية في OpenEMR: أعمدة لعدد النصوص المترجمة، العربية 6290 والإسبانية 6196 والألمانية 5587 من أصل 13234 نصاً، مع ملاحظة أن العربية معرفة lang_is_rtl تساوي 1، وجدول ترجمات حرفية: Back إلى الظهر، وHTML إلى لغة رقم النص الفائق، وSuspension إلى إيقاف عن العمل، وAllergies إلى المحسسات، وModules وCare Team بقيت بالإنجليزية
كم من الواجهة مترجم، وأمثلة على ترجمات حرفية

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

الواجهتان: القياسية REST وFHIR

OpenEMR يقدم ثلاث واجهات كما يشرح توثيق الـ API: الواجهة القياسية على /apis/default/api وهي خاصة بـ OpenEMR وتقرأ وتكتب أغلب البيانات، وواجهة FHIR R4 على /apis/default/fhir وهي للقراءة في أغلبها وتتبع ملفات US Core، وواجهة بوابة المريض التجريبية. وكل واحدة تحتاج توكن OAuth2 بنطاقات محددة، والنطاق يبدأ بـ user/ لموظف، أو patient/ لمريض، أو system/ لنظام دون مستخدم. والجدول في توثيق الواجهة القياسية يبين أن الوصفات للقراءة فقط، لذلك سوف نسجل المريضة والزيارة بالواجهة، والوصفة من الشاشة.

تسجيل التطبيق OAuth2: الرفض قبل الموافقة

أي تطبيق يريد الوصول يسجل نفسه أولاً كعميل Client، وهذا ملف التسجيل لتطبيق تكامل في عيادة وهمية، ونطلب فيه نطاقات القراءة والكتابة للمرضى والزيارات، والقراءة للوصفات والتشخيصات في FHIR:

{
  "application_type": "private",
  "redirect_uris": ["https://clinic-app.example.org/callback"],
  "client_name": "clinic-integration",
  "token_endpoint_auth_method": "client_secret_post",
  "contacts": ["[email protected]"],
  "scope": "openid offline_access api:oemr api:fhir user/patient.read user/patient.write user/encounter.read user/encounter.write user/Patient.read user/Encounter.read user/MedicationRequest.read user/Condition.read"
}
curl -sk -X POST https://localhost:9584/oauth2/default/registration -H 'Content-Type: application/json' \
  --data-binary @client.json -o register.json -w "%{http_code}\n"
200
{
 "client_id": "6UJPeMvkOqVECoBjpyd4GLn2cR7_aj_IZqO6f73kLrs",
 "client_secret": "_yUMxTlzo9jD...",
 "registration_access_token": "n_B-m7HfjVgt...",
 "registration_client_uri": "https://localhost:9584/oauth2/default/client/zrs3qAJNjiOZADCAEFO82g",
 "client_id_issued_at": 1795005815,
 "client_secret_expires_at": 0,
 "client_role": "user",
 "application_type": "private",
 "client_name": "clinic-integration",
 "token_endpoint_auth_method": "client_secret_post",
 "grant_types": [
  "authorization_code"
 ],
 "dsi_type": "none"
}

اختصرنا السر والتوكن في المخرج وحذفنا بعض الحقول التي تكرر ما أرسلناه، ولاحظ أمرين: أن السر لا يمكن استرجاعه لاحقاً فاحفظه في مكان آمن، وأن الحقل grant_types فيه authorization_code فقط، مع أننا فعلنا منح كلمة المرور في الإعدادات العامة. والآن نطلب توكناً بكلمة مرور المدير:

curl -sk -X POST https://localhost:9584/oauth2/default/token --data-urlencode grant_type=password \
  --data-urlencode client_id=$CID --data-urlencode client_secret=$CS \
  --data-urlencode "scope=openid api:oemr api:fhir user/patient.read user/patient.write user/encounter.read user/encounter.write user/Patient.read user/Encounter.read" \
  --data-urlencode user_role=users --data-urlencode username=admin --data-urlencode password=$OE_PASSWORD -w "\n%{http_code}\n"
{"error":"invalid_client","error_description":"Client authentication failed","message":"Client authentication failed"}
401

رسالة الخطأ تقول إن مصادقة العميل فشلت، وكأن السر خطأ، والسبب الحقيقي في سجل Apache داخل الـ Container:

OpenEMR.ERROR: Client 6UJPeMvkOqVECoBjpyd4GLn2cR7_aj_IZqO6f73kLrs returned was not enabled [] []

وفي القاعدة is_enabled = 0. فالعميل الذي يسجل نفسه بدور مستخدم لا يعمل حتى يوافق عليه مدير النظام، وهذا تصميم مقصود، لأن التسجيل نفسه مفتوح لأي أحد يصل إلى الخادم، والموافقة هي ما يمنع تطبيقاً مجهولاً من طلب بيانات المرضى. والمشكلة فقط في الرسالة التي لا تقول ذلك، فإذا رأيت invalid_client مع سر صحيح فاذهب إلى صفحة عملاء الـ API في قائمة الإدارة. وهناك زران: Enable Client، وAllow Password Grant لأن منح كلمة المرور في الإصدار 8.5.0 أصبح يفعل لكل عميل على حدة. والصورة التالية من الصفحة بعد الضغط عليهما:

لقطة من صفحة عملاء الـ API في OpenEMR للعميل clinic-integration بعد التفعيل: أزرار Disable Client وDeny Password Grant وDisable EHR Launch Authorization Flow، ورسالة Enabled Client clinic-integration، والمعرف، وأنواع المنح المسموحة authorization_code وpassword، وخانتا Is Enabled وIs Confidential محددتان، والدور user، ورابط إعادة التوجيه، وقائمة النطاقات من openid إلى user/Condition.read
العميل بعد موافقة المدير: مفعل، ومنح كلمة المرور مسموح له وحده

ثم أعدنا نفس الطلب، وفككنا التوكن لنرى ما فيه:

200
{'id_token': 'eyJ0eXAiOiJKV1QiLCJh...', 'scope': 'openid user/patient....', 'token_type': 'Bearer', 'expires_in': 3600, 'access_token': 'eyJ0eXAiOiJKV1QiLCJh...'}
{'aud': '6UJPeMvkOqVECoBjpyd4GLn2cR7_aj_IZqO6f73kLrs', 'jti': '91e04dc87e1cc0fcffcade10c3886dd05aa983344bfac56940f3105eb071ad4f92281130424c6cb1', 'iat': 1795006632.196495, 'nbf': 1795006632.196499, 'exp': 1795010232.166435, 'sub': 'a3414144-9200-4482-b6ea-cc155a4266ea', 'scopes': ['openid', 'api:oemr', 'api:fhir', 'user/patient.read', 'user/patient.write', 'user/encounter.read', 'user/encounter.write', 'user/Patient.read', 'user/Encounter.read', 'user/MedicationRequest.read', 'user/Condition.read'], 'iss': 'https://localhost:9584/oauth2/default'}

في المخرج أعلاه لاحظ التالي:

  • التوكن JWT صالح ساعة expires_in: 3600، والمستقبل aud هو رقم العميل، والمصدر iss هو العنوان الذي ضبطناه في site_addr_oath. فإذا غيرت عنوان النظام لاحقاً دون أن تغير هذا الإعداد، فستفشل التوكنات في التحقق.
  • الحقل scopes فيه كل النطاقات المسجلة للعميل، مع أننا طلبنا ثمانية فقط، فلم يرجع منها Condition.read وMedicationRequest.read في الطلب ولكنهما في التوكن. لذلك لا تعتمد على ما تطلبه في كل طلب لتقليل الصلاحيات، وإنما على ما تسجل به العميل من البداية.
  • الحقل sub هو معرف المستخدم admin، فكل ما سوف نفعله بهذا التوكن يسجل باسمه، وفي الإنتاج يجب أن يكون للتكامل مستخدم خاص به بصلاحيات محدودة.
مخطط OAuth2 في OpenEMR بأربع خطوات: التطبيق يسجل نفسه فيرجع client_id وclient_secret ولكن grant_types authorization_code فقط والعميل معطل، ثم طلب التوكن قبل الموافقة يرجع 401 invalid_client وفي السجل Client was not enabled، ثم المدير يضغط Enable Client وAllow Password Grant فيصبح authorization_code وpassword، ثم توكن JWT صالح 3600 ثانية فيه aud والنطاقات، وطلب Observation دون نطاقه رجع 401، وتذكير بأن Password Grant للمختبر فقط والصحيح Authorization Code مع PKCE أو SMART Backend Services
من التسجيل إلى أول طلب، والرد الحقيقي في كل خطوة

وقد يتساءل البعض: لماذا لا نستخدم منح كلمة المرور في التطبيق الحقيقي إذا كان أسهل؟ والإجابة في توثيق المصادقة نفسه، فهو يقول إنه غير مناسب للإنتاج: التطبيق يرى كلمة مرور المستخدم، ولا توجد شاشة موافقة، والتحقق الثنائي محدود. والأهم أن الإصدار 8.5.0 أغلق ثغرة GHSA-6xc2-v6mv-w3g3 التي كان فيها منح كلمة المرور يتجاوز التحقق الثنائي MFA إذا لم يرسل التطبيق الحقل الخاص به، وثغرة GHSA-qjj7-c4m9-6f92 التي لم تكن تقيد العميل بأنواع المنح المسجلة له، وهذا يفسر لماذا أصبح المنح يفعل لكل عميل. والصحيح لتطبيق فيه مستخدم هو Authorization Code مع PKCE، ولنظام دون مستخدم هو Client Credentials بمفتاح موقع، كما شرحنا في مقال OAuth وOpenID Connect.

تسجيل المريضة Patient Registration: والتكرار الذي لم يمنعه أحد

نسجل مريضة وهمية بالواجهة القياسية، ونضع رقم ملفها في العيادة في الحقل pubpid:

{
  "title": "Mrs.",
  "fname": "نورة",
  "mname": "عبدالله",
  "lname": "الأحمد",
  "DOB": "1984-03-12",
  "sex": "Female",
  "street": "شارع تجريبي 12",
  "city": "مدينة تجريبية",
  "postal_code": "00000",
  "country_code": "SA",
  "phone_cell": "+966500000000",
  "pubpid": "MRN-24017"
}
curl -sk -X POST https://localhost:9584/apis/default/api/patient -H "Authorization: Bearer $T" \
  -H 'Content-Type: application/json' --data-binary @patient.json -w "\n%{http_code}\n"
{"validationErrors":[],"internalErrors":[],"data":{"pid":1,"uuid":"a341415d-5a6b-459f-b589-ea29bb17c47f"},"links":[]}
201

المريضة لها رقمان داخليان: pid رقم تسلسلي تستخدمه الشاشات والجداول، وuuid المعرف الذي تستخدمه الواجهات وFHIR. ثم أرسلنا نفس الملف مرة ثانية، كما يحدث عندما يعيد تطبيق الطلب بعد انقطاع الشبكة:

{"validationErrors":[],"internalErrors":[],"data":{"pid":2,"uuid":"a3414173-44ef-4f1e-8ead-9b490f4ba21e"},"links":[]}
201

مريضة ثانية بنفس الاسم وتاريخ الميلاد ورقم الملف. فالواجهة لا تتحقق من تكرار pubpid ولا من تطابق البيانات الأساسية، ولا تقبل مثل HAPI FHIR رأساً للإنشاء المشروط، كما رأينا في مقال خادم FHIR على سيرفرك. والملف المكرر في السجل الطبي خطر حقيقي: نصف التاريخ المرضي في ملف ونصفه في ملف آخر، والحساسية المسجلة في الأول لا يراها الطبيب الذي فتح الثاني. لذلك يجب أن يبحث تطبيقك بالمعرف قبل أن ينشئ، ويستخدم مفتاح Idempotency في طبقته هو، وأن يكون في العيادة إجراء لدمج الملفات المكررة، فهذا ما يفعله فهرس المرضى الرئيسي MPI الذي شرحناه في مقال الخريطة.

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

الزيارة Encounter والمنطقة الزمنية

ثم نسجل زيارة للمريضة الأولى:

{
  "date": "2026-11-16 09:00:00",
  "onset_date": "2026-09-16",
  "reason": "عطش شديد وكثرة التبول منذ شهرين",
  "facility_id": 3,
  "pc_catid": 5,
  "billing_facility": 3,
  "class_code": "AMB",
  "sensitivity": "normal",
  "pos_code": 11
}
curl -sk -X POST https://localhost:9584/apis/default/api/patient/$P/encounter -H "Authorization: Bearer $T" \
  -H 'Content-Type: application/json' --data-binary @encounter.json -w "\n%{http_code}\n"
{"validationErrors":[],"internalErrors":[],"data":{"eid":2,"euuid":"a3414173-ff68-4c79-97e0-094b3e223790","date":"2026-11-16 09:00:00", ... "class_code":"AMB","class_title":"ambulatory","pc_catname":"Office Visit","pid":1,"puuid":"a341415d-5a6b-459f-b589-ea29bb17c47f","facility_id":3, ... "facility_name":"Your Clinic Name Here", ... "encounter":2},"links":[]}
201

اختصرنا الرد لطوله. والرقم 3 للمنشأة و5 لنوع الزيارة أخذناهما من البيانات الأساسية التي ينشئها التثبيت، والمنشأة اسمها «Your Clinic Name Here» لأننا لم نعدل بيانات العيادة، وهذا الاسم سوف يظهر في كل مطالبة وتقرير حتى تعدله، فاجعله أول ما تفعله بعد التثبيت. والسبب المكتوب بالعربية رجع سليماً. أما الوقت فسوف نرى ما حدث له عندما نقرأ الزيارة من FHIR.

كيف يحفظ OpenEMR الزيارة من الداخل؟

قبل أن نكمل من المفيد أن تعرف شكل البيانات في القاعدة، لأن أي تقرير أو ترحيل بيانات سوف تكتبه يمر بها. سألنا القاعدة عن ثلاثة أشياء:

docker exec hi2-emr-db mariadb -uroot -p$DB_ROOT_PASSWORD openemr -e "
select count(*) from information_schema.columns where table_schema='openemr' and table_name='patient_data';
select formdir, count(*) from forms group by formdir;
select count(*) from registry; select name from registry where state=1 limit 12;"
count(*)
132
formdir	count(*)
newpatient	1
count(*)
18
name
New Encounter Form
Review of Systems Checks
Speech Dictation
SOAP
Vitals
Review Of Systems
Fee Sheet
Misc Billing Options HCFA
Procedure Order
Observation
Care Plan
Functional and Cognitive Status

في المخرج أعلاه لاحظ التالي:

  • بيانات المريض في جدول واحد عريض patient_data فيه 132 عموداً: الاسم والعنوان والهاتف والتأمين والعرق واللغة وغيرها. وهذا تصميم قديم بسيط في الاستعلام، ولكن كل حقل جديد يحتاجه بلدك، مثل رقم الهوية الوطنية أو رقم الإقامة، يحتاج عموداً أو حقلاً مخصصاً من نظام النماذج.
  • الزيارة نفسها سجلت كنموذج اسمه newpatient في جدول forms، أي أن OpenEMR يعامل كل ما يكتب في الزيارة كنماذج مرتبطة بها: نموذج الزيارة، ونموذج SOAP للملاحظة السريرية، ونموذج العلامات الحيوية Vitals، وصفحة الرسوم Fee Sheet. وجدول registry فيه 18 نوعاً من النماذج المسجلة، منها نموذج الفوترة الأمريكي HCFA.
  • وهناك نماذج تبنيها بنفسك دون برمجة اسمها النماذج المبنية على التخطيط Layout Based Forms، ومجلدها LBF رأيناه في الـ Volume، وهي الطريقة المعتادة لإضافة نموذج تقييم خاص بعيادتك. أما المشاكل الطبية والحساسية والأدوية المزمنة فتحفظ في جدول lists بنوع لكل منها، وكان فارغاً لأننا لم نضف شيئاً.

والدرس هنا أن OpenEMR سجل عيادة صمم حول الزيارة والنموذج والفاتورة، وكثير من تفاصيله أمريكية: الفوترة على نماذج HCFA ومطالبات X12، وهي التي تتحدث عنها ثغرات ERA في ملاحظات الإصدار، وملف US Core في FHIR. فإذا كانت عيادتك في السعودية، فالمطالبات عبر منصة نفيس NPHIES رسائل FHIR بدليل تنفيذ خاص شرحناه في مقال خادم FHIR على سيرفرك، وهي تكامل تبنيه أنت أو تشتريه، وليست زراً في الواجهة.

الوصفة Prescription من الشاشة

الوصفات للقراءة فقط في الواجهة القياسية، فكتبناها من شاشة الوصفة في سجل المريضة: Metformin 500 MG Oral Tablet، حبة واحدة مرتين يومياً عن طريق الفم، والكمية 60، ومرتان لإعادة الصرف، ومرتبطة بالزيارة. والشاشة فيها اختيار مصدر الدواء: القائمة الافتراضية أو RxNorm، ولم يكن في القائمة شيء لأن قاعدة RxNorm لا تثبت تلقائياً، فكتبنا الاسم نصاً. وبعد الحفظ ظهرت قائمة الوصفات:

لقطة من قائمة الوصفات بالعربية في OpenEMR: الدواء Metformin 500 MG Oral Tablet مع الملاحظة مع الأكل صباحاً ومساءً، وعمود RxNorm فارغ، والتاريخ 2026-11-18، والجرعات 1 داخل حبة دواء مرتان في اليوم، والكمية 60، والوحدة 500 ملى جرام، وإعادة الصرف 2، والمزود Administrator، وفي الأعلى أزرار تنزيل ملف PDF وطباعة وفاكس وإرسال بريد، وأحدها مكتوب لغة رقم النص الفائق
الوصفة كما ظهرت في القائمة، وعمود RxNorm فارغ لأن الدواء كتب نصاً

ولاحظ في الصورة عبارة «1 داخل حبة دواء مرتان في اليوم» وهي تركيب من ترجمات منفصلة لكل حقل، والصيدلي العربي لن يقرأها كما يقرأ «حبة واحدة مرتين يومياً». وفي القاعدة حفظت الوصفة هكذا:

        id: 4
patient_id: 1
      drug: Metformin 500 MG Oral Tablet
    dosage: 1
  quantity: 60
      size: 500
      unit: 1
      form: 2
     route: 1
  interval: 1
   refills: 2
 encounter: 2
      note: مع الأكل، صباحاً ومساءً
    active: 1

كل حقل رقم يشير إلى قائمة: unit 1 هي ملغ، وform 2 حبة، وroute 1 عن طريق الفم، وinterval 1 مرتين يومياً. وهذا مهم إذا قرأت من القاعدة مباشرة، فالأرقام لا تعني شيئاً دون جداول القوائم، والأفضل أن تقرأ من الواجهة.

واجهة FHIR: ما الذي وصل كما أدخلناه؟

الآن نقرأ ما أدخلناه من واجهة FHIR، وهي ما سوف يستخدمه أي تطبيق أو منصة خارجية. وبدأنا بسطر الأوامر في Git Bash على Windows، فرجعت كل عمليات البحث بالأسماء العربية بالعدد 0، حتى الاسم الصحيح كما حفظ. والسبب ليس في OpenEMR، وإنما في أن الحروف العربية في معاملات سطر الأوامر على Windows تمر بترميز النظام قبل أن تصل إلى curl، فيصل إلى السيرفر شيء آخر. فكتبنا سكربت Python صغيراً يرسل الطلبات بترميز UTF-8 صحيح:

# FHIR searches against OpenEMR with the token from runs/04-token.json (lab only: self-signed TLS)
import json, ssl, sys, urllib.parse, urllib.request
tok = json.load(open("runs/04-token.json"))["access_token"]
ctx = ssl.create_default_context(); ctx.check_hostname = False; ctx.verify_mode = ssl.CERT_NONE
def get(path, **q):
    url = "https://localhost:9584/apis/default/fhir/" + path + ("?" + urllib.parse.urlencode(q) if q else "")
    req = urllib.request.Request(url, headers={"Authorization": "Bearer " + tok, "Accept": "application/fhir+json"})
    return json.load(urllib.request.urlopen(req, context=ctx))
for q in [{"identifier": "MRN-24017"}, {"family": "الأحمد"}, {"family": "الاحمد"}, {"given": "نورة"}, {"given": "نوره"}, {"name": "نو"}, {"family": "alahmad"}]:
    b = get("Patient", **q)
    print(q, b.get("total"), [e["resource"]["id"][:8] for e in b.get("entry", [])])
p = get("Patient", identifier="MRN-24017")["entry"][0]["resource"]
print(json.dumps({k: p.get(k) for k in ["name", "identifier", "gender", "birthDate"]}, ensure_ascii=False, indent=1))
e = get("Encounter", patient=p["id"])["entry"][0]["resource"]
print(json.dumps({k: e.get(k) for k in ["status", "class", "type", "reasonCode", "period"]}, ensure_ascii=False))
{'identifier': 'MRN-24017'} 2 ['a341415d', 'a3414173']
{'family': 'الأحمد'} 2 ['a341415d', 'a3414173']
{'family': 'الاحمد'} 0 []
{'given': 'نورة'} 2 ['a341415d', 'a3414173']
{'given': 'نوره'} 0 []
{'name': 'نو'} 2 ['a341415d', 'a3414173']
{'family': 'alahmad'} 0 []
{
 "name": [
  {
   "use": "official",
   "family": "الأحمد",
   "given": [
    "نورة",
    "عبدالله"
   ],
   "prefix": [
    "Mrs."
   ]
  }
 ],
 "identifier": [
  {
   "use": "official",
   "type": {
    "coding": [
     {
      "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
      "code": "PT"
     }
    ]
   },
   "system": "http://terminology.hl7.org/CodeSystem/v2-0203",
   "value": "MRN-24017"
  }
 ],
 "gender": "female",
 "birthDate": "1984-03-12"
}
{"status": "finished", "class": {"system": "http://terminology.hl7.org/CodeSystem/v3-ActCode", "code": "AMB", "display": "ambulatory"}, "type": [{"coding": [{"system": "http://snomed.info/sct", "code": "185349003", "display": "Encounter for check up (procedure)"}]}], "reasonCode": [{"text": "عطش شديد وكثرة التبول منذ شهرين"}], "period": {"start": "2026-11-16T09:00:00+00:00"}}

في المخرج أعلاه لاحظ التالي:

  • البحث بالمعرف رجع مريضتين، وهذا هو التكرار الذي صنعناه. والتطبيق الذي يأخذ أول نتيجة دون أن ينظر إلى total سوف يكتب في ملف عشوائي من الاثنين.
  • البحث بالعربية يعمل بالشكل المحفوظ، ويطابق بداية الاسم نو، ولكن «الاحمد» دون همزة و«نوره» بالهاء لا تجد شيئاً، وهي نفس المشكلة التي حللناها في HAPI بمعامل بحث مخصص، ولا يوجد في OpenEMR مكان لمثل هذا المعامل، فالتوحيد يجب أن يكون في تطبيقك أو في طريقة إدخال الأسماء.
  • الاسم بالحروف اللاتينية alahmad لم يجد شيئاً، لأن OpenEMR يحفظ اسماً واحداً لكل مريض، أما FHIR فيقبل عدة أسماء بلغات مختلفة. فإذا احتجت الاسم الإنجليزي للتقارير الدولية أو للتأمين فستحتاج حقلاً إضافياً.
  • المعرف رجع بالنظام http://terminology.hl7.org/CodeSystem/v2-0203، وهذا نظام أنواع المعرفات وليس مساحة أرقام العيادة. أي أن رقم الملف من عيادتنا ورقم ملف من عيادة أخرى سيبدوان من نفس المصدر، وقد شرحنا في مقال FHIR لماذا يجب أن يكون لكل جهة نظام خاص.
  • الزيارة كانت 09:00 بتوقيت الرياض في ذهن من أدخلها، ورجعت 09:00:00+00:00 أي بتوقيت غرينتش، لأن المنطقة الزمنية للسيرفر لم تضبط. والتطبيق الذي يعرض هذا الوقت بتوقيت المستخدم سيعرضه 12:00 ظهراً. لذلك اضبط المنطقة الزمنية في إعدادات OpenEMR وفي الـ Container قبل أول زيارة حقيقية.

وهناك تفصيلة أخرى رأيناها عندما قرأنا الرد المحفوظ في سجل الـ API لطلب البحث بالمعرف: الحزمة Bundle رجعت بالنوع "type":"collection"، والمعيار يقول إن نتيجة البحث نوعها searchset، وفيه تحمل كل نتيجة حقل search.mode الذي يفرق بين المطابق والملحق كما رأينا في HAPI. فالمكتبة التي تتحقق من نوع الحزمة بصرامة قد ترفض الرد، والتطبيق الذي يعتمد على search.mode لن يجده.

ثم قرأنا الوصفة كمورد MedicationRequest:

{"status": "active", "intent": "order", "medicationCodeableConcept": {"text": "Metformin 500 MG Oral Tablet"}, "dosageInstruction": [{"timing": {"code": {"coding": [{"system": "http://terminology.hl7.org/CodeSystem/v3-GTSAbbreviation", "code": "BID", "display": "BID"}], "text": "Twice daily (bis in die) - Two times a day at institution specified time"}}, "route": {"coding": [{"system": "http://ncicb.nci.nih.gov/xml/owl/EVS/Thesaurus.owl", "code": "C38288", "display": "Per Oris"}], "text": "Per Oris"}, "doseAndRate": [{"doseQuantity": {"value": 500, "unit": "mg", "system": "http://unitsofmeasure.org", "code": "mg"}}]}], "dispenseRequest": {"numberOfRepeatsAllowed": 0, "quantity": {"value": 60, "unit": "mg", "system": "http://unitsofmeasure.org", "code": "mg"}}, "encounter": {"reference": "Encounter/a3414173-ff68-4c79-97e0-094b3e223790", "type": "Encounter"}}

التكرار BID وطريق الفم مرمزان بشكل صحيح، والزيارة مربوطة. ولكن ثلاثة أشياء تغيرت في الطريق: الكمية المصروفة صارت 60 mg بدل 60 حبة، أي أن الوحدة أخذت من قوة الدواء وطبقت على الكمية، وإعادة الصرف صارت numberOfRepeatsAllowed: 0 مع أننا أدخلنا 2، والدواء نص دون رمز لأننا لم نختره من RxNorm. والصيدلية أو المنصة الوطنية التي تقرأ هذا المورد سوف تفهم وصفة مختلفة عما كتبه الطبيب. والدرس هنا عام: لا تثق في أي واجهة FHIR من أي نظام حتى تقرأ المورد الذي تخرجه وتقارنه بما أدخلته في الشاشة، حقلاً حقلاً، وهذا ما يسميه فريق التكامل اختبار المطابقة، ويجب أن يكون قبل أي ربط مع جهة خارجية.

جدول من جداول OpenEMR إلى موارد FHIR: رقم الملف MRN-24017 في pubpid رجع كمعرف بنظام v2-0203 وهو نظام أنواع المعرفات، ونفس المريضة مرتين بنفس الرقم رجعت total 2 لأن الـ API لم يمنع التكرار، والزيارة 09:00 رجعت T09:00:00+00:00 لأن المنطقة الزمنية للسيرفر UTC، والوصفة 60 حبة مع تكرار مرتين رجعت quantity 60 mg وnumberOfRepeatsAllowed 0، والدواء نص دون رمز RxNorm، والبحث بالاحمد دون همزة رجع صفراً
ما أدخلناه، وما حفظ، وما رجع من FHIR

وأخيراً طلبنا ملاحظات المريضة Observation، وهو نطاق لم نسجل العميل به:

{"error":"An error occurred","message":"Unauthorized","code":0}
401

والنتيجة صحيحة، فالنطاقات هي ما يحد من وصول التطبيق، وعلى كل تطبيق أن يطلب أقل ما يحتاجه. وتذكر أن الإصدار 8.4.0 أغلق ثغرة حرجة GHSA-6xh3-fmm5-jjp4 كانت فيها أخطاء في معالجة النطاقات تسمح بقراءة وكتابة بيانات المرضى دون مصادقة، فالنطاقات تحميك فقط إذا كان الإصدار الذي تشغله قد أصلح أخطاءها.

سجل التدقيق Audit Log: من فعل ماذا؟

OpenEMR يسجل الأحداث في جدولين: log لكل ما يحدث في النظام، وapi_log لطلبات الواجهات. وبعد كل ما فعلناه كان فيهما:

count(*)
404
event	count(*)
http-request-select	163
http-request-update	96
api	49
other-insert	30
other-update	20
login	17
security-administration-insert	13
view	8
patient-record-insert	4
security-administration-update	1
order-insert	1
other-delete	1
id	date	event	user	patient_id	success	c
334	2026-11-18 13:06:06	http-request-update	admin	1	1	L2NvbnRyb2xsZXIucGhwP3ByZXNjcmlwdGlvbiZlZGl0JmlkPSZwaWQ9MQ==
333	2026-11-18 13:05:58	http-request-select	admin	1	1	L2NvbnRyb2xsZXIucGhwP3ByZXNjcmlwdGlvbiZlZGl0JmlkPSZwaWQ9MQ==

404 حدثاً في جلسة مختبر قصيرة، أغلبها طلبات صفحات، وكل سطر فيه المستخدم ورقم المريض والنتيجة، والتعليق مشفر بصيغة Base64 وفيه رابط الصفحة: فك السطر 334 يعطي /controller.php?prescription&edit&id=&pid=1، أي حفظ الوصفة. وهذا يكفي لتعرف من فتح ملف أي مريض ومتى، وهو المطلوب في أي تدقيق كما شرحنا في مقال سجل التدقيق. أما سجل الـ API فوجدنا فيه شيئاً يحتاج قراراً:

id	client_id	len	has_name
25	6UJPeMvkOqVECoBjpyd4GLn2cR7_aj_IZqO6f73kLrs	5094	0
26	6UJPeMvkOqVECoBjpyd4GLn2cR7_aj_IZqO6f73kLrs	1380	0
gl_name	gl_value
api_log_option	2

الطلب 25 هو البحث عن المريضة بالمعرف، والعمود response فيه 5094 حرفاً، وعندما قرأناه وجدنا رد FHIR كاملاً بالأسماء والتواريخ (والأسماء العربية مكتوبة بصيغة \u فلم يطابقها البحث النصي البسيط has_name). والسبب أن الإعداد api_log_option قيمته 2 أي التسجيل الكامل. والنتيجة أن كل بيانات المرضى التي تقرأ عبر الـ API تتكرر في جدول السجل، فيكبر بسرعة، ويصبح نسخة ثانية من السجل الطبي بصلاحيات وصول مختلفة. ولاحظنا أيضاً أن patient_id في هذا الجدول 0 لطلبات FHIR التي تخص مريضة محددة، فلا تستطيع أن تسأل الجدول من قرأ ملف هذه المريضة عبر FHIR دون أن تفكك الروابط. لذلك قرر مستوى التسجيل بوعي: سجل الطلب دون الرد إن كان ذلك يكفي متطلباتك، واحم جدول السجل كما تحمي البيانات نفسها، وضع له سياسة حفظ.

الصلاحيات Access Control: من يرى ماذا؟

كل ما فعلناه في المختبر كان بحساب المدير، وهذا ما لا يحدث في عيادة. والصلاحيات في OpenEMR مبنية على مكتبة phpGACL، وفي القاعدة 24 جدولاً تبدأ بـ gacl، والمجموعات الجاهزة فيها كما يلي:

OpenEMR Users|Administrators|Clinicians|Physicians|Front Office|Accounting|Emergency Login|

أي المدير، والطبيب، والممارس الصحي، والاستقبال، والمحاسبة، ومجموعة الدخول الطارئ Emergency Login التي تعطي صلاحيات واسعة في حالة طارئة ويجب أن يراجع كل استخدام لها. وابدأ من هذه المجموعات: موظف الاستقبال يسجل المرضى والمواعيد ولا يقرأ الملاحظات السريرية، والمحاسب يرى الفواتير ولا يرى التشخيص إلا بقدر ما يحتاج، وحساب التكامل مجموعة خاصة بنطاقات الـ API التي يحتاجها فقط. ولاحظ أن عدداً من ثغرات الإصدار 8.5.0 كان في فحص هذه الصلاحيات نفسها، فلا تعتمد على الصلاحيات وحدها لعزل البيانات الحساسة، وفعل التحقق الثنائي MFA لكل حساب.

النسخ الاحتياطي Backup: القاعدة والمفاتيح

docker exec -e MYSQL_PWD=$DB_ROOT_PASSWORD hi2-emr-db sh -c 'mariadb-dump -uroot --single-transaction --routines --triggers openemr | gzip > /tmp/openemr.sql.gz; ls -l /tmp/openemr.sql.gz'
docker run --rm -v hi2-emr-sites:/s:ro debian:trixie-slim sh -c 'du -sh /s; ls /s/default/documents/certificates'
-rw-r--r-- 1 root root 4326428 Nov 18 13:08 /tmp/openemr.sql.gz
496K	/s
README.md
oaprivate.key
oapublic.key

الخيار --single-transaction يأخذ نسخة متسقة من جداول InnoDB دون إيقاف النظام، وقد شرحناه في مقال نسخ قواعد البيانات بشكل متسق. والنسخة 4.3 ميغابايت مضغوطة لقاعدة شبه فارغة، وأغلبها بيانات التثبيت مثل القوائم والترجمات. أما الـ Volume فحجمه صغير الآن، ولكن فيه المفتاحان اللذان يوقع بهما OpenEMR توكنات OAuth2. فإذا استعدت القاعدة وحدها على سيرفر جديد، فسوف يولد مفاتيح جديدة، وتبطل كل التوكنات وجلسات التطبيقات المتصلة، وفيه أيضاً كل المستندات التي يرفعها الموظفون مثل التقارير الممسوحة. لذلك النسخة هي القاعدة والـ Volume معاً، وتعامل مع ملفات المفاتيح كأسرار: لا تضعها في مستودع، ولا في نسخة غير مشفرة.

مخطط ما ينسخ وأين يسجل OpenEMR: القاعدة بالأمر mariadb-dump --single-transaction بحجم 4.3 ميغابايت مضغوطة لقاعدة 41.5 ميغابايت، والـ Volume بحجم 496 كيلوبايت وفيه مفاتيح OAuth2 oaprivate.key وoapublic.key، والجدول log بـ 404 حدثاً والتعليق مشفر Base64، والجدول api_log يحفظ الرد كاملاً مع api_log_option 2 وpatient_id 0 لطلبات FHIR
ما تنسخه، وأين يسجل النظام ما حدث

الإصدارات والثغرات: لماذا 8.5.0 وليس أقدم؟

صدر OpenEMR 8.5.0 في 26 أكتوبر 2026، وملاحظات الإصدار فيها قسم للإصلاحات الأمنية بأعداد كبيرة: 6 ثغرات حرجة Critical و32 عالية High و45 متوسطة و1 منخفضة، كلها منشورة في صفحة التنبيهات الأمنية للمشروع. ومنها حقن SQL، وتنفيذ أوامر عن بعد عبر رفع ملفات، وثغرات في الصلاحيات مثل GHSA-cwpg-qv34-gx8x التي كانت فيها نقاط إنشاء المرضى والبحث عنهم دون فحص صلاحيات المستخدم. والعدد الكبير لا يعني أن المشروع سيئ، وإنما يعني أن هناك من يبحث ويبلغ ويصلح بشكل علني، وهذا أفضل من نظام لا تعرف عنه شيئاً. ولكنه يعني أيضاً أمرين عمليين: أن تشغيل إصدار قديم من OpenEMR على الإنترنت مخاطرة حقيقية، وأن خطة الترقية يجب أن تكون جزءاً من التشغيل من اليوم الأول.

والـ Image الرسمية تنشر وسماً لكل إصدار، ووسماً بتاريخ البناء مثل 8.5.0-2026-11-18 حتى تثبت بناءً محدداً، لأن نفس الإصدار يعاد بناؤه عند تحديث النظام الأساسي. وفي الإنتاج اجمع بين الأمرين: ثبت الوسم بالتاريخ، وراقب صفحة التنبيهات، وعندما يصدر إصلاح اختبر الترقية على نسخة من القاعدة أولاً.

وماذا عن OpenMRS؟

OpenMRS مشروع مختلف في فلسفته، ورأينا أن نشغله بنفس الطريقة لنقارن ما نراه وليس ما نقرؤه. والتوزيعة المرجعية للإصدار الثالث في مستودعها الرسمي أربع Images: قاعدة MariaDB، والخلفية Backend بلغة Java فيها نواة OpenMRS ووحداتها، والواجهة Frontend وهي ملفات ثابتة يخدمها nginx، وبوابة Gateway وهي nginx آخر يجمع الاثنين تحت عنوان واحد. واستخدمنا نسخة الخلفية 3.8.0-no-demo التي لا تولد مرضى تجريبيين، لأن النسخة الأخرى تقضي وقتاً طويلاً بعد التشغيل في توليد المرضى والملاحظات:

name: hi2-omrs
services:
  gateway:
    image: openmrs/openmrs-reference-application-3-gateway:3.8.0
    container_name: hi2-omrs-gateway
    depends_on: [frontend, backend]
    ports:
      - "127.0.0.1:9585:80"
  frontend:
    image: openmrs/openmrs-reference-application-3-frontend:3.8.0
    container_name: hi2-omrs-frontend
    environment:
      SPA_PATH: /openmrs/spa
      API_URL: /openmrs
      SPA_CONFIG_URLS: /openmrs/spa/config-core_demo.json
      SPA_DEFAULT_LOCALE: ar
    depends_on: [backend]
  backend:
    image: openmrs/openmrs-reference-application-3-backend:3.8.0-no-demo
    container_name: hi2-omrs-backend
    depends_on: [db]
    environment:
      OMRS_CONFIG_MODULE_WEB_ADMIN: "true"
      OMRS_CONFIG_AUTO_UPDATE_DATABASE: "true"
      OMRS_CONFIG_CREATE_TABLES: "true"
      OMRS_CONFIG_CONNECTION_SERVER: db
      OMRS_CONFIG_CONNECTION_DATABASE: openmrs
      OMRS_CONFIG_CONNECTION_USERNAME: openmrs
      OMRS_CONFIG_CONNECTION_PASSWORD: ${DB_PASSWORD}
    volumes:
      - hi2-omrs-data:/openmrs/data
  db:
    image: mariadb:11.4.13
    container_name: hi2-omrs-db
    command: "mariadbd --character-set-server=utf8mb4 --collation-server=utf8mb4_general_ci"
    environment:
      MARIADB_DATABASE: openmrs
      MARIADB_USER: openmrs
      MARIADB_PASSWORD: ${DB_PASSWORD}
      MARIADB_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
    volumes:
      - hi2-omrs-db:/var/lib/mysql
volumes:
  hi2-omrs-data: { name: hi2-omrs-data }
  hi2-omrs-db: { name: hi2-omrs-db }
networks:
  default: { name: hi2-omrs-net }

والملف الرسمي يستخدم MariaDB 10.11، واستخدمنا 11.4 الموجودة عندنا، فظهرت في السجل أسطر من مستوى INFO فيها Unknown column 'RESERVED' in 'WHERE' عندما تسأل مكتبة Liquibase القاعدة عن الكلمات المحجوزة، ولم تمنع التشغيل، ولكن استخدم في الإنتاج الإصدار الذي يختبره المشروع. والفرق الكبير عن OpenEMR في وقت التشغيل الأول: بدأ Tomcat في 14 ثانية، ثم احتاجت النواة قرابة 21 دقيقة حتى كتبت Done refreshing Context، وهي تنشئ مئات الجداول وتشغل تغييرات Liquibase لكل وحدة، ثم أجابت الواجهة بالرمز 200 بعد دقيقتين أخريين، وقبل ذلك كانت تحول كل طلب إلى صفحة الإعداد /openmrs/initialsetup. فلا تحكم على التثبيت بأنه معطل قبل أن ترى هذا السطر. ثم سألنا الخلفية عما فيها بسكربت Python صغير يستدعي الـ REST وFHIR:

python probe.py
locale en allowed ['en', 'en-GB', 'es', 'fr', 'it', 'pt']
fhir 4.0.1 {'name': 'HAPI FHIR Server', 'version': '5.7.9'} 24
modules 30 [('emrapi', '3.5.1'), ('fhir2', '4.3.0'), ('idgen', '5.0.4'), ('initializer', '2.12.1'), ('openconceptlab', '4.0.0'), ('webservices.rest', '3.6.0.a57eab')]
concept search 200 []
id types ['Old Identification Number', 'OpenMRS Identification Number']
id sources []
login locations []

في المخرج أعلاه لاحظ التالي:

  • اللغات المسموحة في هذا التوزيع ست، والعربية ليست منها، مع أننا طلبنا العربية في المتغير SPA_DEFAULT_LOCALE، فبقيت الواجهة بالإنجليزية واتجاهها من اليسار. واللغات في OpenMRS إعداد عام يضاف ومعه ملفات ترجمة لكل وحدة، وهذا عمل تبنيه التوزيعة الوطنية وليس شيئاً يأتي جاهزاً.
  • واجهة FHIR تأتي من وحدة fhir2 بالإصدار 4.3.0 المبنية على مكتبة HAPI، وفيها 24 نوعاً من الموارد، والواجهة REST من وحدة أخرى. فكل قدرة في OpenMRS وحدة Module تثبت أو تزال، و30 وحدة تعمل في هذا التوزيع.
  • البحث عن مفهوم «diabetes» رجع فارغاً، فقاموس المفاهيم في التوزيع دون البيانات التجريبية فيه 66 مفهوماً فقط عند هذه اللحظة، ولا توجد مصادر لتوليد أرقام المرضى ولا مواقع للدخول. أي أن OpenMRS دون محتوى منصة فارغة، والمحتوى من قاموس مفاهيم مثل CIEL ونماذج وإعدادات يأتي من التوزيعة التي تبنيها أو تختارها.

وظهر أثر النقطة الأخيرة فوراً عند الدخول إلى الواجهة: رسالة No login locations configured، لأن المستخدم في OpenMRS يدخل في موقع محدد، والتوزيع الفارغ لا يحتوي موقعاً بالوسم Login Location. فقرأنا الوسوم الموجودة، ثم أنشأنا موقعاً بالـ REST API ووسمناه:

['Admission Location', 'Appointment Location', 'Dispensary', 'Facility Location', 'Login Location', 'Main Pharmacy', 'Main Store', 'Queue Location', 'Transfer Location', 'Visit Location']
201 85504882-c463-4f9d-92e5-6453d4ad2729 عيادة الباطنة ['Login Location']

ثم سجلنا نفس المريضة الوهمية مرتين بنفس رقم الملف، كما فعلنا في OpenEMR، وبحثنا عنها في FHIR:

1 201 5175d4c4-db7e-4a58-bb9a-ed99661a0711 MRN-24017 - نورة عبدالله الأحمد
2 400 {"error": {"message": "Invalid Submission", "code": "webservices.rest.error.invalid.submission", "globalErrors": [{"code": "Identifier MRN-24017 already in use by another patient", "message": "Identifier MRN-24017 already in use by another patient"}], "fieldErrors": {}}}
{'identifier': 'MRN-24017'} 200 1 ['5175d4c4']
{'family': 'الأحمد'} 200 1 ['5175d4c4']
{'family': 'الاحمد'} 200 0 []
{'given': 'نوره'} 200 0 []
{'name': 'نو'} 200 1 ['5175d4c4']

وهنا فرق واضح: OpenMRS رفض المريضة الثانية بالرمز 400 والسبب Identifier MRN-24017 already in use by another patient، لأن نوع المعرف فيه قاعدة تفرد، أما OpenEMR فأنشأ ملفاً ثانياً. ومشكلة الهمزة نفسها في الاثنين، فهي ليست مشكلة نظام بعينه، وإنما مشكلة كل نظام لا يوحد الحروف العربية قبل البحث. والصورة التالية من ملف المريضة في الواجهة O3 بعد الدخول في الموقع الجديد، والاسم العربي يظهر صحيحاً، وصورة المريضة الافتراضية أخذت الحروف الأولى «نعا»:

لقطة من ملف المريضة في OpenMRS 3 بالواجهة الإنجليزية: الشريط العلوي فيه الموقع عيادة الباطنة، ورأس الملف نورة عبدالله الأحمد Female بعمر 42 سنة وتاريخ الميلاد 12-Mar-1984 والمعرف Old Identification Number MRN-24017 وصورة افتراضية بالحروف نعا، والقائمة الجانبية Patient summary وVitals وMedications وOrders وResults وVisits وAllergies وConditions، والبطاقات فارغة
ملف المريضة في OpenMRS 3.8.0: الاسم العربي صحيح، والواجهة بالإنجليزية

والجدول التالي يلخص المقارنة بين النظامين كما رأيناهما:

OpenEMR 8.5.0OpenMRS 3.8.0
الفكرةنظام عيادات جاهزمنصة تبني عليها توزيعتك
التقنيةPHP وApache وMariaDBJava وTomcat وMariaDB، وواجهة من وحدات صغيرة
أول تشغيلقرابة 4 دقائققرابة 23 دقيقة
العربيةمفعلة ومن اليمين إلى اليسار، ونصفها مترجمغير مفعلة في التوزيع المرجعي
تكرار المريضقبله الـ APIرفضه الـ API
FHIRR4 مع US Core وSMARTوحدة fhir2 على HAPI، 24 مورداً
المحتوى الطبيقوائم ونماذج جاهزة، وفوترة أمريكيةقاموس مفاهيم ونماذج تأتي من التوزيعة

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

نقاط الضعف في OpenMRS: لا يعمل كعيادة جاهزة دون توزيعة فيها المحتوى، والتشغيل أثقل ويحتاج خبرة Java، والعربية تحتاج عملاً كاملاً في الترجمة والاتجاه، والفوترة والتأمين ليست في قلبه.

وبالتالي إذا كنت عيادة خاصة تريد نظاماً تعمل عليه الأسبوع القادم، فـ OpenEMR أقرب، مع كل ما رأيناه من تحفظات. وإذا كنت جهة تبني نظاماً لمراكز صحية كثيرة وعندك فريق تقني يبقى سنوات، فـ OpenMRS هو الأساس الأمتن. وفي الحالتين اقرأ توثيق OpenMRS 3 وتوثيق OpenEMR قبل أن تقرر.

قبل أن تختار: أسئلة لعيادة عربية

بعد كل ما رأيناه، هذه الأسئلة التي يجب أن تجيب عنها قبل أن تقرر تشغيل أي سجل سريري مفتوح المصدر في عيادة حقيقية، وكل سؤال منها خرج من خطوة في المختبر:

  • اللغة Language: من سيستخدم الواجهة، وبأي لغة؟ ومن سيصحح الترجمة ويحافظ عليها بعد كل ترقية؟
  • الهوية Identity: كيف تمنع تكرار ملف المريض؟ وهل يقبل النظام رقم الهوية الوطنية والإقامة كمعرفات بنظام واضح؟
  • الأدوية Medications: هل لديك قاعدة أدوية مرمزة تناسب السوق المحلي، أم سيكتب الأطباء الأسماء نصاً كما فعلنا؟
  • الفوترة Billing: هل تحتاج مطالبات تأمين عبر نفيس؟ ومن سيبني هذا التكامل؟
  • التكامل Integration: هل اختبرت كل مورد FHIR سوف تعتمد عليه بالمقارنة مع الشاشة؟
  • الأمن Security: من يراقب التنبيهات الأمنية ويرقي النظام؟ ومن يقرر ما يسجل وما يرسل خارج المنشأة؟
  • التشغيل Operations: من يأخذ النسخ الاحتياطية ويختبر استعادتها، ومن يتصل به الطبيب عندما يتوقف النظام في منتصف العيادة؟

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

من المختبر إلى الإنتاج Production

البندما رأيناه في المختبرماذا تفعل في الإنتاج
الإصدار8.5.0 أغلق 84 ثغرةوسم بالتاريخ، ومراقبة التنبيهات، وترقية مختبرة
الواجهة العربية48% مترجمة، وترجمات حرفيةقرار واضح بلغة الواجهة، وسكربت تصحيحات يعاد بعد الترقية
تسجيل المرضىنفس المريضة مرتين عبر الـ APIبحث قبل الإنشاء، ومفتاح Idempotency، وإجراء دمج
الوقت09:00 صارت +00:00المنطقة الزمنية في الإعدادات والـ Container
الوصفاتنص دون رمز، والكمية والتكرار تغيرا في FHIRقاعدة أدوية مرمزة، واختبار مطابقة لكل مورد
OAuth2منح كلمة المرور لعميل واحدAuthorization Code مع PKCE، ومستخدم خاص بكل تكامل
سجل الـ APIيحفظ الردود كاملةمستوى تسجيل مدروس، وحماية الجدول، وسياسة حفظ
النسخ الاحتياطيالقاعدة 4.3 MB والمفاتيح في الـ Volumeالقاعدة والـ Volume معاً، مشفرين، مع اختبار استعادة
بيانات العيادةYour Clinic Name Hereبيانات المنشأة قبل أول زيارة
نافذة التسجيلمشاركة بيانات الاستخدام محددة مسبقاًقرار من المنشأة ومسؤول حماية البيانات

أخطاء شائعة

  • البحث عن سبب invalid_client في السر: العميل لم يفعل بعد، والسبب في سجل Apache.
  • إنشاء المريض دون بحث: الواجهة لا تمنع التكرار، وإعادة الطلب تنشئ ملفاً ثانياً.
  • أخذ أول نتيجة من البحث: البحث بالمعرف رجع مريضتين.
  • الثقة في مورد FHIR دون مقارنته بالشاشة: الكمية والتكرار تغيرا في الطريق.
  • اختبار الأسماء العربية من سطر أوامر Windows: الترميز يتغير قبل أن يصل الطلب.
  • نسخ القاعدة دون الـ Volume: المفاتيح والمستندات تضيع.
  • ترك التسجيل الكامل للـ API دون قرار: نسخة ثانية من بيانات المرضى في جدول السجل.
  • تشغيل إصدار قديم على الإنترنت: عشرات الثغرات المنشورة بتفاصيلها.

تنظيف المختبر

docker compose down -v

الخيار -v يحذف القاعدة والمستندات والمفاتيح، فلا تستخدمه على نظام فيه بيانات.

تدريب عملي

  • اضبط المنطقة الزمنية في OpenEMR على الرياض، وأنشئ زيارة جديدة، ثم اقرأها من FHIR وقارن الحقل period.start.
  • صحح ترجمة «Back» و«Allergies» من صفحة اللغات، ثم اكتب نفس التصحيح كسكربت SQL يعاد بعد الترقية.
  • اكتب دالة في تطبيقك تبحث بالمعرف قبل إنشاء المريض، وترفض إذا رجع أكثر من نتيجة، ثم جربها على المريضة المكررة.
  • غير api_log_option إلى مستوى لا يحفظ الرد، وأعد البحث، وقارن طول العمود response.

الخلاصة

وصلنا لنهاية الموضوع، وأهم ما فيه:

  • OpenEMR نظام عيادات متكامل بلغة PHP فيه FHIR وSMART، وOpenMRS منصة بلغة Java يبني عليها كل بلد نظامه بقاموس مفاهيم.
  • OpenEMR 8.5.0 يعمل بالـ Image الرسمية مع MariaDB في أربع دقائق أول مرة، والواجهة العربية من اليمين إلى اليسار ولكن 48% منها مترجم وفيها ترجمات حرفية.
  • العميل في OAuth2 معطل حتى يوافق المدير، والرسالة invalid_client لا تقول ذلك، ومنح كلمة المرور للمختبر فقط.
  • الواجهة أنشأت نفس المريضة مرتين، وFHIR أخرج الوقت بتوقيت غرينتش والكمية بوحدة خاطئة والتكرار صفراً.
  • سجل التدقيق يسجل كل صفحة، وسجل الـ API يحفظ الردود كاملة، والنسخة الاحتياطية هي القاعدة مع مفاتيح الـ Volume.
  • الإصدار 8.5.0 أغلق 84 ثغرة منشورة، فخطة الترقية جزء من التشغيل.
دليلالمستشفى من الداخل: خريطة الأنظمة HIS وEMRما هي أنظمة المستشفى من التسجيل والسجل الطبي إلى المختبر والأشعة والصيدلية والفوترة، وكيف تتصل ببعضها، ومن أين تبدأ.دليلتبادل البيانات الصحية بين الأنظمة: HL7 وFHIRكيف تنتقل نتائج المختبر وبيانات المريض بين أنظمة المستشفى برسائل HL7 وواجهات FHIR، وكيف تبني ذلك وتختبره بنفسك.دليلخادم FHIR على سيرفرك: تجربة عملية مع HAPI FHIRكيف تشغل سيرفر FHIR يحفظ في PostgreSQL ويتحقق من البيانات بدليل نفيس، مع البحث بالأسماء العربية والنسخ والمعاملات.دليلالمصطلحات الطبية الموحدة: ICD وSNOMED CT وLOINCكيف تفهم الآلة أن الأسماء الطبية المختلفة مفهوم واحد، وكيف تختار نظام الرموز المناسب للتشخيص والتحليل والدواء، برموز حقيقية.دليلالمنصات الصحية في السعودية: نفيس NPHIES وصحتي ووصفتيمن يملك كل منصة صحية وطنية وماذا تفعل، من صحتي ومستشفى صحة الافتراضي إلى نفيس والسجل الموحد، وما يعنيه ذلك لمن يبني نظاماً.دليلأرشيف الصور الطبية PACS على سيرفرك مع Orthancكيف تشغل أرشيف صور طبية يستقبل من أجهزة الأشعة ويخدم غرفة القراءة وقوائم العمل، مع قياس الضغط وإغلاق الأرشيف أمام الأجهزة المجهولة.دليلنظام المختبر LIS مفتوح المصدر: SENAITE وOpenELISكيف تمر العينة في نظام مختبر مفتوح المصدر من الطلب والملصق إلى النتيجة والاعتماد والتقرير، وكيف تصل نتائج الأجهزة برسائل HL7 v2 عبر برنامج وسيط.دليلشرح OAuth وOpenID Connect للمبتدئينلماذا لا يجب أن يعرف أي تطبيق كلمة مرورك، وكيف يحل OAuth ذلك بتوكنات محدودة، وكيف يضيف OpenID Connect الدخول الموحد.

سجل التحديثات

  • 2026-11-18: كتابة المقال، وتنفيذ المختبر على OpenEMR 8.5.0 (openemr/openemr:8.5.0) مع PHP 8.5.12 وApache 2.4.71 وMariaDB 11.8.9، وOpenMRS 3.8.0 (النواة 2.8.10 مع وحدة fhir2 4.3.0) بالتوزيعة المرجعية دون بيانات تجريبية مع MariaDB 11.4.13، على Docker Engine 29.8.0.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.