📋

التاريخ المرضي الشامل (Patient Medical History)

موديول مركزي لتوثيق التاريخ المرضي الكامل لمريضة النساء والتوليد على مستوى المريضة (وليس الزيارة): تاريخ الدورة الشهرية، وسائل منع الحمل السابقة، تاريخ الولادات والحمل السابق، الأمراض الطبية السابقة، العمليات الجراحية والنسائية السابقة، محاولات الإخصاب المساعد السابقة (IUI/IVF/ICSI) بتفاصيلها المعملية، والتاريخ العائلي للأمراض. تظهر هذه البيانات كملخص في رأس صفحة المريضة وتُستهلك في جميع الشيتات الطبية والتقارير.

27جدول

2كنترولر

12علاقة رئيسية

الوظائف الرئيسية

تسجيل سجلات متعددة لتاريخ الدورة الشهرية لكل مريضة: سن البلوغ menarche، مدة الدورة، طول الدورة، الانتظام، كمية الطمث، عسر الطمث، وتاريخ آخر دورة phl_mp (LMP) المستخدم في حسابات الحمل.
تسجيل وسائل منع الحمل السابقة (نوع الوسيلة، المدة، تاريخ الإيقاف، ملاحظات).
توثيق تاريخ الولادات السابقة (Obstetric History): مدة الحمل، طريقة انتهاء الحمل (ولادة طبيعية/قيصرية/إجهاض/حمل خارج الرحم/حمل عنقودي)، مكان الولادة، التاريخ، وبيانات حتى 3 أطفال لكل حمل (النوع، الجنس، الوزن، الاسم) لدعم التوائم.
حساب الصيغة التوليدية (عدد القيصريات/الطبيعي/الإجهاض/الحمل خارج الرحم) تلقائياً وعرضها في رأس بيانات المريضة في كل الشاشات.
تسجيل الأمراض الطبية السابقة والعمليات الجراحية العامة والعمليات النسائية السابقة مع السنة واسم الجرّاح والملاحظات.
توثيق محاولات الإخصاب المساعد السابقة (IUI/IVF/ICSI/تجميد) مع المركز والسنة، وتفاصيل معملية لكل محاولة ICSI: عدد البويضات المسحوبة opu، درجات البويضات GI/GII/GV، عدد الأجنة المنقولة، الأجنة المجمدة، نتيجة تحليل الحمل bhcg، ونبض الجنين fhr.
عرض دورات التنشيط الداخلية المكتملة (Monitoring Sheets) داخل صفحة التاريخ كجزء من تاريخ ART الداخلي.
تسجيل التاريخ العائلي (المرض + صلة القرابة + ملاحظات).
إضافة قيم جديدة لقوائم الاختيار (الانتظام، كمية الطمث، أنواع منع الحمل، أنواع العمليات، مراكز الإخصاب... إلخ) مباشرة من نفس الشاشة دون مغادرتها (inline lookup creation)، مع تعديل أسماء عناصر القوائم.
التحرير الخلوي المباشر (inline cell editing) لأي حقل عبر دالة update عامة تستقبل اسم الجدول والعمود من الواجهة.
حذف منطقي (soft delete) لأي سجل تاريخ عبر العلم del.
وضع عرض مبسّط بديل (Simple View) يعرض تشخيصات مبسطة بدلاً من نموذج التاريخ الكامل حسب إعدادات البرنامج، مع إمكانية إظهار/إخفاء كل قسم من أقسام التاريخ من جدول الإعدادات.
إدارة بنك أسئلة "الشكوى الحالية" (Present History) كقوائم أسئلة وإجابات مع ترتيب عرض ومفضلة، تُستهلك في شيتات الكشف.
تصدير بيانات التاريخ المرضي تلقائياً إلى ملف Excel خارجي عند فتح الصفحة (عبر exec لتشغيل excel.php).

الجداول وبنية البيانات (Data Models)

الجدول	الغرض	أهم الحقول	العلاقات
`phmenstrual`	سجلات تاريخ الدورة الشهرية لكل مريضة (آخر دورة LMP، البلوغ، المدة، الانتظام...)	`patientid`, `menarche`, `duration`, `length`, `phregularity`, `phamount`, `phdysmenorrhoea`, `phl_mp`, `doctorid`, `del`	patients عبر `patientid`، awusers عبر `doctorid`، phregularity/phamount/phdysmenorrhoea عبر الأعمدة المسماة بنفس الاسم
`phregularity`	قائمة اختيار: انتظام الدورة (regular, irregular, menopause...)	`name`, `del`	تُرجع من `phmenstrual.phregularity`
`phamount`	قائمة اختيار: كمية دم الطمث (مثل excessive) — وليس مبلغاً مالياً	`name`, `del`	تُرجع من `phmenstrual.phamount`
`phdysmenorrhoea`	قائمة اختيار: عسر الطمث	`name`, `del`	تُرجع من `phmenstrual.phdysmenorrhoea`
`phcontraception`	سجلات وسائل منع الحمل السابقة للمريضة	`patientid`, `contype`, `contduration`, `contstopped`, `contranote`, `doctorid`, `del`	patients عبر `patientid`، phcontracttype عبر `contype`، awusers عبر `doctorid`
`phcontracttype`	قائمة اختيار: أنواع وسائل منع الحمل (IUD, OC, DMPA, Mirena, Condom...)	`name`, `del`	تُرجع من `phcontraception.contype`
`phobstetric`	سجل الولادات/حالات الحمل السابقة، صف لكل حمل مع بيانات حتى 3 أطفال (توائم)	`patientid`, `obstrduration`, `obstermination`, `obsplace`, `obsdate`, `outcomeid`, `babytype`/`babygendernew`/`babyweight`/`babyname` (+ مكررة 1 و2), `doctorid`, `del`	patients عبر `patientid`، phobstericterminate عبر `obstermination`، phobstericterplace عبر `obsplace`، awusers عبر `doctorid`
`phobstericterminate`	قائمة اختيار: طريقة انتهاء الحمل (SVD, CS, Ectopic, Abortion, V.mole)	`name`, `del`	تُرجع من `phobstetric.obstermination`؛ تُستخدم بمعرّفات ثابتة في حساب الصيغة التوليدية
`phobstericterplace`	قائمة اختيار: مكان الولادة/انتهاء الحمل	`name`, `del`, `patientid` (عمود شاذ غير مستخدم — استنتاج)	تُرجع من `phobstetric.obsplace`
`phpastmedical`	الأمراض الطبية السابقة للمريضة (مع علم للزوج)	`patientid`, `medicaldisease`, `medicalnote`, `for_husband`, `doctorid`, `del`	patients عبر `patientid`، phpastmedicaldisease عبر `medicaldisease`
`phpastmedicaldisease`	قائمة اختيار: أسماء الأمراض الطبية السابقة	`name`, `del`	تُرجع من `phpastmedical.medicaldisease`
`phpastsurgical`	العمليات الجراحية العامة السابقة (مع السنة والجرّاح وعلم للزوج)	`patientid`, `surgicaloperation`, `phsurgicalyear`, `phsurgicalsurgeon`, `surgicalnote`, `for_husband`, `doctorid`, `del`	patients عبر `patientid`، phpastsurgicaloperation عبر `surgicaloperation`
`phpastsurgicaloperation`	قائمة اختيار: أسماء العمليات الجراحية	`name`, `del`	تُرجع من `phpastsurgical.surgicaloperation`
`phpastgynecological`	العمليات النسائية السابقة (مع السنة والجرّاح)	`patientid`, `gynecologicaloperation`, `gynecologicalyear`, `gynecologicalsurgeon`, `gynecologicalnote`, `doctorid`, `del`	patients عبر `patientid`، phpastgynecologicaloperation عبر `gynecologicaloperation`
`phpastgynecologicaloperation`	قائمة اختيار: أسماء العمليات النسائية	`name`, `del`	تُرجع من `phpastgynecological.gynecologicaloperation`
`phpastart`	محاولات الإخصاب المساعد السابقة (IUI/IVF/ICSI/Cryo) بالمركز والسنة وبيانات تجميد الأجنة	`patientid`, `arttype`, `artcenter`, `artyear`, `artnote`, `emdate`, `emembryos`, `straw1`, `doctorid`, `del`	patients عبر `patientid`، phpastarttype عبر `arttype`، phpastartcenter عبر `artcenter`
`phpastarttype`	قائمة اختيار: نوع المحاولة (IUI, IVF, ICSI, cryo, failed)	`name`, `del`	تُرجع من `phpastart.arttype` (القيم 2 و3 = IVF/ICSI مُعاملة بمنطق خاص في الكود)
`phpastartcenter`	قائمة اختيار: مراكز الإخصاب التي أجريت بها المحاولات السابقة	`name`, `del`	تُرجع من `phpastart.artcenter`
`phpasticsi`	التفاصيل المعملية لمحاولة ICSI/IVF سابقة (سجل ابن لكل صف في phpastart)	`partentid`, `patientid`, `opu`, `gi`, `gii`, `gv`, `et`, `etf`, `frozen`, `bhcg`, `fhr`	phpastart عبر `partentid`، patients عبر `patientid`
`phfamily`	التاريخ العائلي للمريضة (مرض + صلة قرابة + ملاحظة)	`patientid`, `family_disease`, `family_relative`, `familynote`, `doctorid`, `del`	patients عبر `patientid`، phfamilydisease عبر `family_disease`، phfamilyrelative عبر `family_relative`
`phfamilydisease`	قائمة اختيار: الأمراض العائلية	`name`, `del`	تُرجع من `phfamily.family_disease`
`phfamilyrelative`	قائمة اختيار: صلة القرابة	`name`, `del`	تُرجع من `phfamily.family_relative`
`medicalhistory`	قائمة اختيار: أمراض طبية للزوجة تُستخدم في شيت العقم (DM, HTN, SLE...) — كتالوج موازٍ منفصل عن phpastmedicaldisease	`title`, `del`	infertilitysheet عبر العمود النصي `medicalhistory` (قائمة معرفات مفصولة بفواصل)
`medicalhistorydm`	قائمة اختيار: أمراض طبية للزوج في شيت العقم (varicocele, smoking, STD...) — اللاحقة dm تعني الزوج/الذكر (استنتاج من القيم)	`title`, `del`	infertilitysheet عبر `medicalhistorydm` (قائمة مفصولة بفواصل)
`surgicalhistory`	قائمة اختيار: عمليات جراحية للزوجة في شيت العقم (myomectomy, ov cystectomy...)	`title`, `del`	infertilitysheet عبر `surgicalhistory` (قائمة مفصولة بفواصل)
`surgicalhistorydm`	قائمة اختيار: عمليات جراحية للزوج في شيت العقم (varicocelectomy, herniorrhaphy...)	`title`, `del`	infertilitysheet عبر `surgicalhistorydm` (قائمة مفصولة بفواصل)
`familyhistory`	قائمة اختيار: التاريخ العائلي في شيت العقم (DM, HTN, cancer...) — كتالوج موازٍ منفصل عن phfamilydisease	`title`, `del`	infertilitysheet عبر `familyhistory` (قائمة مفصولة بفواصل)

سير العمل (Workflow)

يفتح الطبيب صفحة «Patient History» (patienthistory.php) بعد اختيار المريضة؛ إذا لم تُحدد مريضة يُعاد التوجيه للصفحة الرئيسية.
حسب إعداد programesetting.simpleview يُعرض إما نموذج مبسّط (تشخيصات بسيطة) أو النموذج الكامل بسبعة أقسام: الدورة الشهرية، منع الحمل، الولادات، الأمراض السابقة، الجراحات، العمليات النسائية، محاولات ART، والتاريخ العائلي، مع تحميل كل قوائم الاختيار وسجلات المريضة السابقة لكل قسم.
عند الضغط على «إضافة صف» في أي قسم تُستدعى دالة AJAX (مثل addnewmenstural, addnewobstetric, addnewpastart...) تنشئ فوراً سجلاً فارغاً في قاعدة البيانات مرتبطاً بالمريضة والطبيب الحالي بتاريخ اليوم، وتُعيد صف HTML جديداً (قالب Smarty جزئي مثل newMenstrualRow.html).
يملأ الطبيب الحقول مباشرة داخل الجدول؛ كل تغيير في خلية يستدعي الدالة العامة update التي تستقبل اسم الجدول والعمود والقيمة وتحفظ مباشرة (حفظ خلوي لحظي بدون زر حفظ).
في قسم ART، عند إدخال تفاصيل معملية لمحاولة IVF/ICSI تُنشأ/تُحدّث تلقائياً سجلة ابنة في phpasticsi مربوطة بـpartentid، كما تُعرض دورات التنشيط الداخلية المكتملة من mointoringsheet ضمن نفس القسم.
إذا لم تكن القيمة المطلوبة موجودة في قائمة الاختيار، يضيفها المستخدم من نفس الشاشة فتُحفظ في جدول القائمة (مثل phcontracttype) ويُحدَّث سجل المريضة فوراً بالمعرف الجديد؛ ويمكن أيضاً تعديل اسم عنصر قائمة عبر editselect/updateselect.
الحذف يتم منطقياً برفع العلم del=1 عبر delRows.
عند فتح الصفحة تُسجَّل المريضة في قائمة تصدير Excel (excelinfopatients) ويُشغَّل سكربت excel.php في الخلفية لتصدير بياناتها.
ملخص التاريخ (آخر دورة LMP، الصيغة التوليدية المحسوبة من phobstetric بمعرّفات ثابتة للقيصرية/الطبيعي/الإجهاض...) يُعرض في رأس بيانات المريضة (_patientdata.php/_phmain.php) في كل شاشات الكشف والشيتات.
بشكل منفصل، شاشة addpresenthistory.php تُدير بنك أسئلة «الشكوى الحالية» (presenthistoryquestions/presenthistoryanswers) بترتيب عرض ومفضلة، وتُستهلك إجاباتها في شيتات الكشف.

الارتباط بالموديولات الأخرى

موديول المرضى (patients): كل جداول السجلات ترتبط بالمريضة عبر patientid، وتقرير الإنهاءات يربط phobstetric.patientid بجدول patients مباشرة.
موديول المستخدمين/الأطباء (awusers): كل سجل يحمل doctorid الذي يُترجم لاسم الطبيب عبر awusers.user_id.
موديول شيت العقم (infertilitysheet): الكتالوجات medicalhistory, medicalhistorydm, surgicalhistory, surgicalhistorydm, familyhistory تُخزَّن كقوائم معرفات مفصولة بفواصل داخل أعمدة infertilitysheet وتُفك في التقارير (sh.php, Completesreport.php).
موديول متابعة التنشيط (mointoringsheet): صفحة التاريخ تعرض الدورات المكتملة (status=1) عبر mointoringsheet.patientid كتاريخ ART داخلي.
موديول الزيارات والشيتات (gynasheet, infertilitysheet, ancsheet, antenalvisit): تعرض ملخص التاريخ عبر _phmain.php و_patientdata.php (آخر LMP والصيغة التوليدية).
موديول التقارير (fullreport, completereport, combinedreport, termination, excel): يقرأ جداول ph* لطباعة التقرير الكامل وتقرير الإنهاءات والتصدير إلى Excel.
موديول دمج المرضى (merge.php): ينقل كل سجلات ph* من المريضة المكررة إلى الأصلية عند الدمج.
موديول الإعدادات (programesetting): أعلام إظهار/إخفاء أقسام التاريخ (menstrual, contraception, obstetric, past, family, art...) ووضع simpleview ومسار PHP لتصدير Excel.
موديول الشكوى الحالية: presenthistoryquestions/presenthistoryanswers عبر presenthistorycatid (يُدار من addpresenthistory.php ويُستهلك في شيتات الكشف).

ملاحظات فنية

لا توجد مفاتيح أجنبية معلنة إطلاقاً؛ كل العلاقات ضمنية، وكثير من أعمدة الربط نصية varchar بدلاً من int (مثل phmenstrual.patientid وphobstetric.obstermination).
ازدواجية كتالوجات: يوجد كتالوجان منفصلان للأمراض (phpastmedicaldisease مقابل medicalhistory) وللجراحات وللتاريخ العائلي — أحدهما لشاشة التاريخ والآخر لشيت العقم — بنفس المعنى السريري تقريباً.
جداول شيت العقم تخزن المعرفات كقوائم نصية مفصولة بفواصل (comma-separated IDs) وتُفك بـid IN (0$list) عبر حقن نص مباشر في SQL — مخاطرة أمنية وتصميم غير معياري.
دوال update وdelRows تستقبل اسم الجدول والعمود من المتصفح مباشرة وتمررها إلى ORM دون قائمة سماح (whitelist) — ثغرة تتيح تعديل أي جدول؛ ودالة delRowsommedel بلا أي تحقق من الجلسة.
منطق الصيغة التوليدية في _patientdata.php يعتمد على معرّفات ثابتة مكتوبة في الكود (1=SVD، 2=CS، 3=Ectopic، 4=Abortion، 5=V.mole) رغم أن القائمة قابلة للتعديل من المستخدم.
phobstetric غير معياري: بيانات حتى 3 أطفال في أعمدة مكررة (babytype, babytype1, babytype2...) بدل جدول أطفال مستقل، وعمود outcomeid يقلب babygendernew بمنطق خاص.
الكود يقرأ أعمدة غير موجودة في مخطط 2024 (phpastart.ovdate, freezdate, phpasticsi.notes) — تُنشأ ديناميكياً بواسطة RedBeanPHP في وضع fluid (استنتاج)، ما يدل على انجراف مخطط غير موثق.
عمود patientid داخل جدول القائمة phobstericterplace شاذ ولا يُستخدم في الكود المقروء.
التواريخ مخزنة كـvarchar في معظم الجداول (sysdate, obsdate) ما يضعف الفرز والاستعلام، وسنوات العمليات نصوص حرة.
بيانات القوائم في نسخة 2024 فارغة بينما نسخة 2021 تحتوي القيم الفعلية، مع تلوث واضح بقيم تجريبية محذوفة منطقياً (aaaa, 777...) وقيم مكررة (DM ثلاث مرات في familyhistory).
إنشاء الصف الفارغ في قاعدة البيانات قبل إدخال أي بيانات (insert-then-edit) يترك سجلات فارغة كثيرة إذا تراجع المستخدم.
استدعاء exec() لتشغيل تصدير Excel عند كل فتح للصفحة — عبء أداء ونمط غير آمن.

توصيات النقل إلى ERP

إنشاء موديولات Laravel واضحة لكل قسم: MenstrualHistory, ContraceptionHistory, ObstetricHistory (+ جدول ابن ObstetricBaby يلغي الأعمدة المكررة الثلاثية), PastMedicalHistory, PastSurgicalHistory, PastGynecologicalHistory, PastArtCycle (+ PastArtIcsiDetail أو دمجها كأعمدة في نفس الجدول), FamilyHistory — جميعها بمفتاح أجنبي حقيقي patient_id وdoctor_id.
توحيد القوائم في جدول مرجعي واحد متعدد الأنواع lookup_values (type + name + is_active) أو جداول Eloquent صغيرة، مع دمج الكتالوجات المزدوجة: medicalhistory مع phpastmedicaldisease، وsurgicalhistory مع phpastsurgicaloperation، وfamilyhistory مع phfamilydisease.
استبدال أعمدة القوائم المفصولة بفواصل في شيت العقم بجداول pivot معيارية (many-to-many) مثل infertility_sheet_medical_histories مع تمييز الزوج/الزوجة بعمود for_husband بدلاً من جداول *dm منفصلة.
تحويل كل التواريخ إلى أعمدة date/timestamp حقيقية، وتحويل أعمدة الربط النصية إلى unsignedBigInteger مع قيود مفاتيح أجنبية، واستخدام softDeletes القياسية بدل العلم del.
استبدال جدول phobstericterminate القابل للتعديل بـEnum ثابت (SVD/CS/Ectopic/Abortion/V.mole) لأن منطق الصيغة التوليدية يعتمد على هذه القيم؛ وحساب G/P في خدمة Domain Service مختبَرة بدل الاستعلامات المتناثرة.
إغلاق الثغرات أثناء النقل: إلغاء أي endpoint عام يستقبل أسماء جداول/أعمدة من العميل، واعتماد Form Requests وValidation وPolicy لكل عملية، وإلغاء exec() لصالح Laravel Queue/Export (مكتبة Laravel Excel).
تنقية البيانات قبل الترحيل: حذف صفوف القوائم التجريبية والمكررة، ودمج القيم المتطابقة، واستبعاد السجلات الفارغة الناتجة عن نمط insert-then-edit.
نقل بنك أسئلة الشكوى الحالية إلى جدولي present_history_questions/present_history_answers بعلاقة hasMany مع ترتيب عرض ومفضلة.
في واجهة Angular، الإبقاء على تجربة «الحفظ اللحظي للصف» لكنها عبر نماذج Reactive Forms مع إنشاء السجل عند أول حفظ فعلي (وليس عند فتح الصف) لتفادي السجلات الفارغة.