في مقال المستشفى من الداخل عرفنا السجل السريري الإلكتروني 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
الصورة التالية تبين مكونات المختبر:

والإعداد مبني على المثال في توثيق الـ 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 مهم عند الترقية، لأن سكربتات الترقية تعرف منه من أي نسخة تبدأ، فلا تنسخ قاعدة من إصدار إلى آخر دون أن تمر بها.
الواجهة العربية: الاتجاه صحيح والترجمة نصفها
في صفحة الدخول قائمة لغات، والعربية فيها، فاخترناها ودخلنا بحساب المدير. والصورة التالية أول ما ظهر:

في الصورة ثلاث ملاحظات. الأولى أن الاتجاه انقلب فعلاً، فالقائمة تبدأ من اليمين والتقويم في اليمين، والسبب أن العربية معرفة في جدول اللغات بالحقل 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%، وهي أكثر من الإسبانية والألمانية في نفس القاعدة. وهذا يفسر الخليط في الشاشات: الأجزاء القديمة الأساسية مترجمة، والأجزاء الأحدث مثل فريق الرعاية وخطط الرعاية بالإنجليزية. ثم فتحنا لوحة المريض بعد أن سجلناها:

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

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

ثم أعدنا نفس الطلب، وفككنا التوكن لنرى ما فيه:
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، فكل ما سوف نفعله بهذا التوكن يسجل باسمه، وفي الإنتاج يجب أن يكون للتكامل مستخدم خاص به بصلاحيات محدودة.

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

ولاحظ في الصورة عبارة «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 من أي نظام حتى تقرأ المورد الذي تخرجه وتقارنه بما أدخلته في الشاشة، حقلاً حقلاً، وهذا ما يسميه فريق التكامل اختبار المطابقة، ويجب أن يكون قبل أي ربط مع جهة خارجية.

وأخيراً طلبنا ملاحظات المريضة 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 معاً، وتعامل مع ملفات المفاتيح كأسرار: لا تضعها في مستودع، ولا في نسخة غير مشفرة.

الإصدارات والثغرات: لماذا 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.pylocale 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 بعد الدخول في الموقع الجديد، والاسم العربي يظهر صحيحاً، وصورة المريضة الافتراضية أخذت الحروف الأولى «نعا»:

والجدول التالي يلخص المقارنة بين النظامين كما رأيناهما:
| OpenEMR 8.5.0 | OpenMRS 3.8.0 | |
|---|---|---|
| الفكرة | نظام عيادات جاهز | منصة تبني عليها توزيعتك |
| التقنية | PHP وApache وMariaDB | Java وTomcat وMariaDB، وواجهة من وحدات صغيرة |
| أول تشغيل | قرابة 4 دقائق | قرابة 23 دقيقة |
| العربية | مفعلة ومن اليمين إلى اليسار، ونصفها مترجم | غير مفعلة في التوزيع المرجعي |
| تكرار المريض | قبله الـ API | رفضه الـ API |
| FHIR | R4 مع 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.