46- بناء نظام موحد للفلترة و البحث و الترتيب (part1).

Описание: في هذا الدرس، نبدأ ببناء نظام موحد وقابل لإعادة الاستخدام للتعامل مع الفلترة (Filtering)، البحث (Search)، الترتيب (Sorting)، والباجينيشن (Pagination) في مشروع Node.js مع TypeScript.

🎯 ما تم شرحه في هذا الجزء:

1️⃣ مقدمة عن المشكلة: لماذا نحتاج نظام موحد؟
تكرار الكود في كل Controller
صعوبة الصيانة والتعديل
الحاجة لمعيار واحد في كل المشروع

2️⃣ شرح النظام الموحد بالكامل:
كيف يعمل التدفق من الـ Request حتى قاعدة البيانات
الصيغة المبسطة للـ Query String
دعم 10 عوامل فلترة (equals, contains, gt, lt, in, notIn...)
البحث في عدة حقول
الترتيب المتعدد
الباجينيشن مع metadata كاملة

3️⃣ اختبار عملي على Postman:
✅ فلترة مباشرة: ?role_id=1
✅ فلترة مع عامل: ?name=contains:أحمد
✅ بحث شامل: ?search=ahmed&searchIn=name,email
✅ ترتيب: ?sort=name:ASC,created_at:DESC
✅ باجينيشن: ?page=1&limit=10
✅ دمج الكل معاً في استعلام واحد

4️⃣ كتابة كود FilterTypes.ts:
تعريف FilterOperator (عوامل الفلترة)
تعريف FilterCriteria (معيار فلترة واحد)
تعريف SortOption (خيار ترتيب)
تعريف SearchCriteria (معيار البحث)
تعريف QueryParams (الكائن الشامل)

🛠️ التقنيات المستخدمة:
Node.js + TypeScript
Express.js
MySQL
Clean Architecture

Postman للاختبار

📌 في الأجزاء القادمة:
بناء QueryParamsParser
بناء QueryBuilder
التطبيق في Repository و Service و Controller

📢 لا تنسَ الاشتراك في القناة وتفعيل الجرس 🔔

#nodejs #typescript #expressjs #mysql #api #restapi #backend #webdevelopment #cleanarchitecture #pagination #filtering #sorting #search #querybuilder #postman #البرمجة #تعلم_البرمجة #برمجة #باك_اند #نود_جي_اس #تايب_سكريبت #مطور_ويب #برمجة_عربي #كود #تطوير_ويب #javascript #sql #clean_code #software_engineering #tutorial #programming #coding #developer #عربي #تعليم #شرح_برمجة #backend_development #api_development #web_developer