motor admin rails
0.4.27
Panneau d'administration Low-code et moteur Business Intelligence Rails (pas de DSL - configurable depuis l'interface utilisateur) .
? Application de démonstration | ? Aperçu des fonctionnalités | Pro
Ajoutez cette ligne au Gemfile de votre application :
gem 'motor-admin'Et puis exécutez :
$ bundle installCréez et exécutez la migration :
$ rails motor:install && rake db:migrate
Tout dans le panneau d'administration peut être configuré à l'aide de l'interface utilisateur des paramètres intuitifs, qui peut être ouverte via l'icône dans le coin supérieur droit.
Les données affichées sur la page des ressources peuvent être entièrement personnalisées via des requêtes SQL et des tableaux de bord attachés à la ressource sous forme d'onglet. Habituellement, les requêtes utilisées pour afficher les données de ressources doivent contenir la variable {{resource_name_id}} .
En savoir plus sur les personnalisations des ressources
Des actions de ressources personnalisées peuvent être ajoutées via un appel de méthode Active Record, un point de terminaison d'API ou des formulaires personnalisés. En outre, il est possible de remplacer les actions de création/mise à jour/suppression par défaut.
Toute méthode ou attribut du modèle ActiveRecord peut être exposé au panneau d'administration en ajoutant une nouvelle colonne avec le nom qui correspond au nom de la méthode du modèle de ressource :
class Customer < ApplicationRecord
has_many :orders
def lifetime_value
orders . sum ( & :total_price )
end
end 
Les valeurs des champs du formulaire peuvent être utilisées dans le chemin de l'API via la syntaxe {field_name} : /api/some-endpoint/{resource_id}/apply .
En savoir plus sur le générateur de formulaires personnalisés
Les requêtes peuvent inclure des variables intégrées via la syntaxe {{variable}} (moustache). La syntaxe {{#variable}} ... {{/variable}} permet de décider si les conditions à l'intérieur de la portée doivent être incluses dans la requête.
Les données de la requête SQL peuvent être représentées sous forme de : tableau, nombre, graphique linéaire, graphique à barres, diagramme circulaire, entonnoir, démarque.
Les requêtes SQL peuvent être organisées en tableaux de bord pour créer une représentation pratique des données.
Les données de requête peuvent être envoyées périodiquement par e-mail à l’aide de la fonction d’alertes. L'intervalle de l'e-mail d'alerte peut être spécifié en langage naturel, par exemple, every day at midnight , every Monday at 8 PM , every weekday at 6AM and 6PM , every minute .
L'adresse de l'expéditeur peut être spécifiée à l'aide de la variable d'environnement MOTOR_ALERTS_FROM_ADDRESS .
La recherche intelligente peut être ouverte via le bouton dans le coin supérieur droit ou en utilisant le raccourci Cmd + K.
Motor Admin permet de définir des autorisations au niveau des lignes et des colonnes via cancan gem. Les autorisations de l’interface utilisateur d’administration doivent être définies dans le fichier app/models/motor/ability.rb dans la classe Motor::Ability . Consultez le guide Motor Admin et la documentation CanCan pour savoir comment définir les autorisations des utilisateurs.
Motor Admin est configuré par défaut pour effectuer des téléchargements vers le fournisseur que vous avez configuré dans votre fichier storage.yml pour Active Storage. Si vous utilisez des téléchargements volumineux dans Motor Admin, vous devrez activer les téléchargements directs en définissant la variable ENV suivante.
MOTOR_ACTIVE_STORAGE_DIRECT_UPLOADS_ENABLED=trueRemarque : Pour le moment, cela permettra les téléchargements directs dans le monde entier.
Motor Admin peut utiliser les clés Rails ActiveRecord i18n pour restituer les traductions de ressources :
es :
activerecord :
models :
customer :
one : Cliente
other : Clientes
attributes :
customer :
name : Nombre
scopes :
customer :
enabled : Activado
Toutes les configurations du panneau d'administration sont automatiquement stockées dans le fichier config/motor.yml . Il est recommandé d'inclure ce fichier dans le référentiel git de l'application pour que les configurations du panneau d'administration soient toujours synchronisées dans différents environnements locaux et distants.
Il est possible de synchroniser les configurations du panneau d'administration de développement local avec une application de production à distance via la tâche rake motor:sync :
MOTOR_SYNC_REMOTE_URL=https://remote-app-url/ MOTOR_SYNC_API_KEY=secure-random-string rake motor:sync Le panneau d'administration peut être sécurisé avec « Authentification de base » en spécifiant les variables d'environnement MOTOR_AUTH_USERNAME et MOTOR_AUTH_PASSWORD .
Alternativement, il peut être sécurisé avec un appareil ou toute autre bibliothèque d'authentification utilisée par l'application :
authenticate :admin_user do
mount Motor :: Admin => '/admin'
end Démarrez le serveur de développement Webpack :
yarn install && yarn serveConfigurer la base de données de développement :
rake app:db:create && rake app:db:setupDémarrez l'exemple d'application en mode développement :
MOTOR_DEVELOPMENT=true rails sMotor Admin est sous licence MIT.
