🚀

خطة النقل إلى نظام الـ ERP (ERP Migration Blueprint)

الهدف هو استيعاب نظام عيادة النساء والتوليد القديم (PHP/Smarty — 312 جدولًا بلا أي مفاتيح أجنبية) كموديول جديد Modules/Obgy داخل منظومة Moon ERP القائمة (Laravel/nwidart + Angular)، مع الاستغناء نهائيًا عن مزامنة cURL مع قاعدة الـ ERP الخارجية: يصبح المريض هو نفسه عميل الـ ERP، وتتكامل التحاليل مع موديول المعمل LIS، والصيدلية مع المخازن، والماليات مع الحسابات، والمستخدمون مع نظام الصلاحيات الموحد. المحصلة: تتقلص 312 جدولًا قديمًا إلى نحو 85 جدولًا جديدًا (~55 موديل نطاق + جدول قواميس موحد + جداول Pivot ووسائط)، مع إسقاط ~40 جدولًا ميتًا أو مشتقًا.

312 ← ~85جدول قديم ← جدول جديد

~190جدول قوائم يُدمج في lookups واحد

18جدول روشتات/تحاليل مكرر ← جدولان

8مراحل تنفيذ

أولًا: أنماط الدمج العرضية (Cross-cutting Consolidation)

النمط القديم	الحل المقترح
~190 جدول قوائم صغيرة بنفس البنية `id + title + del` (منها رباعية `ssemen/sseemen/sseemmen/sseemmeen` و24 جدول `lapar/copy` و9 جداول `mointoringsheet*`)	جدول قواميس موحد `obgy_lookups` بأعمدة `(domain, parent_id, title_ar, title_en, sort, is_active, deleted_at)`، مع تحويل القوائم الطبية الثابتة (فصائل الدم، طريقة الولادة CS/SVD/NVD، توقيت الولادة FT/PT، أنواع فقدان الحمل) إلى Enums في الكود
10 جداول روشتات مستنسخة (`ancsheetdrugs`, `mainantenentaldrugs`, `gynadrugs`, `gynasheetdrugs`, `infertilitydrugs`, `infertilitysheetdrugs`, `mointoringsheetdrugs`, `followupcarddrugs`, `operativedetailsdrugs`, `recorddrugs`)	جدولا `visit_prescriptions` + `prescription_items` بعلاقة Polymorphic نحو الشيت/الزيارة/الدورة، مع عمود المستفيد (زوجة/زوج) وكمية الصرف الفعلية
8 جداول تحاليل مستنسخة (`ancsheetinvest`, `mainantenentalinvest`, `gynainvestigation`, `gynasheetinvest`, `infertilityinvest`, `infertilitysheetinvest`, `mointoringsheetinvestigation`, `followupinvest`) + ثلاثية EAV	جدولا `visit_investigations` (LabOrder) + `lab_order_items` بعلاقة Polymorphic، مرتبطان بكتالوج موديول المعمل LIS
~40 عمودًا يخزن معرفات مفصولة بفواصل (CSV) مثل `gyna.diagnosisid` و`operations.operation`	جداول Pivot حقيقية لكل علاقة، مع تسجيل المعرفات المعلقة في سجل أخطاء الترحيل
ثلاثة أنماط حذف منطقي متضاربة (`del` / `deleted` / `conditions`) + جداول تدقيق منسوخة (`patients_updates`, `visits_updates`)	`SoftDeletes (deleted_at)` موحد + حزمة تدقيق قياسية `laravel-auditing`
نقاط AJAX عامة تستقبل اسم الجدول والعمود من المتصفح (ثغرة كتابة شاملة + حقن SQL) وواجهة موبايل بلا مصادقة	لا يُنقل أي منها: REST APIs محددة الموارد بـ FormRequests وPolicies ومصادقة Sanctum

ثانيًا: خريطة الموديلات المقترحة حسب النطاق

1) المرضى والتسجيل

الموديل المقترح	الجداول القديمة	ملاحظات الدمج
`Patient` + `ObgyPatientProfile`	`patients` (نصف الزوجة)	المريضة تصبح هي سجل المريض/العميل في الـ ERP مباشرة؛ الملف الإضافي يحمل رقم الملف (بتسلسل معاملاتي بدل MAX+1) والرقم القومي والخطورة
`Spouse`	أعمدة `husband*` في `patients`	فصل بيانات الزوج في جدول 1-1
`PreviousMarriage`	`previous_marriage` + `hus_previous_marriage`	دمج بعمود تمييز (زوجة/زوج) مع إصلاح ترميز latin1
`ObstetricBaseline`	أعمدة `pno/cs/ab/ectopic/vmodel/svd`	أرصدة افتتاحية رقمية للصيغة التوليدية
`MedicalRecord`, `DeliveryRegistration`, `MediaAttachment`	`records`, `registeration`, `patientfiles` + مجلدات الرفع	تصحيح `coast → cost decimal`؛ وسائط بجدول حقيقي وروابط موقعة
قواميس: `JobTitle`, `PersonTitle`, `Complaint`...	`wifejobs+husbandjobs`، `wifetypes+husbandtypes`، `complaint+complaintant`، `education`، `wifestatus`، `risktype`، `origin`	توحيد القوائم المزدوجة في `obgy_lookups`؛ فصائل الدم Enum؛ إسقاط `patients_tmp` و`locations` وجداول التطوير

2) المواعيد والزيارات وجسر الماليات

الموديل المقترح	الجداول القديمة	ملاحظات الدمج
`Appointment` + `Encounter`	`visits` (الحجز + الطابور) و`followupcard`	تفكيك الجدول المركب؛ ربط السجلات الإكلينيكية بـ `encounter_id` يعالج العيب البنيوي (لا يوجد ربط زيارة في أي جدول إكلينيكي)
`Service`, `VisitPeriod`, `ClinicClosure`, `TreatmentClosure`	`detections`, `visit_periods`, `vacations`, `endvisitreports`	سعة الفترات تُفحص بمعاملة قاعدة بيانات؛ تفعيل الإجازات فعليًا في منع الحجز
`PatientLedgerEntry` + `Invoice` + `Payment`	`totalbalance` + الأكواد السحرية في `visits` (‎-99 قسط / 999 سداد / 9999 مرتجع)	دفتر حساب بأنواع حركات Enum صريحة ورصيد محسوب؛ الترحيل للحسابات عبر Events
—	`old_visits`, `visits_updates`, `lastvisit`, `totalbalancepaids`	تُسقط: أرشيف ميت / تدقيق مهجور / مؤشر يُشتق بالاستعلام / جدول ميت

3) النواة الإكلينيكية المشتركة والتاريخ المرضي

الموديل المقترح	الجداول القديمة	ملاحظات الدمج
`ClinicalExamination` + `ExaminationFinding`	`examination` + 9 جداول نتائج فحص متطابقة البنية	كتالوج نتائج موحد بعمود جهاز الجسم؛ إلغاء الإنشاء التلقائي عند العرض
`Diagnosis` + Pivot	`diagnosis` + `diagnosisant`	دمج بعمود تخصص وجدول وسيط بدل CSV
`HistoryQuestion` / `HistoryAnswerOption` / `PatientHistoryAnswer`	`presenthistoryquestions/answers` + جدول `gynaph` (وقت تشغيل)	`gynaph` غير موجود في النسخة الاحتياطية — يجب تصديره من الإنتاج
`Prescription/Item` + `LabOrder/Item`	18 جدول الروشتات/التحاليل المستنسخة + ثلاثية EAV	راجع جدول الأنماط العرضية أعلاه
نماذج التاريخ المرضي: `MenstrualHistory`, `ObstetricHistory`+`ObstetricBaby`, `ContraceptionHistory`, `PastMedical/Surgical/GynecologicalHistory`, `PastArtCycle`+تفاصيل ICSI, `FamilyHistory`	جداول `ph` التسعة + `wifep`/`awifep` + الكتالوجات المزدوجة و`dm`	توحيد سجل الحمول السابقة في مصدر واحد وحساب الصيغة التوليدية كخدمة/Accessor؛ طريقة انتهاء الحمل Enum ثابت

4) متابعة الحمل وأمراض النساء

الموديل المقترح	الجداول القديمة	ملاحظات الدمج
`Pregnancy`	`ancsheet` + `mainantenental` + `followup`	دمج ثلاثة أجيال متوازية لملف الحمل في كيان واحد؛ المطابقة بالمريضة + LMP وأعلام done/endpreg
`AntenatalVisit`, `AntenatalUltrasound`, `FourDScanBooking`, `ClinicalNote`	`ancnewvisit`+`antenalvisit`+`followupvisit`، `mainantenentalus`+أعمدة T/TT-scan، `op_4d_list`، `followupdiagnosis/exam/invest`	عمر الحمل GA يُحسب ولا يُخزن؛ حالة 4D صريحة بدل أعلام البتات
`PregnancyLoss` + قوائمه, `ExternalProvider`	`wifeepc` + `wifeepctype/ttt`، `wifeobst`+`wifeepcobst`	إعادة الربط بالمريضة مباشرة بدل شيت العقم؛ إسقاط `anprotocol` اليتيم
`GynaVisit`, `GynaSheet`+`GynaSheetVisit`, `GynaUltrasound`+`Follicle`, `InfertilityProfile`+`Plan`	`gyna`، `gynasheet`+`maingyna`+`newvisitg`، `gynaus`+`gynausficils`، `gynainfertility`+أعمدة `gyna.inf_*`	القواميس التسعة الفارغة ← `obgy_lookups` مع التصدير من الإنتاج؛ إهمال شاشة `gynasheet00`

5) العقم والحقن المجهري وتحاليل الزوج

الموديل المقترح	الجداول القديمة	ملاحظات الدمج
`InfertilityFile`	`infertility` + جداوله الفرعية + `infertilitysheet` (64 عمودًا)	دمج الجيلين في ملف واحد لكل مريضة بجداول فرعية مهيكلة وPivot بدل CSV
`IvfCycle`	`ivfsheet` + `mointoringsheet`	توحيد المسارين بقيد فهرس فريد جزئي = دورة نشطة واحدة لكل مريضة
`IvfCycleVisit` + `FollicleMeasurement`	`ovst` + `mointoringsheetvisits` + `folliculom`	شبكة حويصلات مطبّعة (جانب/قطر/عدد) بدل 26 عمودًا مشفرًا
`OocyteRetrieval`, `SemenSample`, `EmbryoTransfer`, `Cryopreservation`, `EndometrialPrep`, `CycleOutcome`	أعمدة مراحل `ivfsheet` + `eprep` + جدول `sefo` (وقت تشغيل)	نمذجة المراحل كجداول فرعية؛ إسقاط `icsi` المشتق واستبداله باستعلام
`SemenAnalysis`, `AndrologyInvestigation`, `HormoneResult`+`HormoneDefinition`	`semen`+`semeninfertility`، `semen2` العريض، `hormon`+`hormonalprofile`+`hormonalprofile2`	تطبيع طولي (صف لكل فحص/هرمون) مع وحدة ومدى مرجعي وربط بـ LIS؛ حذف اليتيم `sseemmeen` وإعادة تسمية الرباعية المشوهة بعد مراجعة العيادة

6) التصوير والمناظير والعمليات

الموديل المقترح	الجداول القديمة	ملاحظات الدمج
`ImagingStudy` + `FetalScanFinding` + `GynaScanFinding`	`ultrasound(+detail)`, `ultrasoundobst(+detail)`, `ultrasoundgyna`, `tvs`, `dtvs`, `sis`, `hsg`, `hsginfertility`, `mrict`, `sonar`	رأس دراسة موحد بنوع وحالة اعتماد؛ 16 جدول مفردات ← `obgy_lookups`؛ صور وفيديو السونار ← وسائط قياسية
`AnnotatedDiagram` + `DiagramMarker`	`gtimage` + `gtdetail`	إحداثيات نسبية للعلامات
`EndoscopyProcedure` + `EndoscopyFinding` + `EndoscopyTerm`	`laparoscopy`, `hysteroscopy`, `laparoscopyinfertility`, `hysteroscopyinfertility` + 24 قائمة `lapar/copy`	نموذج واحد بحقل نوع + جدول نتائج (موضع/تصنيف) بدل 26 عمود CSV + معجم موحد
`OperativeNote`, `SurgicalBooking`, `InfertilityOperation`, `Procedure`, `AnesthesiaType`, `IncisionType`, `Hospital`, `HistopathologyFinding`, `PathologyResult`, `Location`	`operativedetails(+drugs)`, `op_wait_list`, `operations`, `operation`, `anasthesa`+`generalanasthesa`, `jncision`+`midlinejncision`, `hospitalnames`, `histopath`, `pathology`, `place`+`place2`	فريق العملية CSV ← Pivot بأدوار؛ دمج الأماكن بعمود نوع؛ إسقاط `operationids`؛ أدوية العمليات ← نظام الروشتات الموحد

7) المعمل والصيدلية والمجلس والمنصة

الموديل المقترح	الجداول القديمة	ملاحظات الدمج
`LabTestCategory` + `LabTest` (طبقة Mapping على LIS)	`investcats` (22 فئة) + `invests` (276 بندًا) + EAV المخصص	كل بند قديم يُربط ببند كتالوج LIS عبر `obgy_lis_test_map`؛ إسقاط `investigations` القديم و`excelinfo` (ترخيص)
`Drug`, `DrugCategory`, `DosageForm`, `Supplier`, `PurchaseInvoice/Item`, `StockMovement`	`drugs` (~2000)، `importbill`+`importdetails`، `pharmacystore`، `recepittmp`+`receiptdrugs`	كتالوج الأصناف والمخزون يُسند لاحقًا لموديول مخازن الـ ERP؛ دفتر حركات برصيد محسوب يمنع السالب؛ إسقاط `drugdos` و`importtdetails`
`BoardRequest`, `BoardSession`, `BoardSessionMember`, `BoardMemberOpinion`, `BoardComment`	`brequests`, `bsession`, `bsessionmembers`, `bmemberopenion`, `bcomments`, `councilstaff`	إعادة بناء من الصفر (الجداول فارغة) مع إضافة `patient_id` الإلزامي وEnums للحالات ودمج العضوية في صلاحيات الـ ERP
منصة الـ ERP القياسية	`awusers`, `awrole` + 5 جداول صلاحيات, `awmenu`, `programesetting`, `branches`, `mobileservices`	Sanctum + spatie/laravel-permission؛ تفكيك الإعدادات إلى مفتاح/قيمة و`.env`؛ فروع بـ Pivot بدل "-1"؛ إعادة كتابة واجهة الموبايل بمصادقة إلزامية

ثالثًا: نقاط التكامل مع منظومة Moon ERP

ملف المرضى الموحد: إلغاء مزامنة cURL والقاعدة الثانية نهائيًا — مريضة العيادة هي عميل/مريض الـ ERP عبر patient_id، مع جدول مطابقة لمعرفات obygyPatientId التاريخية وأحداث PatientRegistered/Updated لأي مستهلك داخلي.
موديول المعمل LIS: طلب التحاليل من أي شيت يطلق حدث LabOrderPlaced ينشئ أوردر في LIS بالبنود الممَيِّزة عبر obgy_lis_test_map، وترجع النتائج بحدث LabResultReceived لتظهر داخل الشيت الإكلينيكي بدل النص الحر.
الصيدلية والمخازن: صرف الروشتة يطلق PrescriptionDispensed فيُخصم المخزون وتُنشأ حركة بيع في موديول المخازن؛ كتالوج الأدوية يُساد (Master) في أصناف الـ ERP، والمشتريات بالكامل لموديول المشتريات.
الحسابات: أحداث VisitInvoiced / PaymentReceived / RefundIssued تنشئ فواتير وسندات وقيود في موديول الحسابات بدل دفتر اليومية المتخفي في visits وأكواده السحرية؛ قائمة أسعار الخدمات (detections) تُدار من الـ ERP.
المستخدمون والصلاحيات: مخزن مستخدمين واحد، Sanctum للتوكنات، spatie/permission بصلاحية لكل إجراء قديم (~590) وصلاحيات مسماة للأزرار الإكلينيكية، ونطاق الفروع عبر branch_user.
موديول المستشفى HMS المخطط: تُصمَّم كيانات Encounter وOperativeNote وSurgicalBooking وHospital وخدمة الطابور بشكل غير مرتبط بالموديول ليعاد استخدامها من HMS لاحقًا.

رابعًا: مراحل التنفيذ (Phased Rollout)

المرحلة 0 — التأسيس (حجم M): هيكل الموديول، إطار obgy_lookups والـ Enums، حزمة التدقيق، عدة الترحيل ETL (محولات التواريخ والترميز وفاحص الأيتام)، وتصدير إلزامي من قاعدة الإنتاج (قيم القواميس + جداول وقت التشغيل sefo/gynaph/followupdrugs)، وربط المستخدمين والأدوار بمنظومة الصلاحيات.
المرحلة 1 — المرضى والاستقبال (L): دمج المريضة في ملف الـ ERP، فصل الزوج، الأرصدة الافتتاحية، المواعيد والطابور والفترات والإجازات، كتالوج الخدمات، دفتر حساب المريض وجسر الحسابات. أول تشغيل فعلي للاستقبال.
المرحلة 2 — النواة الإكلينيكية والكتالوجات (L): الفحص والتشخيص ومحرك التاريخ المرضي، جدولا الروشتات والتحاليل الموحدان، ربط كتالوج التحاليل بـ LIS، وتكامل الصيدلية مع المخازن.
المرحلة 3 — الحمل والنساء (L): دمج أجيال ملف الحمل الثلاثة، زيارات ومتابعات وسونار الحمل وحجوزات 4D وفقدان الحمل، وزيارات وشيتات وسونار النساء — أعلى حجم بيانات وأصعب إزالة تكرار.
المرحلة 4 — العقم والحقن المجهري والأندرولوجيا (L): توحيد ملف العقم ودورة IvfCycle وجداول المراحل وشبكة الحويصلات، وتطبيع السائل المنوي والهرمونات — الأغنى إكلينيكيًا ويتطلب اعتماد الأطباء لدلالات القوائم.
المرحلة 5 — التصوير والمناظير والعمليات (M): توحيد دراسات التصوير ونتائجها، معجم المناظير، المذكرات الجراحية وقوائم الانتظار والباثولوجيا.
المرحلة 6 — المجلس والكروت والتقارير والموبايل (M): إعادة بناء مجلس الأطباء، قوالب التعليمات والتحويل، طبقة التقارير الإحصائية كاستعلامات + لوحات Angular، وواجهة موبايل REST موثقة وموثَّقة الهوية.
المرحلة 7 — الوسائط والتحول النهائي (M): ترحيل 4.8 جيجابايت وسائط (جرد بالبصمات ثم rsync مرحلي ثم سجلات وسائط)، تشغيل متوازٍ مع مطابقة، ترحيل الفرق الأخير، تجميد النظام القديم للقراءة فقط، وإيقاف مزامنة cURL والقاعدة القديمة نهائيًا.

خامسًا: سجل مخاطر ترحيل البيانات

غياب المفاتيح الأجنبية كليًا (312 جدولًا): كل العلاقات ضمنية — يلزم فحص أيتام مسبق لكل علاقة وفق قائمة الـ ERD، مع عزل السجلات اليتيمة في جدول etl_orphans بسبب مسجل ومراجعة عينات مع الأطباء.
السجلات الإكلينيكية لا تشير لأي زيارة: الربط بالمريضة + التاريخ فقط؛ يُبنى مُطابق استدلالي (مريضة + تاريخ + قسم) لإسناد السجلات إلى Encounter، وما لا يُطابق يُسند لزيارة تاريخية اصطناعية.
الجداول المكررة بالأجيال: ثلاثة مسارات لمتابعة الحمل، وجيلان للعقم، وivfsheet مقابل mointoringsheet، وأربعة جداول للسائل المنوي وثلاثة للهرمونات — قواعد دمج حتمية (مريضة + LMP/تاريخ) بأسبقية أجيال يعتمدها الأطباء، مع تقرير دمج لكل مريضة.
التواريخ نصوص: صيغ Y/m/d و0000-00-00 وفراغات ونصوص حرة — محلل دفاعي مع طابور رفض وإحصاءات لكل عمود.
أعمدة CSV متعددة القيم (~40 عمودًا): تفكيك إلى Pivot مع التحقق من القواميس وتسجيل المعرفات المعلقة كقيمة "غير معروف (قديم)".
ترميز البيانات العربية: خلط latin1/utf8mb4 وقيم مشوهة — تحويل بمسار latin1 ← binary ← utf8mb4 لكل جدول مع مراجعة بصرية لعينات الأسماء العربية، والقاعدة الهدف utf8mb4 بالكامل.
النسخة الاحتياطية ≠ الإنتاج: جداول القواميس فارغة في نسخة 2024، وجداول وقت التشغيل (sefo, gynaph, followupdrugs) وأعمدة RedBean الديناميكية غائبة — تصدير إنتاجي طازج قبل كل بروفة ترحيل مع بوابة مقارنة مخططات في خط الأنابيب.
4.8 جيجابايت وسائط مرتبطة باصطلاح تسمية المجلدات فقط: جرد بالبصمات (Checksums) ثم نسخ مرحلي وسجلات وسائط بقاعدة البيانات وتحقق من الأعداد والأحجام، مع إبقاء الشجرة القديمة للقراءة فقط 6 أشهر.
الأكواد المالية السحرية: (‎-99/999/9999 في detectionid والربط الذاتي) — إعادة اشتقاق معاملاتية إلى أنواع حركات صريحة ومطابقة الأرصدة لكل مريضة مع شاشات النظام القديم قبل التسليم للحسابات.
تضارب الهويات: أرقام ملفات بـ MAX+1 ومسودات done=0 وأرقام قومية مكررة — تمريرة إزالة تكرار (رقم قومي/هاتف/اسم+ميلاد) بطابور مراجعة بشرية، ولا تُرحَّل المسودات الخالية من بيانات إكلينيكية.
الديون الأمنية لا تُنقل: لا يُنقل أي من نقاط الكتابة العامة أو واجهة الموبايل المفتوحة أو استعلامات التقارير المدموجة نصيًا أو كلمات المرور الثابتة؛ بوابة اختبار اختراق قبل المرحلة 6، وقاموس مركزي لتصحيح الأعمدة المُهجَّأة خطأ (husdandname, coast, registeration...).