عن المشروع

Gentelella v4 هو قالب لوحة تحكم إدارية مجاني ومفتوح المصدر تشرف عليه Colorlib. يمثل القالب إعادة كتابة شاملة لمشروع Gentelella العريق، حيث استبدل حزمة Bootstrap و jQuery القديمة بـ vanilla JavaScript و SCSS ونظام بناء Vite 8. ويطرحه ملف README كبديل للوحات تحكم SaaS، والخلفيات البرمجية لـ CRM/ERP، ولوحات الإدارة الداخلية، وأدوات إدارة المشاريع، وخلفيات التجارة الإلكترونية، ولوحات التحليلات، وواجهات الحجز أو إدارة المحتوى. تتضمن الحزمة 58 صفحة HTML جاهزة للإنتاج، يتم التعامل معها كتطبيق Vite متعدد الصفحات مع نقاط دخول يتم اكتشافها تلقائياً. وتغطي الواجهات المضمنة أربعة أنواع من لوحات التحكم (العمليات، التحليلات، المبيعات، وصحة النظام)، وشاشات المصادقة (تسجيل الدخول عبر خيارات Google/GitHub الاجتماعية، التسجيل، استعادة كلمة المرور، المصادقة الثنائية 2FA، شاشة القفل، بالإضافة إلى صفحات الخطأ 403/404/500)، والنماذج (عامة، عناصر تحكم متقدمة، معالج من ست خطوات، رفع الملفات بالسحب والإفلات، التحقق من الصحة، منتقي نطاق التاريخ، الاختيار المتعدد، ومحرر النصوص الغنية)، وصفحات DataTables مع ميزات الفرز والبحث والترقيم واختيار الصفوف وتصدير CSV. يتم التعامل مع المخططات بواسطة Apache ECharts 6، والتي يتم استيرادها بشكل نمطي وكسول، مع 20 نوعاً موثقاً مثل: الخطية، المساحية، المساحية المكدسة، الأعمدة، الأعمدة الأفقية، المزيج بين الأعمدة والخطوط، الدونات، الدائرية، الرادارية، المقياس، التشتت، الخريطة الحرارية، القمعية، الشموع اليابانية، الأعمدة القطبية، الخريطة الشجرية، سانكي، الخريطة الحرارية للتقويم، ومخطط غانت. وتشمل صفحات التطبيق تقويماً مع عمليات CRUD، وعميل بريد وارد بمجلدات ولوحة قراءة ونافذة إنشاء ورد/توجيه واختصارات لوحة مفاتيح J/K/R/S/#، وعرض للدردشة، ولوحة كانبان بالسحب والإفلات، ومدير ملفات بنظام الشجرة والشبكة، وإشعارات، وفاتورة ببنود قابلة للتعديل، وملف شخصي، وإعدادات محفوظة في localStorage وصفحة أسئلة شائعة. وتكتمل المجموعة بصفحات التجارة الإلكترونية والصفحات الإدارية. تشمل الأدوات المدمجة البارزة مولداً حياً للسمات يقوم بتغيير أنماط المخططات والأزرار والشارات والروابط في الوقت الفعلي ويمكنه تصدير رموز SCSS الناتجة، وساحة تجارب للمكونات تربط كل مكون قابل لإعادة الاستخدام بكود HTML الخاص به مع زر نسخ، ولوحة أوامر للبحث التقريبي عبر جميع الصفحات الـ 58. يدعم نظام السمات الوضعين الفاتح والداكن مع اكتشاف prefers-color-scheme وسكريبت ما قبل الرسم لتجنب وميض السمة الخاطئة، مع حفظ التبديلات اليدوية في localStorage. كما يتم دعم تخطيطات RTL للغات العربية والعبرية والفارسية من خلال سمة html dir وخصائص CSS المنطقية بدلاً من ورقة أنماط معكوسة منفصلة. وتتضمن لمسات إمكانية الوصول رابط تخطي، وحلقات تركيز، وتسميات ARIA على عناصر التحكم التفاعلية، ومعالم دلالية، وجداول صديقة لقارئات الشاشة. كما أن القالب جاهز ليكون PWA مع service worker، وهيكل خارجي للعمل دون اتصال، وبيان تثبيت (manifest). تتم إدارة التنقل من خلال مصفوفة NAV واحدة، ويمكن حقن الهيكل عند وقت البناء أو التشغيل دون وميض للمحتوى غير المنسق. يغطي سلوك الشريط الجانبي كلاً من درج الهاتف المحمول وسكة أيقونات سطح المكتب مع قوائم فرعية منبثقة، ويتم حقن وصف الميتا لكل صفحة وعلامات Open Graph و Twitter Card عند وقت البناء. تعيش رموز التصميم كخصائص CSS مخصصة، لذا فإن تغيير اللون الأساسي ينتقل إلى المخططات وعناصر واجهة المستخدم. تم اختيار الحزمة التقنية لتكون صغيرة عمداً: ثلاث تبعيات للإنتاج وعشر تبعيات للتطوير، حيث يبلغ حجم node_modules حوالي 165 ميجابايت مقارنة بحوالي 600 ميجابايت في الإصدار السابق. وبالإضافة إلى ECharts، يستخدم القالب DataTables.net 3 المعاد تصميمها لتناسب نظام التصميم و Leaflet 1.9 لخريطة العملاء التي يتم تحميلها في تلك الصفحة فقط، بالإضافة إلى خط Inter. ويُستخدم Playwright كتبعية تطوير لخط أنابيب لقطات الشاشة واختبارات الدخان التي تطلب كل صفحة وتتحقق من استجابة HTTP 200. يحصل المطورون على مجموعة من سكريبتات npm لخادم التطوير، وبناء الإنتاج والبناء غير المصغر، والمعاينة، وتحليل الحزم، وإنشاء هيكل الصفحات عبر مولد يمكنه إدراج مدخلات الشريط الجانبي، والتقاط لقطات الشاشة، والنشر مع رؤوس ذاكرة تخزين مؤقت لكل ملف، والتدقيق والتنسيق. يدعم متغير BASE_PATH النشر تحت مسار فرعي، ومخرجات البناء هي HTML ثابت بالإضافة إلى أصول مشفرة (hashed assets) مناسبة لأي مضيف ثابت. كما تم نشر المشروع على npm للاستيرادات الدقيقة لمساعدات الهيكل والنوافذ المنبثقة والتنبيهات مع تصديرات مسارات فرعية للوحدات والأنماط وتصريحات TypeScript، ويمكن الوصول إلى مجلد dist المبني مسبقاً ومجلد src غير المجمع عبر jsDelivr للنماذج الأولية أو فحص صفحات العرض مباشرة. تتوفر ملفات مساعدة لـ Claude Code و Cursor و GitHub Copilot والمساعدين المتوافقين مع agents.md، لتوثيق الاصطلاحات والوصفات. يتم استضافة التوثيق الكامل بشكل منفصل، ويغطي الإعداد، والهيكل، والبنية، والسمات، والجداول، والنماذج، والتراكبات، وPWA، والنشر، والهجرة. القالب مرخص بموجب MIT ومجاني للاستخدام الشخصي والتجاري.