نظام الفلترة
 

محرك ذكي لفرز العملاء و& اللييدز الجدد

 

1. نظرة عامة على المفهوم
 

نظام الفلترة هو محرك فرز بيانات ديناميكي انصمم عشان يساعد المستخدمين يتحكمون بالضبط أي عملاء أو لييدز جدد تطلع في قائمة النظام.
 

هذا مو مجرد فلتر واجهة مستخدم.

هذي إطار فلترة ثابت، متعدد الاستخدامات، ومراعي للتصدير يدعم:
 

• قوائم العملاء و& اللييدز الجدد

• العروض والاختصارات المحفوظة

• فلترة التبويبات والطلبات

• فلاتر التقييم متعددة المعايير

• منطق التصدير والتقارير
   

أي فلتر تطبقه يصير جزء من مسار استعلامات موحد اللي يفهمه النظام ويعيد استخدامه على مستوى الوحدات.
 

---

2. وين مكان نظام الفلترة
 

نظام الفلترة يظهر في صفحة قائمة العملاء / اللييدز الجدد، مدمج بصرياً في شريط أدوات جدول العملاء الرئيسي.
 

• نقطة الدخول هي زر “فلاتر” على طريقة الهمبرجر

• الضغط عليه يفتح نافذة منبثقة كاملة للفلاتر

• النافذة المنبثقة تكون فوق القائمة بدون ما تنتقل لصفحة ثانية

• الفلاتر دايماً تنطبق على السياق النشط الحالي للقائمة
   

هذا يضمن إن الفلاتر تحس إنها فوريه، قابلة للإلغاء، وآمنة.
 

---

3. النافذة المنبثقة للفلاتر – التصميم البصري و& الوظيفي
 

النافذة المنبثقة حقت الفلاتر مقسمة لـأربع تبويبات وظيفية، وكل وحدة تمثل استراتيجية فلترة مختلفة.
 

فلاتر متقدمة
 

هذا هو المنشئ الأساسي لأغلب المستخدمين.
يسمح ببناء فلتر منطقي واحد يتكون من عدة شروط بالدمج مع منطق AND / OR.
 

فلاتر محفوظة
 

هذي التبويبة تعرض كل الفلاتر المتقدمة اللي انحفظت من قبل، وتسمح بإعادة استخدام فوري، تعديل أو مشاركة.
 

فلاتر متقدمة متعددة
 

هذي التبويبة تسمح ببناء فلاتر مبنية على التقييم، اللي فيها كل شرط يساهم في تقييم مرجّح.
 

فلاتر متعددة محفوظة
 

هذي التبويبة تخزن وتدير الفلاتر متعددة المعايير (المبنية على التقييم) اللي انحفظت من قبل.
 

في أي وقت، "مسح الكل" يعيد تعيين حالة الفلتر ويرجع القائمة للعرض الافتراضي حقها.
 

---

4. فلاتر متقدمة – شلون تبني فلتر واحد
 

الفلاتر المتقدمة تنبني سطر بسطر، وكل سطر يمثل شرط واحد.
 

الخطوة 1: اختيار حقل
 

المستخدم يختار حقل من قائمة منسدلة انشئت بشكل ديناميكي.

هذي القائمة تتضمن:
 

• حقول النظام الأساسية (إيميل، تلفون، حالة، مصدر، تاقات وإلخ)

• مقاييس مالية ومقاييس حالة

• تواريخ وأختام زمنية

• حقول إضافية معرفة من قبل المنظمة

• حقول مخصصة مجمعة تتوسع تلقائياً
   

قائمة الحقول يتم إنشائها بشكل مركزي بحيث تكون نفس الحقول متوفرة في كل مكان.
 

الخطوة 2: اختيار الشرط
 

كل حقل نقدر نفحصه باستخدام عوامل تشغيل مثل:
 

• هو

• ليس هو

• فارغ

• ليس فارغ
   

عوامل التشغيل هذي تراعي اللغة وموحدة على مستوى النظام.

 

الخطوة 3: إدخال القيمة
 

إدخال القيمة يتكيف مع نوع الحقل المختار:
 

• قوائم منسدلة لـ enums (حالة، تاقات، مديرين)

• محددات تواريخ للتواريخ

• حقول إدخال نصية للنصوص

• حقول إدخال رقمية للمبالغ
   

الخطوة 4: دمج الشروط
 

المستخدمين يقدرون يضيفون عدد لا محدود من الأسطر ويربطونها باستخدام منطق AND / OR، وهالشي يسمح باستعلامات دقيقة وايد.
 

---

5. تضمين العملاء الفرعيين و& خيارات إضافية
 

تضمين العملاء الفرعيين
 

خانة اختيار مخصصة تسمح للفلتر إنه يشمل عملاء فرعيين (سجلات فرعية).
 

هذا الإعداد:
 

• يمديك تفعّله/تعطّله لكل فلتر

• ينحفظ داخل إعدادات الفلتر

• يمديك بعد تفعيله بشكل عام لكل مستخدم
   

خيارات إضافية
 

لوحة “خيارات إضافية” تسمح بحقن قيود إضافية لمفتاح/قيمة اللي ماهي جزء من حقول واجهة المستخدم الرئيسية.
 

هذي الخيارات:
 

• تنحفظ مع الفلتر

• تنتقل مع الفلاتر المحفوظة

• تتطبق بشفافية عن طريق محرك الاستعلامات حق الباك إند
   

---

6. تفعيل الفلتر – وشو اللي يصير بالضبط
 

لما يضغط المستخدم على تطبيق، النظام مو بس يخفي أسطر.
 

بدال كذا، هو يسوي تحميل بيانات كامل باستخدام محمل فلتر مدمج.
 

داخلياً:
 

1. واجهة المستخدم تبني كائن فلتر مدمج

2. كل الحقول اللي تم اختيارها، عوامل التشغيل، القيم، منطق AND/OR، الخيارات الإضافية، وأعلام العملاء الفرعيين تنحط بباكج

3. هذا المحمل ينرسل للـ API الرئيسي للتحميل

4. الباك إند يحوله لمنطق فلترة SQL

5. قائمة العملاء تنعاد تحميلها باستخدام الاستعلام المفلتر
    

هذا يضمن:
 

• ترقيم صفحات صحيح

• مجاميع صحيحة

• تصدير صحيح

• نتائج متسقة في كل مكان
   

---

7. حفظ الفلاتر – عروض دائمة
 

كل فلتر متقدم يمدي ينحفظ باسم.
 

بعد ما ينحفظ:
 

• يظهر في تبويبة فلاتر محفوظة

• يمديك تفعله مرة ثانية فوراً

• يمديك تعدله أو تكتب فوقه

• يمديك تنسخه كرابط URL مباشر
   

الفلاتر المحفوظة تنحفظ على حسب المستخدم والمنظمة، وهالشي يضمن الخصوصية والاتساق.
 

فتح الصفحة بـ ?advance={filter_id} يفعل الفلتر هذا تلقائياً.
 

---

8. فلاتر متقدمة متعددة – منطق التقييم
 

الفلاتر المتقدمة المتعددة توسع الفلترة أبعد من منطق نعم/لا.
 

كل شرط:
 

• عنده عامل مقارنة

• عنده قيمة

• يساهم في التقييم
   

التقييم النهائي يحدد إذا العميل يتطابق.
 

هذا مثالي لـ:
 

• تأهيل اللييدز

• ترتيب الأولويات

• قواعد عمل معقدة
   

الفلاتر المتعددة المحفوظة تتصرف بالضبط زي الفلاتر الفردية المحفوظة بس تستخدم محرك تقييم مختلف.
 

---

9. محرك استعلامات الباك إند
 

كل منطق الفلترة يمر بالنهاية عن طريق محمل باك إند واحد.
 

هذا المحمل:
 

• يقرأ بارامترات الفلتر

• يبني بنود SQL WHERE بشكل ديناميكي

• يطبق منطق AND/OR الصحيح

• يدمج الفلاتر المتعددة لما تكون موجودة

• يتعامل مع الخيارات الإضافية والعملاء الفرعيين

• يضمن الأمان والصحة
   

هذا المحرك الموحد يضمن إن الفلاتر تتصرف بنفس الطريقة عبر:
 

• قائمة العملاء

• التبويبات

• الطلبات

• التصدير

• التقارير
   

---

10. الثبات في قاعدة البيانات
 

الفلاتر المحفوظة تنحفظ في جداول مخصصة.
 

• الفلاتر الفردية تخزن مصفوفات شروط، عوامل تشغيل، قيم وأعلام

• الفلاتر المتعددة تخزن شروط تقييم وبيانات وصفية إضافية

• الفلاتر تتحدد حسب المستخدم، المنظمة والسياق (عميل، تبويبة، طلب)
   

هذا يسمح إن الفلاتر تكون:
 

• قابلة لإعادة الاستخدام بأمان

• تنتقل بين السياقات

• تتفعّل تلقائياً عند التصدير
   

---

11. دمج التصدير
 

نظام التصدير مراعي للفلاتر في تصميمه.
 

عند التصدير:
 

• النظام يستخدم نفس استعلام الفلتر

• المجلد، البحث والفلاتر تنأخذ في الحسبان

• الأسطر اللي تم اختيارها تتجاوز الفلاتر إذا انختارت

• يمديك تصدّر الفلاتر المحفوظة مباشرة عن طريق الـ ID
   

هذا يضمن إن الملفات المصدرة دايماً تتطابق مع اللي يشوفه المستخدم.
 

---

12. التبويبات، الطلبات و& إعادة الاستخدام
 

نظام الفلترة يُعاد استخدامه على عدة وحدات.
 

• التبويبات ممكن يكون عندها فلاترها المحفوظة الخاصة فيها

• الطلبات تستخدم نفس إعدادات الفلتر

• عروض الصحف والواتساب تستخدم نفس المنطق

• بس علم السياق يتغير
   

إعادة الاستخدام هذي تمنع الازدواجية وتحافظ على اتساق المنطق.
 

---

13. دورة حياة متكاملة (من البداية للنهاية)


المستخدم يفتح فلتر
     ↓
يبني شروط
     ↓
يفعّل الفلتر
     ↓
الباك إند يبني استعلام
     ↓
قائمة العملاء تنعاد تحميلها
     ↓
(اختياري) حفظ فلتر
     ↓
إعادة استخدام / تصدير / مشاركة


14. ليش هالنظام مهم
 

نظام الفلترة هو طبقة ذكاء مركزية، ومو مجرد سهولة في واجهة المستخدم.
 

هي:
 

• تسمح بفرز عميق

• تحسن التركيز التشغيلي

• تدعم التصدير والتقارير

• تدعم النمو في حجم البيانات

• تحافظ على منطق مركزي وقابل للصيانة
   

---

تعريف نهائي
 

نظام الفلترة هو محرك فرز عملاء مركزي، ثابت، ومتعدد الاستخدامات، اللي يحول بيانات العملاء الخام لعروض ذات معنى وقابلة للتنفيذ — مدمج بشكل كامل مع القوائم، التبويبات، الطلبات، التصدير، ومنطق التقييم.