إنشاء تقارير شهرية على نمط وزارة الصحة من نظام إدارة عيادتك

في المشهد الصحي المتطور بسرعة في مصر، التقارير الدقيقة وفي الوقت المناسب لوزارة الصحة (MOH) بقت إلزامية – مش اختيارية – وده بيأثر مباشرة على التمويل، الترخيص، ومبادرات الصحة العامة. الدليل ده هيمشيك خطوة بخطوة على إعداد نظام إدارة عيادة (CMS) عادي لتوليد مجموعات البيانات المطلوبة من وزارة الصحة، مع نصائح عملية تقدر تطبقها يوم الاثنين الصبح.

---

1. فهم إطار تقارير وزارة الصحة

1.1 العناصر الأساسية للبيانات المطلوبة من وزارة الصحة

وزارة الصحة المصرية بتنشر نموذج تقارير شهري بيشمل:

• بيانات ديموغرافية للمريض (العمر، الجنس، الجنسية)
• نوع الزيارة (خارجية، طوارئ، استشارة عن بُعد)
• أكواد التشخيص (ICD‑10‑CM) وأكواد الإجراءات (CPT/HCPCS)
• إيرادات الخدمة (نقد، تأمين، معاملات Paymob)
• صرف الأدوية وتغييرات مخزون الصيدلية
• مؤشرات الأداء الرئيسية (KPIs) زي متوسط وقت الانتظار ونسبة عدم الحضور

1.2 التردد وقنوات الإرسال

• التردد: أول يوم عمل من كل شهر للبيانات الخاصة بالشهر السابق.
• القنوات: بوابة آمنة على منصة e‑Health للوزارة، أو عبر تكامل API للشبكات الكبيرة.
• التحقق: تحقق تلقائي بالـ checksum؛ التقارير اللي ما تنجحش التحقق تُرفض خلال 24 ساعة.

1.3 التداعيات القانونية والمالية

عدم الالتزام ممكن يؤدي إلى:

• إيقاف تجديد رخصة العيادة.
• تأخير في استرداد المدفوعات من هيئة التأمين الصحي (HIO).
• غرامات تتراوح بين 5,000 و30,000 جنيه لكل تقرير مفقود.

---

2. تجهيز نظام إدارة العيادة (CMS)

2.1 التحقق من توافق النظام

2.2 ربط حقول وزارة الصحة بنموذج البيانات الداخلي

1. اعمل جدول ربط – اكتب كل عمود من وزارة الصحة على اليسار وحقل نظامك على اليمين.
2. حدد الفجوات – مثال: لو نظامك ما بيسجلش جنسية المريض، ضيف قائمة منسدلة إلزامية في نموذج التسجيل.
3. توحيد الترميز – فعل اختيار ICD‑10‑CM من جدول lookup لتجنب الإدخالات النصية الحرة.

2.3 تفعيل جمع البيانات تلقائيًا

• كيوسيس تسجيل الدخول: سجل وقت الوصول لحساب KPI وقت الانتظار.
• تكامل Paymob: سجل معرفات المعاملات والمبالغ مباشرة في وحدة الفوترة.
• وحدة الاستشارة عن بُعد: علم الزيارات بعلامة “virtual” لعمود الاستشارات عن بُعد في وزارة الصحة.

---

3. إعداد وحدة التقارير

3.1 بناء الاستعلام الأساسي

استخدم view SQL مع معاملات لتجميع بيانات الشهر السابق:
sql
CREATE OR REPLACE VIEW moh_monthly_report AS
SELECT
p.id AS patient_id,
p.age,
p.gender,
p.nationality,
v.visit_date,
v.visit_type,
d.icd_code,
pr.cpt_code,
b.amount,
b.payment_method,
ph.drug_code,
ph.quantity,
TIMESTAMPDIFF(MINUTE, v.check_in, v.check_out) AS visit_duration
FROM patients p
JOIN visits v ON p.id = v.patient_id
LEFT JOIN diagnoses d ON v.id = d.visit_id
LEFT JOIN procedures pr ON v.id = pr.visit_id
LEFT JOIN billing b ON v.id = b.visit_id
LEFT JOIN pharmacy ph ON v.id = ph.visit_id
WHERE v.visit_date BETWEEN DATE_SUB(LAST_DAY(CURRENT_DATE - INTERVAL 1 MONTH), INTERVAL DAY(LAST_DAY(CURRENT_DATE - INTERVAL 1 MONTH)) - 1 DAY)
AND LAST_DAY(CURRENT_DATE - INTERVAL 1 MONTH);

العرض ده بيرجع جدول مسطح جاهز للتصدير.

3.2 جدولة مهمة التصدير

1. اعمل مهمة cron (أو Windows Task Scheduler) لتشتغل الساعة 02:00 صباحًا في اليوم الثاني من كل شهر.
2. صيغة التصدير – وزارة الصحة تقبل CSV بترميز UTF‑8. مثال أمر:

bash
mysqldump --user=report_user --password=** --skip-column-statistics \
--where="visit_date BETWEEN ..." \
--tab=/tmp/moh_report --fields-terminated-by=',' --fields-enclosed-by='"' \
your_database moh_monthly_report

1. نظام تسمية الملف – MOH_YYYYMM_ClinicCode.csv.

3.3 التحقق من التصدير

• فحص المخطط – شغّل سكريبت خفيف يقارن رؤوس الأعمدة مع قالب وزارة الصحة.
• رفع تجريبي – استخدم خاصية “Test Upload” في بوابة الوزارة لتأكد من الـ checksum.
• سجل الأخطاء – خزن أي فشل في /var/log/moh_report_errors.log للمراجعة.

---

4. رفع التقرير لوزارة الصحة

4.1 رفع يدوي عبر البوابة (العيادات الصغيرة)

1. ادخل على بوابة e‑Health للوزارة باستخدام بيانات العيادة.
2. روح لـ Reporting → Monthly Submissions.
3. اضغط Upload، اختار ملف CSV، وأكد.
4. البوابة هترجع Submission ID – سجله في نظامك للمتابعة.

4.2 رفع تلقائي عبر API (الشبكات الكبيرة)

• النقطة النهاية: https://api.moh.gov.eg/v1/reports/monthly
• المصادقة: تدفق OAuth2 client‑credentials.
• الحمولة: multipart/form‑data فيها ملف CSV وJSON manifest فيه بيانات العيادة.
• معالجة الرد: على HTTP 202 خزن report_id؛ استدعي /status/{report_id} كل 30 دقيقة لحد ما الحالة تكون accepted أو rejected.

4.3 المصالحة بعد الرفع

• مصالحة المدفوعات – طابق معرفات معاملات Paymob في التقرير مع ملف التسوية اليومي من Paymob.
• تحديث لوحة KPI – استورد التقرير المقبول من الوزارة إلى أداة الـ BI عشان يعكس الأرقام الرسمية.

---

5. الأخطاء الشائعة وإزاي نتجنبها

نصائح توثيق للطاقم الطبي

• اعمل SOP صفحة واحدة يوضح خطوات تشغيل التصدير يدويًا (مفيد لو المهمة الآلية فشلت).
• عيّن “Report Champion” – مسؤول إداري كبير يتحقق من سجل الإرسال كل شهر.
• حافظ على سجل تغييرات في ملف إعدادات CMS كل ما تعدل ربط الحقول.

---

6. أسئلة شائعة مختصرة

س1: عيادتي بتستخدم نظام قديم ما يقدرش يشغل SQL views. أعمل إيه؟

ج: صدّر الجداول الخام إلى CSV، بعدين استخدم إكسل أو أداة ETL خفيفة (مثلاً Python pandas) لإعادة تشكيل البيانات على قالب وزارة الصحة. جدولة السكريبت بـ Windows Task Scheduler.

س2: إزاي أتعامل مع مرضى يرفضوا يدوِّنوا جنسيتهم؟

ج: الوزارة بتطلب قيمة؛ استخدم “Non‑Egyptian” كخيار افتراضي وسجل رفض المريض في استمارة الموافقة.

س3: البوابة بتظهر خطأ checksum بعد الرفع. أروح أتحقق منين؟

ج: تأكد إن CSV بترميز UTF‑8 بدون BOM، وإن الحقول الرقمية مفيهاش فواصل آلاف، وإن ترتيب الأعمدة مطابق للقالب تمامًا.

س4: أقدر أرفع التقرير قبل اليوم 2 من الشهر؟

ج: أيوه، البوابة بتقبل رفع مبكر بشرط إن البيانات تمثل الشهر السابق بالكامل. الرفع المبكر ممكن يكون شبكة أمان لو المهمة الآلية فشلت.

س5: هل لازم أبلغ عن استردادات Paymob بشكل منفصل؟

ج: الاستردادات تُسجل في قسم “adjustments” في قالب وزارة الصحة. ضيف صف منفصل بمبلغ سالب ومعرف المعاملة الأصلي.

---

7. قائمة مراجعة صباحية يوم الاثنين

1. 08:00 – راجع سجل المهمة الآلية (/var/log/moh_report_job.log).
2. 08:15 – شغّل سكريبت فحص المخطط؛ صلح أي اختلاف.
3. 08:30 – ارفع CSV عبر البوابة أو فعل API؛ احفظ Submission ID.
4. 08:45 – طابق ملف تسوية Paymob مع البيانات المرفوعة.
5. 09:00 – حدّث لوحة KPI وابعت ملخص بريد إلكتروني لمدير العيادة.
6. 09:15 – أرشف CSV في المجلد الآمن reports/2024/05/ بصلاحيات قراءة‑فقط.
7. 09:30 – سجّل النشاط في سجل الامتثال للعيادة.

---

إزاي Clinit بيساعد

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