تحليل ترتيب أعضاء البنل في كل الشاشات

وحدة: المختبر (LIS) — Moon ERP | التاريخ: 2026-05-25 | نطاق: البنل من تعريفه إلى إدخال النتائج إلى طباعة التقرير

شاشات متأثرة

جداول DB موجودة

تاسكات

~٢ س

تقدير

الفكرة المطلوبة (ملخص)

الـ Panel Editor الحالي: المستخدم يقدر يعمل أقسام فرعية (مثلاً CBC فيه "RBC parameters" و "WBC parameters" و "Platelets") ويضع كل تحليل تحت قسمه.
المطلوب: نفس الترتيب ونفس العناوين الفرعية تظهر في:
- شاشة إدخال النتائج (Results page)
- شاشة الـ Kanban عند إدخال النتائج
- تقرير الـ PDF المطبوع
في الـ Panel Editor نفسه: تحسينات على الترتيب:
- الـ drag & drop موجود — يفضل
- عمود رقم (sort_order) ظاهر لكل عضو
- المستخدم يقدر يكتب الرقم مباشرة (مثلاً يحط ١، ٥، ١٠ على ثلاث صفوف)
- زر "ترتيب حسب الرقم" → ينفذ فرز حسب الأرقام اللي كتبها

الوضع الحالي — ما هو موجود

البنية التحتية موجودة بالكامل:

جدول lab_panel_sections فيه: panel_id, name, name_ar, sort_order
جدول lab_investigation_panel_members فيه: panel_id, member_id, section_id, sort_order
الـ LabInvestigationResource يرجع panel_sections array مرتب + كل عضو معاه sort_order و section_id
Panel-members-editor: drag & drop يشتغل، الـ payload المرسلة للباك اند صحيحة (sort_order يتحسب من الفهرس)

ما يعمل في الشاشات الحالية

الشاشة	هل تستخدم الترتيب؟	هل تعرض الأقسام الفرعية؟
الـ Panel Editor	نعم (drag&drop)	نعم
شاشة الـ Results	جزئياً	غير مؤكد
شاشة الـ Kanban	غير مؤكد	لا
تقرير الـ PDF	نعم (`panelSectionOrder` + `panelMemberOrder`)	نعم

المشاكل المكتشفة

عالٍ فرونت ١) شاشة الإدخال (Results) قد لا تظهر بنفس ترتيب الـ Editor

الوصف:

الشاشة تقرأ panel_members ثم تبنيها في array مسطّحة. الترتيب يعتمد على الـ ordering في الـ API response. لو لم تطبق sort صريح على sort_order، قد يظهر بترتيب مخالف للـ Panel Editor.

الإصلاح:

تأكيد فرز panelMembers داخل كل قسم حسب pivot.sort_order
تأكيد فرز الأقسام نفسها حسب sort_order
عرض اسم القسم الفرعي كـ header قبل كل مجموعة (لو غير موجود حالياً)

عالٍ فرونت ٢) شاشة الـ Kanban لا تعرض الأقسام الفرعية ولا الترتيب

الوصف:

الـ Kanban يأخذ panel_members كـ array بسيطة عبر map(m => m.id). الأقسام الفرعية والترتيب يضيعا. عند إدخال النتائج، كل أعضاء البنل تظهر مع بعض بدون ترتيب.

الإصلاح:

الاحتفاظ بـ panel_sections و sort_order في الـ Kanban state
عرض headers الأقسام في result entry dialog
فرز الأعضاء داخل كل قسم

متوسط فرونت ٣) في الـ Panel Editor: مفيش رقم ظاهر للترتيب

الوصف:

الـ drag & drop شغّال، لكن المستخدم لا يشوف رقم الـ sort_order ولا يقدر يعدّله. لو عنده ١٥ عضو، التحريك بالماوس يبقى مرهق.

الإصلاح:

إضافة عمود رقم في كل صف (input عددي صغير)
المستخدم يقدر يكتب الرقم مباشرة
زر "ترتيب حسب الرقم" → يأخذ الأرقام اللي كتبها ويعيد الفرز ويعيد توزيع sort_order بشكل مسلسل

الـ UX المقترح:

┌─ RBC Parameters ────────────────────────────────────────────┐
│ ┌──┬─────────────────────┬───────┐                          │
│ │⠿ │ 1  │ Hemoglobin (HB) │ 🗑    │                          │
│ │⠿ │ 2  │ Hematocrit       │ 🗑    │                          │
│ │⠿ │ 3  │ RBC Count        │ 🗑    │                          │
│ └──┴─────────────────────┴───────┘                          │
│                                                             │
│  [ + Add Member ]   [ ↕ Sort by Number ]                    │
└─────────────────────────────────────────────────────────────┘

عالٍ فرونت ٤) PDF: ترتيب الأعضاء قد يكون صحيح لكن الـ display_name غير مستخدم

الوصف:

الـ PDF service يستخدم panelSectionOrder و panelMemberOrder للترتيب — جيد. لكن الـ subHeader يستخدم panelSectionName فقط، لا يفرّق بين عربي وإنجليزي. وأعضاء البنل قد تظهر بـ code بدل اسم العرض.

الإصلاح:

اسم القسم الفرعي في PDF: يستخدم اسم بناءً على اللغة الحالية
أعضاء البنل: يستخدمون display_name لو موجود (تم في ticket #1628)

التحسينات على الـ Panel Editor

التصميم المقترح للـ Editor

┌─ Panel: CBC ────────────────────────────────────────────────┐
│                                                             │
│  Section 1: RBC Parameters                                  │
│  ┌──┬─────┬─────────────────────────┬──────────────────┐    │
│  │ ⠿│  1  │ Hemoglobin (HB)         │  edit │ remove  │    │
│  │ ⠿│  2  │ Hematocrit (HCT)        │  edit │ remove  │    │
│  │ ⠿│  3  │ RBC Count               │  edit │ remove  │    │
│  └──┴─────┴─────────────────────────┴──────────────────┘    │
│                                                             │
│  Section 2: WBC Parameters                                  │
│  ┌──┬─────┬─────────────────────────┬──────────────────┐    │
│  │ ⠿│  1  │ Total WBC               │  edit │ remove  │    │
│  │ ⠿│  2  │ Neutrophils             │  edit │ remove  │    │
│  └──┴─────┴─────────────────────────┴──────────────────┘    │
│                                                             │
│  Ungrouped                                                  │
│  ┌──┬─────┬─────────────────────────┬──────────────────┐    │
│  │ ⠿│  1  │ Platelets               │  edit │ remove  │    │
│  └──┴─────┴─────────────────────────┴──────────────────┘    │
│                                                             │
│  [ ↕ Sort by Number ]    [ + Add Section ]                  │
└─────────────────────────────────────────────────────────────┘

سلوك زر "Sort by Number"

يقرأ كل rows داخل كل قسم
يفرزها حسب الرقم اللي كتبه المستخدم في كل input
يعيد توزيع sort_order بشكل مسلسل (١، ٢، ٣، ...)
يطبق الترتيب بصرياً وفي الـ payload

قائمة التاسكات

الترتيب	التاسك	الجانب	الأولوية	التقدير
T-1	إضافة input رقم في panel-editor بجوار كل عضو + زر "Sort by Number"	فرونت	متوسط	٢٥ د
T-2	شاشة الـ Results: التأكد من الفرز الصحيح + عرض headers الأقسام الفرعية	فرونت	عالٍ	٣٠ د
T-3	شاشة الـ Kanban: نفس الفرز + headers الأقسام في حوار إدخال نتائج البنل	فرونت	عالٍ	٣٠ د
T-4	الـ PDF: لو لم يستخدم الترتيب بشكل صحيح، التأكد من الفرز الكامل	فرونت	متوسط	١٥ د
T-5	الـ PDF: اسم القسم الفرعي يستخدم لغة المستخدم الحالية (ar/en)	فرونت	بسيط	١٠ د
T-6	اختبار يدوي شامل لكل الشاشات	—	—	١٥ د

الإجمالي: ~٢ ساعة.

أسئلة قبل البدء

زر "Sort by Number": ينفّذ تلقائياً بمجرد أن المستخدم يكتب أرقام، أم يحتاج ضغط الزر لتفعيله؟
الاقتراح: زر يدوي (لو نفّذ تلقائياً قد يحدث فوضى وقت الكتابة)
سلوك المستخدم إذا كتب أرقام متكررة (مثلاً اتنين أعضاء برقم ٢):
- (أ) يحتفظ بالاتنين بنفس الرقم ويستخدم الترتيب الأصلي كـ tiebreaker.
- (ب) ينبّه المستخدم بخطأ.
- (ج) يعيد ترقيمهم تلقائياً (٢، ٣) ويزحف الباقي.
الاقتراح: (أ) — الأبسط، والمستخدم يقدر يصلح يدوياً
الـ ungrouped (الأعضاء بدون قسم فرعي): يظهرون قبل الأقسام، بعدها، أم في تاب لوحده؟
الاقتراح: بعد كل الأقسام، بدون header

Moon ERP — LIS Module | Panel Ordering Plan | جاهز للمراجعة