لوحة إدارة ذات تعليمات برمجية منخفضة ومحرك Rails لذكاء الأعمال (لا يوجد DSL - قابل للتكوين من واجهة المستخدم) .
؟ التطبيق التجريبي | ؟ نظرة عامة على الميزات | برو
أضف هذا السطر إلى ملف Gemfile الخاص بالتطبيق الخاص بك:
gem 'motor-admin'
ومن ثم تنفيذ:
$ bundle install
إنشاء وتشغيل الترحيل:
$ rails motor:install && rake db:migrate
يمكن تكوين كل شيء في لوحة الإدارة باستخدام واجهة مستخدم الإعدادات البديهية، والتي يمكن فتحها عبر الرمز الموجود في الزاوية اليمنى العليا.
يمكن تخصيص البيانات المعروضة على صفحة المورد بالكامل عبر استعلامات SQL ولوحات المعلومات المرفقة بالمورد كعلامة تبويب. عادةً، يجب أن تحتوي الاستعلامات المستخدمة لعرض بيانات الموارد على متغير {{resource_name_id}}
.
تعرف على المزيد حول تخصيصات الموارد
يمكن إضافة إجراءات الموارد المخصصة عبر استدعاء أسلوب Active Record أو نقطة نهاية API أو النماذج المخصصة. ومن الممكن أيضًا تجاوز إجراءات الإنشاء/التحديث/الحذف الافتراضية.
يمكن عرض أي طريقة أو سمة لنموذج ActiveRecord إلى لوحة الإدارة عن طريق إضافة عمود جديد بالاسم الذي يطابق اسم الطريقة من نموذج المورد:
class Customer < ApplicationRecord
has_many :orders
def lifetime_value
orders . sum ( & :total_price )
end
end
يمكن استخدام القيم من حقول النموذج في مسار واجهة برمجة التطبيقات عبر بناء الجملة {field_name}
: /api/some-endpoint/{resource_id}/apply
.
تعرف على المزيد حول منشئ النماذج المخصصة
يمكن أن تتضمن الاستعلامات متغيرات مضمنة عبر بناء الجملة {{variable}}
(شارب). يسمح بناء الجملة {{#variable}} ... {{/variable}}
بتحديد ما إذا كان يجب تضمين الشروط داخل النطاق في الاستعلام.
يمكن تمثيل البيانات من استعلام SQL على النحو التالي: جدول، رقم، مخطط خطي، مخطط شريطي، مخطط دائري، مسار قمع، تخفيض السعر.
يمكن تنظيم استعلامات SQL في لوحات معلومات لإنشاء تمثيل مناسب للبيانات.
يمكن إرسال بيانات الاستعلام عبر البريد الإلكتروني بشكل دوري باستخدام خاصية التنبيهات. يمكن تحديد الفاصل الزمني لرسائل البريد الإلكتروني التنبيهية باستخدام اللغة الطبيعية، على سبيل المثال، every day at midnight
، every Monday at 8 PM
، every weekday at 6AM and 6PM
، every minute
.
يمكن تحديد عنوان المرسل باستخدام متغير البيئة MOTOR_ALERTS_FROM_ADDRESS
.
يمكن فتح البحث الذكي عبر زر الزاوية اليمنى العليا أو باستخدام اختصار Cmd + K.
يسمح Motor Admin بتعيين أذونات على مستوى الصف والعمود عبر cancan Gem. يجب تحديد أذونات واجهة المستخدم الإدارية في ملف app/models/motor/ability.rb
في فئة Motor::Ability
. راجع دليل Motor Admin ووثائق CanCan لمعرفة كيفية تحديد أذونات المستخدم.
يتم تكوين Motor Admin افتراضيًا لإجراء عمليات التحميل إلى الموفر الذي قمت بتكوينه في ملف storage.yml
الخاص بك للتخزين النشط. إذا كنت تستخدم عمليات تحميل كبيرة ضمن Motor Admin، فستحتاج إلى تمكين التحميلات المباشرة عن طريق تعيين متغير ENV التالي.
MOTOR_ACTIVE_STORAGE_DIRECT_UPLOADS_ENABLED=true
ملاحظة: في الوقت الحالي، سيؤدي هذا إلى تمكين التحميل المباشر على مستوى العالم
يمكن لـ Motor Admin استخدام مفاتيح Rails ActiveRecord i18n لعرض ترجمات الموارد:
es :
activerecord :
models :
customer :
one : Cliente
other : Clientes
attributes :
customer :
name : Nombre
scopes :
customer :
enabled : Activado
يتم تخزين كافة تكوينات لوحة الإدارة تلقائيًا في الملف config/motor.yml
. يوصى بتضمين هذا الملف في مستودع git للتطبيق حتى تتم مزامنة تكوينات لوحة الإدارة دائمًا عبر بيئات محلية وبعيدة مختلفة.
من الممكن مزامنة تكوينات لوحة إدارة التطوير المحلي مع تطبيق الإنتاج عن بعد عبر rake motor:sync
:
MOTOR_SYNC_REMOTE_URL=https://remote-app-url/ MOTOR_SYNC_API_KEY=secure-random-string rake motor:sync
يمكن تأمين لوحة الإدارة باستخدام "المصادقة الأساسية" عن طريق تحديد متغيرات البيئة MOTOR_AUTH_USERNAME
و MOTOR_AUTH_PASSWORD
.
وبدلاً من ذلك، يمكن تأمينها باستخدام Device أو أي مكتبة مصادقة أخرى يستخدمها التطبيق:
authenticate :admin_user do
mount Motor :: Admin => '/admin'
end
بدء خادم تطوير حزمة الويب:
yarn install && yarn serve
إعداد قاعدة بيانات التطوير:
rake app:db:create && rake app:db:setup
بدء تطبيق المثال في وضع التطوير:
MOTOR_DEVELOPMENT=true rails s
تم ترخيص Motor Admin بموجب ترخيص MIT.