🧬 ترتيب البانل وعناوينه الفرعية

طلبك: البانل (مثل CBC) لازم يكون فيه:

1. ترتيب ثابت للفحوصات — تظهر بنفس الترتيب في إدخال النتيجة وفي التقرير المطبوع.
2. عناوين فرعية تجمّع مجموعة فحوصات تحت اسم واحد (مثل: «صورة الدم الحمراء» / «التفاضلي للكرات البيضاء»).

أ) قاعدة البيانات

جدول ربط أعضاء البانل lab_investigation_panel_members:

// الموجود حالياً
panel_id     FK → lab_investigations
member_id    FK → lab_investigations
sort_order   unsignedInteger default 0  ← موجود لكن مهمَل
timestamps
unique(panel_id, member_id)

• موجود عمود sort_order — يعني الترتيب ممكن يتخزّن.
• ناقص لا يوجد أي عمود/جدول لتجميع الفحوصات في أقسام (عناوين فرعية).

ب) إنشاء وتعديل البانل (الواجهة)

عند حفظ بانل، الواجهة بتبعت مصفوفة IDs فقط — من غير ترتيب ولا أقسام:

// lis-investigations.component.ts — saveCreatePanel()
panel_members: this.selectedInvestigations.map(inv => inv.id)
// → [12, 23, 24, 25, ...]   مجرد IDs

// الخدمة updatePanelMembers() بتبعت
{ member_ids: [12, 23, 24] }   ← مفيش sort_order إطلاقاً

ج) عرض أعضاء البانل

أ) نموذج البيانات — جدول أقسام مستقل

أفضل من إضافة عمود نص group_label على كل صف عضو، للأسباب التالية: إعادة تسمية القسم = تعديل صف واحد بدل N صفوف، الاسم ثنائي اللغة بدون تكرار، وترتيب الأقسام صريح وثابت.

// جدول جديد
lab_panel_sections
  id, panel_id FK→lab_investigations,
  name, name_ar,
  sort_order, timestamps

// تعديل جدول الربط الموجود
lab_investigation_panel_members
  + section_id  FK→lab_panel_sections  nullable
  sort_order    ← يصبح "ترتيب داخل القسم"

ب) شكل محرّر البانل — في شاشة تفاصيل الفحص

كل قسم صندوق قابل للطي، بمقبض سحب لإعادة الترتيب، والأعضاء جواه بمقابض سحب كمان. زر «+ إضافة قسم» تحت.

مكتبة السحب: PrimeNG لا تملك drag-list ناضج — نستخدم @angular/cdk/drag-drop (موجود بالفعل كاعتمادية Angular). سحب على مستويين: الأقسام، والأعضاء داخل القسم.

ج) شكل التقرير المطبوع

عنوان القسم يظهر كصف وسطّي بخط عريض بين صفوف الأعضاء — وده مرسوم جاهز في خدمة الـ PDF، محتاج بس البيانات تغذّيه.

د) شكل إدخال النتيجة

نفس الفكرة: صف فاصل بعنوان القسم بين صفوف إدخال الأعضاء. الكود حالياً عنده صف افتراضي isPanelHeader (سطر ~253) — نضيف نوع isSectionHeader على نفس النمط.

lab_panel_sections + section_id
        │
        ├──> محرّر البانل        سحب/إعادة ترتيب + إضافة أقسام
        │
        ├──> إدخال النتيجة      صف isSectionHeader بين المجموعات
        │     (results.component.ts ~253)
        │
        └──> تقرير PDF          subHeader:true عند حدود كل قسم
              (results.component.ts:1362 يبني ReportResultRow[])

أي ترتيب يتحدد مرة واحدة في المحرّر → يظهر متطابق في الإدخال والطباعة. مصدر حقيقة واحد.

الـ Backend للقراءة فقط من ناحيتنا. المطلوب تذكرة لأحمد بالبنود التالية:

1. Migration

• جدول جديد lab_panel_sections: id, panel_id, name, name_ar, sort_order, timestamps.
• عمود section_id (nullable FK → lab_panel_sections, nullOnDelete) على lab_investigation_panel_members.
• لا حاجة لترحيل بيانات — الأعضاء القديمة section_id = NULL = مجموعة بدون عنوان.

2. endpoint حفظ أعضاء البانل

تعديل PUT /lis/investigations/{id}/panel-members ليقبل بنية غنية بدل مصفوفة IDs:

{
  "sections": [
    { "name":"RBC Parameters", "name_ar":"صورة الدم الحمراء", "sort_order":1,
      "members": [ {"member_id":23,"sort_order":1}, {"member_id":24,"sort_order":2} ] }
  ],
  "ungrouped": [ {"member_id":30,"sort_order":1} ]
}

يفضّل قبول الشكل القديم (member_ids: []) كمان لتوافق رجعي.

3. الـ Resource

• InvestigationResource يرجّع panel_sections[] وكل قسم جواه members[] مرتّبة بـ sort_order.
• وأعضاء بدون قسم تحت ungrouped_members[].
• كل عضو يحمل sort_order و section_id.

معايير القبول

• [ ] إنشاء/تعديل/حذف قسم داخل بانل.
• [ ] حفظ ترتيب الأعضاء داخل القسم وترتيب الأقسام.
• [ ] الـ Resource يرجّع الأعضاء مجمّعة ومرتّبة.
• [ ] بانل قديم بدون أقسام يفضل شغّال (section_id=NULL).
• [ ] حذف قسم لا يحذف الفحوصات — فقط يفك ربطها (section_id→NULL).

1. الموديل: إضافة section_id + sort_order لـ LisPanelMember، وواجهة LisPanelSection جديدة.
2. محرّر البانل: مكوّن جديد بـ @angular/cdk/drag-drop — أقسام قابلة للطي + سحب على مستويين + إضافة/تسمية/حذف قسم.
3. الخدمة: updatePanelMembers() تبعت بنية sections الجديدة.
4. إدخال النتيجة: صف isSectionHeader في باني الصفوف المسطّح (سطر ~253).
5. التقرير: باني ReportResultRow[] (سطر 1362) يصدّر صف subHeader:true عند بداية كل قسم.
6. عرض التفاصيل: أعضاء البانل في شاشة الفحص تتجمّع تحت عناوين الأقسام.