ims laravel admin starter
version-0.0.7
ims-laravel-admin-starter عبارة عن لوحة إدارة مبسطة وتطبيق واجهة برمجة التطبيقات (API) تم إنشاؤه باستخدام إطار عمل Laravel 10 القوي وFilment 3.
ينصب تركيزنا الأساسي على تزويدك بمشروع تطوير محلي خالي من المتاعب وجاهز للاستخدام.
على عكس مولدات API التقليدية أو مولدات الأكواد، يعمل هذا المشروع على تبسيط عملية إعداد بيئة التطوير المحلية الخاصة بك. فهو يمكّنك من بدء تطوير واجهة برمجة التطبيقات (API) المستندة إلى Laravel وتطوير لوحة الإدارة دون تعقيدات غير ضرورية. يتيح لك هذا التركيز على بناء منطق التطبيق الخاص بك بدلاً من قضاء الوقت في الإعداد الأولي.
نظام المصادقة الكامل : تنفيذ نظام مصادقة قوي باستخدام حزمة Laravel Jetstream لإدارة آمنة للمستخدم ووظيفة تسجيل الدخول.
نظام التفويض القائم على الأدوار والأذونات : قم بإنشاء نظام تفويض مرن باستخدام حزمة Laravel-Permission، مما يسمح لك بتحديد الأدوار والأذونات للتحكم الدقيق في الوصول.
إدارة المستخدم : إدارة المستخدمين بكفاءة، بما في ذلك تسجيل المستخدم وتحديثات الملف الشخصي وأدوار المستخدم.
إعدادات ملف التعريف : تمكين المستخدمين من تخصيص ملفاتهم الشخصية، بما في ذلك المعلومات الشخصية والتفضيلات.
دعم اللغات المتعددة : اجعل تطبيقك في متناول الجمهور العالمي بمساعدة حزم Filament Translations وLaravel Lang للدعم متعدد اللغات.
تخصيص المظهر : قم بتخصيص مظهر التطبيق وواجهة المستخدم باستخدام قوة Tailwind CSS لإنشاء تصميمات جذابة بصريًا.
دعم Docker : يمكنك نشر تطبيقك وإدارته بسهولة في حاوية Docker مع سهولة Laravel Sail لتسهيل سير عمل التطوير والنشر.
اختر أداة التنمية المحلية الخاصة بك:
اختر أداة التطوير المحلية المفضلة لديك، مثل Laragon، أو XAMPP، أو WAMP، أو أي أداة أخرى تناسب احتياجاتك.
تكوين بيئتك:
قم بتحديث ملف .env الخاص بك باستخدام بيانات اعتماد قاعدة البيانات الصحيحة.
تثبيت التبعيات:
قم بتشغيل الأمر التالي لتثبيت التبعيات المطلوبة باستخدام Composer:
composer installقم بتشغيل الأمر التالي لتثبيت التبعيات المطلوبة باستخدام npm وإنشائها:
npm install
npm run buildترحيل قاعدة البيانات وبذرها: تهيئة قاعدة البيانات وبذرها باستخدام البيانات الافتراضية باستخدام:
php artisan migrate --seedالآن، مشروعك جاهز للاستخدام. يمكنك الوصول إلى لوحة الإدارة عبر المسار المقدم. إذا قمت بتشغيل الأمر الأولي، فقم بتسجيل الدخول باستخدام بيانات الاعتماد المقدمة. تخصيص وتوسيع التطبيق الخاص بك حسب الحاجة.
بمجرد قيامك بإعداد المشروع باستخدام الإرشادات المقدمة، يمكنك الوصول إلى لوحة الإدارة عن طريق زيارة المسار /admin في متصفح الويب الخاص بك.
إذا قمت بتشغيل الأمر الأولي أثناء عملية الإعداد، فيمكنك تسجيل الدخول باستخدام بيانات الاعتماد التالية:
email: [email protected]
password: 123456
email: [email protected]
password: 123456 يدعم ims-laravel-admin-starter العمليات القائمة على الأدوار والأذونات للتحكم في الوصول إلى الوظائف المختلفة داخل لوحة الإدارة الخاصة بك. يمكنك تحديد الأدوار بأذونات محددة وتعيينها للمستخدمين حسب الحاجة.
استكشف هذا المشروع واستمتع بتجربة بيئة التطوير المحلية الجاهزة لواجهات برمجة التطبيقات ولوحات الإدارة المستندة إلى Laravel.
قم برفع مستوى إمكانية الوصول وسهولة الاستخدام لهذا المشروع المبتدئ من خلال احتضان لغات متعددة. بمساعدة Filament Translations وحزمة Laravel Lang، يقدم هذا المشروع المبتدئ دعمًا شاملاً متعدد اللغات.
للحصول على دليل تفصيلي حول العمل مع لغات وترجمات متعددة، تفضل بزيارة صفحة wiki المخصصة لدينا.
أطلق العنان لعالم من الإمكانيات من خلال الترجمة اللغوية السلسة، مما يضمن أن تطبيقك يلقى صدى لدى الجمهور العالمي.
للحصول على دليل أكثر شمولاً، يرجى زيارة صفحة WIKI على GitHub:
تشغيل التطبيق باستخدام Docker وLaravel Sail - Wiki
يوفر هذا المورد التفصيلي إرشادات خطوة بخطوة ومعلومات إضافية لضمان تجربة سلسة عند إعداد التطبيق وتشغيله باستخدام Docker وLaravel Sail.
للتأكد من موثوقية التطبيق الخاص بك وصحته، من الضروري إجراء الاختبارات. اتبع هذه الخطوات البسيطة:
إنشاء قاعدة بيانات اختبار منفصلة:
ابدأ بإنشاء قاعدة بيانات اختبارية مخصصة لتطبيقك. يمكنك تسميته ims-admin-testing لإبقائه مختلفًا عن قاعدة بيانات الإنتاج الخاصة بك.
إذا كنت تستخدم Docker وLaravel Sail، فيمكنك تخطي هذه الخطوة وبدلاً من ذلك تحديث ملف phpunit.xml لإضافة قاعدة بيانات اختبارية:
< env name = " DB_DATABASE " value = " testing " />تشغيل الاختبارات:
لديك خياران مناسبان لإجراء الاختبارات:
استخدام الآفات:
قم بتنفيذ الاختبارات باستخدام Pest، وهو إطار عمل رائع لاختبار PHP. ما عليك سوى تشغيل الأمر التالي:
./vendor/bin/pestإذا كنت تستخدم Sail، فيمكنك استخدام هذا الأمر:
./vendor/bin/sail test
# or if you have an alias configured:
sail testباستخدام الحرفي:
توفر أداة سطر الأوامر Artisan من Laravel إمكانات اختبار سلسة. قم بإجراء الاختبارات باستخدام أمر Artisan التالي:
php artisan testإذا كنت تقوم بتشغيل Sail، فيمكنك استخدام هذا الأمر:
./vendor/bin/sail artisan test
# or if you have an alias configured:
sail artisan testيعد إجراء الاختبارات أمرًا بالغ الأهمية لضمان موثوقية وصحة وظائف التطبيق الخاص بك. ستبدأ الأوامر المذكورة أعلاه عملية الاختبار وتزودك برؤى قيمة حول جودة قاعدة التعليمات البرمجية الخاصة بك.
بعض نصائح الأداء للخيوط
لتحسين أداء تطبيق Filament، يمكنك استخدام الأمر php artisan icons:cache لتخزين الرموز مؤقتًا. يقوم هذا الأمر بتحميل الرموز المستخدمة في تطبيقك وتخزينها مؤقتًا، مما يؤدي إلى أوقات تحميل أسرع.
php artisan icons:cacheإذا كنت تواجه مشكلات في الأداء وتريد تسريع تطبيقك، ففكر في تعطيل ميزة مجموعة العرض في Debugbar. وإليك كيف يمكنك القيام بذلك:
انتقل إلى ملف التكوين debugbar.php الموجود في دليل config الخاص بتطبيقك.
داخل ملف debugbar.php ، ستجد مصفوفة باسم collectors . حدد موقع مُجمع 'views' ضمن هذه المصفوفة.
لتعطيل مجموعة العرض، ما عليك سوى تعيين أداة تجميع 'views' على false ، كما يلي:
' collectors ' => [
...
' views ' => false, // Views with their data
],سيمنع هذا التغيير Debugbar من جمع بيانات العرض وعرضها، مما قد يساعد في تحسين أداء تطبيقك، خاصة في بيئة التطوير.
يوفر هذا المشروع أوامر حرفية إضافية لتبسيط سير العمل وتحسين الإنتاجية.
قم بإنشاء ملفات مساعدة IDE عامة لتحسين الإكمال التلقائي للتعليمات البرمجية والتنقل عن طريق تشغيل:
php artisan ide-helper:generateقم بإنشاء ملفات مساعدة لنموذج IDE دون الكتابة إلى ملفات النموذج باستخدام:
# use any one of this two commands
php artisan ide-helper:models -N
php artisan ide-helper:models --nowritephp artisan csfixer:runيضمن هذا الأمر أن التعليمات البرمجية الخاصة بك تلتزم بمعايير الترميز المحددة مسبقًا، مما يجعل قاعدة التعليمات البرمجية الخاصة بك نظيفة وقابلة للقراءة.
أصبح إنشاء الخدمات لتطبيقك أمرًا سهلاً. استخدم الأمر التالي لإنشاء الخدمة:
php artisan make:service subfolder/ServiceNameاستبدل المجلد الفرعي واسم الخدمة بالقيم الفعلية التي تحتاجها. يمكنك أيضًا إنشاء خدمة بدون مجلد فرعي:
php artisan make:service TestService ستكون الخدمة التي تم إنشاؤها حديثًا موجودة على app/Http/Services/TestService.php ، وتكون جاهزة للتعامل مع منطق الأعمال الخاص بتطبيقك.
السمات هي مكونات تعليمات برمجية قابلة لإعادة الاستخدام تعمل على تحسين تنظيم التعليمات البرمجية. لإنشاء سمة جديدة، ما عليك سوى تشغيل:
php artisan make:trait TestTraitيقوم هذا الأمر بإنشاء ملف سمة جديد لمشروعك، مما يعزز إمكانية إعادة استخدام التعليمات البرمجية وقابلية الصيانة.
استفد من أوامر الحرفيين هذه لتبسيط عملية التطوير الخاصة بك والحفاظ على قاعدة تعليمات برمجية جيدة التنظيم.
تم تقديم هذا المشروع إليك بواسطة Innovix Matrix System وتم إصداره كبرنامج مفتوح المصدر بموجب ترخيص MIT.
لا تتردد في استخدام هذا المشروع المبدئي وتعديله وتوزيعه وفقًا لشروط ترخيص MIT. نحن نشجع التعاون ونرحب بمساهمات المجتمع لجعل هذا المشروع أفضل.
