super_admin 0.2.0

data/config/locales/super_admin.fr.yml

@@ -0,0 +1,197 @@
+fr:
+  time:
+    formats:
+      long: "%d %B %Y %H:%M"
+  super_admin:
+    layout:
+      window_title: "SuperAdmin - %{page_title}"
+      default_page_title: "Administration"
+      footer: "SuperAdmin - %{year}"
+    flash:
+      access_denied: "Vous n'avez pas les droits d'accès à cette section."
+    navigation:
+      brand: "SuperAdmin"
+      return_to_app: "Retour à l'app"
+      dashboard: "Dashboard"
+      exports: "Exports CSV"
+      audit_logs: "Journal d'activité"
+      models_heading: "Modèles (%{count})"
+    dashboard:
+      index:
+        page_title: "Dashboard"
+        breadcrumb: "Dashboard"
+        heading: "Dashboard SuperAdmin"
+        intro: "Gestion complète de tous les modèles de l'application"
+        stats:
+          models_label: "Modèles disponibles"
+          records_label: "Total enregistrements"
+          users_label: "Utilisateurs"
+        table:
+          title: "Tous les modèles"
+          headers:
+            model: "Modèle"
+            table: "Table"
+            records: "Enregistrements"
+            actions: "Actions"
+          manage: "Gérer →"
+    resources:
+      shared:
+        search_placeholder: "Rechercher..."
+        search_button: "Rechercher"
+        reset_filters: "Réinitialiser"
+        advanced_filters: "Filtres avancés"
+        contains_placeholder: "Contient..."
+        boolean_options:
+          placeholder: "—"
+          yes: "Oui"
+          no: "Non"
+        min_placeholder: "Min"
+        max_placeholder: "Max"
+        clear_filters: "Effacer les filtres"
+        apply_filters: "Appliquer"
+        bulk:
+          selected_suffix: "sélectionné(s)"
+          action_placeholder: "Action de masse"
+          destroy_action: "Supprimer la sélection"
+          apply: "Appliquer"
+          confirm: "Confirmer l'action sélectionnée sur les éléments cochés ?"
+          select_all_label: "Sélectionner tous les éléments"
+          select_item_label: "Sélectionner l'élément %{id}"
+      nested:
+        collection_hint: "Les modifications seront enregistrées lors de la sauvegarde."
+        add: "Ajouter %{model}"
+        remove: "Supprimer"
+        remove_hint: "Cocher pour supprimer l'élément lors de l'enregistrement."
+        entry_existing: "%{model} #%{id}"
+        entry_new: "Nouvel(le) %{model}"
+        missing_association: "Association %{name} introuvable."
+        max_depth_exceeded: "Profondeur maximale de nesting atteinte (%{max} niveaux). Impossible d'imbriquer davantage."
+      index:
+        export_csv: "Exporter en CSV"
+        view_exports: "Voir les exports"
+        new: "Créer"
+        records_count:
+          zero: "%{total} enregistrement"
+          one: "%{total} enregistrement"
+          other: "%{total} enregistrements"
+        actions_header: "Actions"
+        view: "Voir"
+        edit: "Éditer"
+        delete: "Supprimer"
+        delete_confirm: "Êtes-vous sûr ?"
+        empty_state: "Aucun enregistrement ne correspond à votre recherche."
+      form:
+        error_heading:
+          one: "1 erreur a empêché la sauvegarde :"
+          other: "%{count} erreurs ont empêché la sauvegarde :"
+        cancel: "Annuler"
+        create: "Créer"
+        update: "Mettre à jour"
+        boolean_hint: "Cocher pour activer"
+        array_placeholder: "Saisissez une valeur par ligne ou séparez-les par des virgules"
+        association_limited: "Affichage des %{count} premiers résultats sur %{total} au total. Utilisez la recherche pour affiner."
+      new:
+        page_title: "Nouveau - %{model}"
+        breadcrumb: "Nouveau"
+        heading: "Créer %{model}"
+      edit:
+        page_title: "Éditer - %{model}"
+        breadcrumb: "Éditer"
+        heading: "Éditer %{model} #%{id}"
+      show:
+        page_title: "Détails - %{model}"
+        breadcrumb_id: "#%{id}"
+        heading: "%{model} #%{id}"
+        edit: "Éditer"
+        delete: "Supprimer"
+        delete_confirm: "Êtes-vous sûr de vouloir supprimer cet enregistrement ?"
+        attributes: "Attributs"
+        associations: "Associations"
+        association_count_html:
+          one: "%{number} enregistrement"
+          other: "%{number} enregistrements"
+        association_none: "Aucun"
+        association_error: "Erreur : %{message}"
+        created_at: "Créé le %{date}"
+        updated_at: "Modifié le %{date}"
+      flash:
+        create:
+          success: "%{model} créé avec succès."
+        update:
+          success: "%{model} modifié avec succès."
+        destroy:
+          success: "%{model} supprimé avec succès."
+          dependencies: "Impossible de supprimer : des enregistrements dépendent de cette ressource."
+        bulk:
+          success: "%{count} %{model} supprimé(s) avec succès."
+          selection_required: "Sélectionnez au moins un enregistrement."
+          unsupported_action: "Action de masse non supportée."
+          dependencies: "Impossible de supprimer certains enregistrements car ils possèdent des dépendances."
+        load_model_failed: "Modèle introuvable : %{resource}"
+        not_found: "%{model} introuvable."
+    exports:
+      index:
+        title: "Exports CSV"
+        breadcrumb: "Exports"
+        heading: "Exports CSV"
+        subtitle: "Suivez l'avancement des exports et téléchargez-les une fois prêts."
+        back_to_resources: "Retour au dashboard"
+        processing_hint: "Traitement en cours… Vous pouvez fermer cette page."
+        expiration_hint: "Disponible jusqu'au %{date}"
+        download: "Télécharger"
+        pending: "En attente"
+        delete: "Supprimer"
+        delete_confirm: "Êtes-vous sûr de vouloir supprimer cet export ?"
+        empty: "Aucun export généré pour le moment."
+        table:
+          headers:
+            created_at: "Créé le"
+            resource: "Ressource"
+            status: "Statut"
+            records: "Enregistrements"
+            actions: "Actions"
+      show:
+        title: "Export %{token}"
+        heading: "Export %{resource}"
+        download: "Télécharger le CSV"
+        created_at: "Créé le"
+        status: "Statut"
+        records: "Nombre d'enregistrements"
+        expires_at: "Expire le"
+        error: "Erreur"
+      status:
+        pending: "En attente"
+        processing: "Traitement"
+        ready: "Prêt"
+        failed: "Échec"
+      flash:
+        created: "Export en cours. Rafraîchissez la page des exports pour suivre l'avancement (token %{token})."
+        unavailable: "Le fichier n'est pas encore disponible."
+        expired: "Ce fichier a expiré et n'est plus téléchargeable."
+        not_found: "Export introuvable."
+        destroyed: "Export supprimé avec succès."
+    audit_logs:
+      title: "Journal d'activité"
+      subtitle: "Suivez toutes les actions administratives effectuées dans SuperAdmin."
+      table_title: "Activité récente"
+      unknown_user: "Utilisateur inconnu"
+      view_changes: "Voir les modifications"
+      filters:
+        search: "Rechercher"
+        all_actions: "Toutes les actions"
+        all_resources: "Toutes les ressources"
+        apply: "Filtrer"
+      headers:
+        performed_at: "Effectué le"
+        user: "Utilisateur"
+        resource: "Ressource"
+        action: "Action"
+        changes: "Modifications"
+        context: "Contexte"
+      empty: "Aucune activité enregistrée pour le moment."
+      missing_table: "Le journal d'activité est indisponible. Lancez les migrations SuperAdmin pour créer la table correspondante."
+    helpers:
+      resources:
+        empty_string: "(vide)"
+    actions:
+      close: "Fermer"

data/config/routes.rb

@@ -0,0 +1,22 @@
+SuperAdmin::Engine.routes.draw do
+  root "dashboard#index"
+
+  resources :exports, only: %i[index show create destroy], param: :token do
+    member do
+      get :download
+    end
+  end
+
+  get "associations/search", to: "associations#search", as: :association_search
+
+  resources :audit_logs, only: [ :index ]
+
+  get ":resource", to: "resources#index", as: :resources
+  post ":resource/bulk", to: "resources#bulk", as: :bulk_action
+  get ":resource/new", to: "resources#new", as: :new_resource
+  post ":resource", to: "resources#create"
+  get ":resource/:id", to: "resources#show", as: :resource
+  get ":resource/:id/edit", to: "resources#edit", as: :edit_resource
+  patch ":resource/:id", to: "resources#update"
+  delete ":resource/:id", to: "resources#destroy"
+end

data/lib/generators/super_admin/dashboard_generator.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+require "super_admin/dashboard_creator"
+
+module SuperAdmin
+  module Generators
+    # Generator for creating SuperAdmin dashboard files.
+    # Usage: rails generate super_admin:dashboard [ModelName]
+    class DashboardGenerator < Rails::Generators::Base
+      desc "Generates a SuperAdmin dashboard for a specific model or all models"
+
+      argument :model_name, type: :string, required: false,
+               desc: "Name of the model (optional, generates for all models if omitted)"
+
+      def generate_dashboards
+        # Wrap the Thor shell to provide a puts method
+        generator = self
+        stdout_wrapper = Object.new
+        stdout_wrapper.define_singleton_method(:puts) do |message = ""|
+          generator.say(message)
+        end
+
+        result = SuperAdmin::DashboardCreator.call(
+          model_name: model_name,
+          stdout: stdout_wrapper
+        )
+
+        if result[:generated].empty? && result[:skipped].empty?
+          say "\nNo dashboards were created. Make sure you have ActiveRecord models in your application.", :yellow
+        end
+      end
+
+      def display_next_steps
+        return if @_already_displayed_next_steps
+
+        say "\n"
+        say "Dashboard generation complete! 🎉", :green
+        say "\n"
+        say "Next steps:", :yellow
+        say "  1. Review generated dashboards in app/dashboards/super_admin/"
+        say "  2. Customize attributes and display logic as needed"
+        say "  3. Visit #{SuperAdmin::Engine.routes.url_helpers.root_path rescue '/admin'} to see your admin interface"
+        say "\n"
+
+        @_already_displayed_next_steps = true
+      end
+    end
+  end
+end

data/lib/generators/super_admin/install_generator.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module SuperAdmin
+  module Generators
+    # Generator for installing SuperAdmin in a Rails application.
+    # Usage: rails generate super_admin:install
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Installs SuperAdmin initializer and migrations"
+
+      def copy_initializer_file
+        template "super_admin.rb", "config/initializers/super_admin.rb"
+      end
+
+      def copy_migrations
+        rails_path = File.join(destination_root, "bin/rails")
+
+        unless File.exist?(rails_path)
+          say_status :skip, "bin/rails not found; skipping migration installation", :yellow
+          return
+        end
+
+        in_root do
+          run("bin/rails super_admin:install:migrations")
+        end
+      rescue StandardError => error
+        say_status :warning, "Could not run super_admin:install:migrations (#{error.message})", :yellow
+      end
+
+      def display_post_install_message
+        say "\n"
+        say "SuperAdmin has been installed! 🎉", :green
+        say "\n"
+        say "Next steps:", :yellow
+        say "  1. Run migrations:"
+        say "     rails db:migrate"
+        say "\n"
+        say "  2. Mount the engine in config/routes.rb:"
+        say "     mount SuperAdmin::Engine => '/super_admin'"
+        say "\n"
+        say "  3. Generate dashboards for your models:"
+        say "     rails generate super_admin:dashboard          # All models"
+        say "     rails generate super_admin:dashboard User     # Specific model"
+        say "\n"
+        say "  4. Configure authentication/authorization in:"
+        say "     config/initializers/super_admin.rb"
+        say "\n"
+        say "  5. Start your server and visit /super_admin"
+        say "\n"
+        say "✨ Stimulus controllers are automatically registered - no manual setup needed!", :cyan
+        say "\n"
+      end
+    end
+  end
+end

data/lib/generators/super_admin/templates/20240101000001_create_super_admin_audit_logs.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+class CreateSuperAdminAuditLogs < ActiveRecord::Migration[7.1]
+  def change
+    return if table_exists?(:super_admin_audit_logs)
+
+    create_table :super_admin_audit_logs do |t|
+      t.references :user, null: true, foreign_key: false, index: true
+      t.string :user_email
+      t.string :resource_type, null: false
+      t.string :resource_id
+      t.string :action, null: false
+      t.json :changes_snapshot, null: false, default: {}
+      t.json :context, null: false, default: {}
+      t.datetime :performed_at, null: false
+
+      t.timestamps
+    end
+
+    add_index :super_admin_audit_logs, :performed_at
+    add_index :super_admin_audit_logs, [ :resource_type, :resource_id ]
+    add_index :super_admin_audit_logs, :action
+  end
+end

data/lib/generators/super_admin/templates/20240101000002_create_super_admin_csv_exports.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+class CreateSuperAdminCsvExports < ActiveRecord::Migration[7.1]
+  def change
+    return if table_exists?(:super_admin_csv_exports)
+
+    create_table :super_admin_csv_exports do |t|
+      t.references :user, null: false, foreign_key: false, index: true
+      t.string :resource_name, null: false
+      t.string :model_class_name, null: false
+      t.string :status, null: false, default: "pending"
+      t.json :filters, null: false, default: {}
+      t.string :search
+      t.string :sort
+      t.string :direction
+      t.json :selected_attributes, null: false, default: []
+      t.integer :records_count
+      t.string :error_message
+      t.datetime :started_at
+      t.datetime :completed_at
+      t.datetime :expires_at
+      t.string :token, null: false
+
+      t.timestamps
+    end
+
+    add_index :super_admin_csv_exports, :token, unique: true
+    add_index :super_admin_csv_exports, :status
+    add_index :super_admin_csv_exports, :resource_name
+    add_index :super_admin_csv_exports, :created_at
+    add_index :super_admin_csv_exports, :expires_at
+  end
+end

data/lib/generators/super_admin/templates/super_admin.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+SuperAdmin.configure do |config|
+  # Maximum depth for nested associations when displaying resources
+  # config.max_nested_depth = 2
+
+  # Limit for association select dropdowns
+  # config.association_select_limit = 10
+
+  # Pagination limit for associations lists
+  # config.association_pagination_limit = 20
+
+  # Enable or disable search in association selects
+  # config.enable_association_search = true
+
+  # Authentication
+  # Configure how to authenticate users accessing SuperAdmin
+  # config.authenticate_with = proc { authenticate_user! }
+
+  # Current user method
+  # Method to call to get the current user
+  # config.current_user_method = :current_user
+
+  # User class
+  # The class representing users in your application
+  # config.user_class = "User"
+
+  # Authorization
+  # Configure authorization adapter (:auto, :pundit, :cancancan, or :custom)
+  # config.authorization_adapter = :auto
+
+  # Custom authorization block (when using :custom adapter)
+  # config.authorize_with = proc { |controller|
+  #   redirect_to main_app.root_path unless current_user&.admin?
+  # }
+
+  # What to do when authorization fails
+  # config.on_unauthorized = proc { |controller|
+  #   redirect_to main_app.root_path, alert: "You are not authorized to access this page."
+  # }
+
+  # Super admin check
+  # Additional check to determine if current user is a super admin
+  # config.super_admin_check = proc { |user|
+  #   user.has_role?(:super_admin)
+  # }
+
+  # Layout
+  # Layout to use for SuperAdmin views
+  # config.layout = "super_admin"
+
+  # Parent controller
+  # Controller from which SuperAdmin controllers inherit
+  # config.parent_controller = "::ApplicationController"
+
+  # Default locale
+  # config.default_locale = :en
+end