rails_nexus 2.0.0

data/config/locales/en.yml

@@ -0,0 +1,47 @@
+en:
+  rails_nexus:
+    logged_exceptions:
+      index:
+        title: Logged Exceptions
+        subtitle: Review, filter, and remove application exceptions.
+        filters: Filters
+        latest_exceptions: Latest Exceptions
+        exception: Exception
+        controller_action: Controller / Action
+        dates: Dates
+        today: Today
+        last_few_days: Last few days
+        last_7_days: Last 7 days
+        last_30_days: Last 30 days
+        clear_history: Clear history
+        confirm_clear: Clear the complete exception history?
+        search: Search
+        search_placeholder: Search messages
+        find: Find
+        loading: Loading exceptions…
+        select_exception: Select an exception to inspect its details.
+      _exceptions:
+        heading: Exceptions
+        filtered: filtered
+        count: "%{count} total"
+        empty: No exceptions match these filters.
+        exception: Exception
+        date: Date
+        actions: Actions
+        delete: Delete
+        delete_visible: Delete visible
+        confirm_delete: Delete this exception?
+        confirm_delete_visible: Delete all visible exceptions?
+      _show:
+        close: Close
+        request: Request
+        message: Message
+        backtrace: Backtrace
+        environment: Environment
+        delete: Delete exception
+        confirm_delete: Delete this exception?
+      _feed:
+        rss_feed: Subscribe to the RSS feed
+      show:
+        title: Logged Exception
+

data/config/routes.rb

@@ -0,0 +1,58 @@
+RailsNexus::Engine.routes.draw do
+  resources :logged_exceptions do
+    collection do
+      post :clear
+      match :query, via: %i[get post]
+      post :destroy_all
+      get :feed
+    end
+    member do
+      post :assign, to: "workflow#assign"
+      post :set_priority, to: "workflow#set_priority"
+      post :snooze, to: "workflow#snooze"
+      post :mute, to: "workflow#mute"
+      post :unmute, to: "workflow#unmute"
+      post :add_comment, to: "workflow#add_comment"
+    end
+  end
+
+  # Server statistics
+  get "stats", to: "stats#index", as: :stats
+
+  # Database health
+  get "database_health", to: "database_health#index", as: :database_health
+
+  # Real-time analytics
+  get "analytics", to: "analytics#index", as: :analytics
+
+  # Cron job monitoring
+  resources :cron_jobs, only: [:index, :show, :destroy] do
+    collection do
+      delete :clear_old
+    end
+    member do
+      post :retry_job
+    end
+  end
+
+  # Source code viewing
+  get "source_code", to: "source_code#show", as: :source_code
+
+  # N+1 query patterns
+  get "n1_patterns", to: "n1_patterns#index", as: :n1_patterns
+
+  # Backup management
+  get "backup", to: "backup#index", as: :backup
+  get "backup/files", to: "backup#files", as: :backup_files
+  post "backup/trigger/:model", to: "backup#trigger", as: :backup_trigger
+  get "backup/health", to: "backup#health", as: :backup_health
+  get "backup/settings", to: "backup#settings", as: :backup_settings
+  patch "backup/settings", to: "backup#update_settings", as: :backup_update_settings
+
+  # Settings and webhook management
+  get "settings", to: "settings#index", as: :settings
+  post "settings/test_webhook", to: "settings#test_webhook", as: :test_webhook
+  get "settings/deliveries", to: "settings#deliveries", as: :webhook_deliveries
+
+  root :to => 'logged_exceptions#index'
+end

data/db/migrate/20240330122311_create_rails_nexus_logged_exceptions.rb

@@ -0,0 +1,22 @@
+class CreateRailsNexusLoggedExceptions < ActiveRecord::Migration[8.0]
+  def change
+    create_table :rails_nexus_exceptions do |t|
+      t.string :exception_class
+      t.string :controller_name
+      t.string :action_name
+      t.text :message
+      t.text :backtrace
+      t.text :environment
+      t.text :request
+      t.string :user_info
+      t.string :user_agent
+      t.string :remote_ip
+
+      t.timestamps
+    end
+
+    add_index :rails_nexus_exceptions, :created_at
+    add_index :rails_nexus_exceptions, :exception_class
+    add_index :rails_nexus_exceptions, [:controller_name, :action_name]
+  end
+end

data/lib/generators/rails_nexus/backup_generator.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/erb"
+
+module RailsNexus
+  module Generators
+    class BackupGenerator < Rails::Generators::Base
+      desc "Set up rails_nexus backup directory structure and models"
+      source_root File.expand_path("templates/backup", __dir__)
+
+      def create_backup_directories
+        empty_directory "config/backup"
+        empty_directory "config/backup/models"
+        empty_directory "config/backup/mysql-config"
+        empty_directory "storage/rails_nexus/backups"
+        empty_directory "storage/rails_nexus/backups/sync"
+        empty_directory "storage/rails_nexus/backups/logs"
+      end
+
+      def create_config_template
+        template "config.rb", "config/backup/config.rb"
+      end
+
+      def create_model_templates
+        template "models/daily_backup.rb", "config/backup/models/daily_backup.rb"
+        template "models/full_backup.rb", "config/backup/models/full_backup.rb"
+        template "models/sync_backup.rb", "config/backup/models/sync_backup.rb"
+      end
+
+      def create_schedule_template
+        template "schedule.rb", "config/backup/schedule.rb"
+      end
+
+      def create_helper_script
+        template "backup_helper.sh", "bin/rails_nexus-backup"
+        chmod "bin/rails_nexus-backup", 0o755
+      end
+
+      def create_mysql_config
+        template "mysql-config/db_config.cnf", "config/backup/mysql-config/db_config.cnf"
+      end
+
+      def add_to_gitignore
+        append_to_file ".gitignore", <<~GITIGNORE unless File.exist?(".gitignore") && File.read(".gitignore").include?("rails_nexus/backups")
+          \n# RailsNexus backups
+          storage/rails_nexus/backups/
+          config/backup/mysql-config/db_config.cnf
+        GITIGNORE
+      end
+
+      def show_readme
+        say ""
+        say "✅ Backup directory structure created!", :green
+        say ""
+        say "Next steps:"
+        say "  1. Edit config/backup/config.rb with your database credentials"
+        say "  2. Customize models in config/backup/models/"
+        say "  3. Install the schedule: whenever --write-crontab"
+        say "  4. Test: bin/rails_nexus-backup status"
+        say ""
+        say "Backup models created:"
+        say "  - daily_backup:  Incremental (skips large tables), local + remote"
+        say "  - full_backup:   All tables, local only"
+        say "  - sync_backup:   Remote sync to backup server"
+        say ""
+      end
+    end
+  end
+end

data/lib/generators/rails_nexus/customize_generator.rb

@@ -0,0 +1,159 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module RailsNexus
+  module Generators
+    class CustomizeGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc <<~DESC
+        Generate customizable RailsNexus dashboard files.
+
+        Creates modern views, host-app-integrated layout, Stimulus controller,
+        and initializer patches for your Rails application.
+
+        Usage:
+          rails generate rails_nexus:customize
+          rails generate rails_nexus:customize --layout-only
+          rails generate rails_nexus:customize --views-only
+          rails generate rails_nexus:customize --stimulus-only
+          rails generate rails_nexus:customize --initializer-only
+      DESC
+
+      class_option :layout_only, type: :boolean, default: false, desc: "Only generate the layout"
+      class_option :views_only, type: :boolean, default: false, desc: "Only generate the views"
+      class_option :stimulus_only, type: :boolean, default: false, desc: "Only generate the Stimulus controller"
+      class_option :initializer_only, type: :boolean, default: false, desc: "Only generate the initializer patches"
+      class_option :force, type: :boolean, default: false, desc: "Overwrite existing files"
+
+      def generate_layout
+        return unless generate_all? || options[:layout_only]
+
+        template "views/layouts/rails_nexus/application.html.erb",
+                 "app/views/layouts/rails_nexus/application.html.erb"
+      end
+
+      def generate_views
+        return unless generate_all? || options[:views_only]
+
+        template "views/rails_nexus/logged_exceptions/index.html.erb",
+                 "app/views/rails_nexus/logged_exceptions/index.html.erb"
+
+        template "views/rails_nexus/logged_exceptions/_exceptions.html.erb",
+                 "app/views/rails_nexus/logged_exceptions/_exceptions.html.erb"
+
+        template "views/rails_nexus/logged_exceptions/_show.html.erb",
+                 "app/views/rails_nexus/logged_exceptions/_show.html.erb"
+      end
+
+      def generate_stimulus
+        return unless generate_all? || options[:stimulus_only]
+
+        target_dir = "app/javascript/rails_nexus/controllers"
+
+        template "javascript/controllers/rails_nexus_controller.js",
+                 "#{target_dir}/rails_nexus_controller.js"
+        template "javascript/controllers/rails_nexus_detail_controller.js",
+                 "#{target_dir}/rails_nexus_detail_controller.js"
+        template "javascript/controllers/rails_nexus_theme_controller.js",
+                 "#{target_dir}/rails_nexus_theme_controller.js"
+        template "javascript/controllers/rails_nexus_sidebar_controller.js",
+                 "#{target_dir}/rails_nexus_sidebar_controller.js"
+
+        # Create a standalone manifest under rails_nexus/ so it works
+        # with both esbuild (jsbundling) and importmap.
+        # This avoids conflict with stimulus:manifest:update which
+        # only scans app/javascript/controllers/.
+        create_file "app/javascript/rails_nexus/index.js" do
+          <<~JS
+            import { application } from "../controllers/application"
+
+            import RailsNexusController from "./controllers/rails_nexus_controller"
+            application.register("rails_nexus", RailsNexusController)
+
+            import RailsNexusDetailController from "./controllers/rails_nexus_detail_controller"
+            application.register("rails_nexus-detail", RailsNexusDetailController)
+
+            import RailsNexusThemeController from "./controllers/rails_nexus_theme_controller"
+            application.register("rails_nexus-theme", RailsNexusThemeController)
+
+            import RailsNexusSidebarController from "./controllers/rails_nexus_sidebar_controller"
+            application.register("rails_nexus-sidebar", RailsNexusSidebarController)
+          JS
+        end
+
+        # Inject import into application.js if not already present
+        app_js = "app/javascript/application.js"
+        if File.exist?(app_js)
+          content = File.read(app_js)
+          unless content.include?("rails_nexus")
+            inject_into_file app_js,
+              'import "./rails_nexus"
+',
+              after: /import.*controllers.*\n/
+          end
+        end
+      end
+
+      def generate_initializer_patches
+        return unless generate_all? || options[:initializer_only]
+
+        append_to_file "config/initializers/rails_nexus.rb" do
+          "\n# --- RailsNexus Customize Generator Patches ---\n" \
+          "\n" \
+          "# Make host app helpers available in rails_nexus views.\n" \
+          "# Uncomment the helpers your app defines:\n" \
+          "# RailsNexus::LoggedExceptionsController.helper HeroiconHelper\n" \
+          "# RailsNexus::LoggedExceptionsController.helper ApplicationHelper\n" \
+          "\n" \
+          "# Fix for Rails 8.1+: params_filters must return plain hashes.\n" \
+          "# This is applied automatically by the gem (v0.5.1+).\n" \
+          "# Uncomment below if needed:\n" \
+          "# RailsNexus::LoggedExceptionsController.class_eval do\n" \
+          "#   private\n" \
+          "#   def params_filters\n" \
+          "#     result = {}\n" \
+          "#     result[:q] = params[:q].to_unsafe_h if params[:q].present?\n" \
+          "#     result[:query] = params[:query] if params[:query].present?\n" \
+          "#     result[:date_ranges_filter] = params[:date_ranges_filter] if params[:date_ranges_filter].present?\n" \
+          "#     result[:exception_names_filter] = params[:exception_names_filter] if params[:exception_names_filter].present?\n" \
+          "#     result[:controller_actions_filter] = params[:controller_actions_filter] if params[:controller_actions_filter].present?\n" \
+          "#     result\n" \
+          "#   end\n" \
+          "# end\n"
+        end
+      end
+
+      def display_post_install
+        return unless generate_all?
+
+        say ""
+        say "RailsNexus customization files generated!", :green
+        say ""
+        say "Generated files:"
+        say "  - app/views/layouts/rails_nexus/application.html.erb (host-app layout)"
+        say "  - app/views/rails_nexus/logged_exceptions/index.html.erb"
+        say "  - app/views/rails_nexus/logged_exceptions/_exceptions.html.erb"
+        say "  - app/views/rails_nexus/logged_exceptions/_show.html.erb"
+        say "  - app/javascript/rails_nexus/controllers/rails_nexus_controller.js"
+        say "  - app/javascript/rails_nexus/controllers/rails_nexus_detail_controller.js"
+        say "  - app/javascript/rails_nexus/controllers/rails_nexus_theme_controller.js"
+        say "  - app/javascript/rails_nexus/controllers/rails_nexus_sidebar_controller.js"
+        say ""
+        say "Next steps:"
+        say "  1. Edit the layout to match your host app's navigation"
+        say "  2. If using Tailwind, add to your CSS source paths:"
+        say '     @source "path/to/rails_nexus/app/views/**/*.erb";'
+        say ""
+      end
+
+      private
+
+      def generate_all?
+        !options[:layout_only] && !options[:views_only] &&
+          !options[:stimulus_only] && !options[:initializer_only]
+      end
+    end
+  end
+end

data/lib/generators/rails_nexus/install_generator.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+
+module RailsNexus
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include Rails::Generators::Migration
+
+      MIGRATIONS = {
+        "migration.rb" => "create_rails_nexus_exceptions.rb",
+        "migration_advanced_features.rb" => "add_advanced_features_to_rails_nexus_exceptions.rb",
+        "migration_platform_detection.rb" => "add_platform_to_rails_nexus_exceptions.rb",
+        "migration_workflow.rb" => "add_workflow_to_rails_nexus.rb",
+        "migration_cron_jobs.rb" => "create_rails_nexus_cron_jobs.rb",
+        "migration_webhook_deliveries.rb" => "create_rails_nexus_webhook_deliveries.rb",
+        "migration_new_schema.rb" => "create_rails_nexus_metrics_tables.rb"
+      }.freeze
+
+      source_root File.expand_path("templates", __dir__)
+      desc "Install RailsNexus into your Rails application"
+
+      def self.next_migration_number(dirname)
+        ActiveRecord::Generators::Base.next_migration_number(dirname)
+      end
+
+      def create_migration_files
+        MIGRATIONS.each do |source, destination|
+          migration_template source, "db/migrate/#{destination}"
+        end
+      end
+
+      def create_initializer
+        template "rails_nexus.rb", "config/initializers/rails_nexus.rb"
+      end
+
+      def mount_routes
+        route 'mount RailsNexus::Engine, at: "/rails_nexus"'
+      end
+
+      def add_rescue_from
+        app_controller = "app/controllers/application_controller.rb"
+        destination_controller = File.join(destination_root, app_controller)
+
+        if File.exist?(destination_controller)
+          content = File.read(destination_controller)
+          unless content.include?("log_exception_handler")
+            inject_into_class app_controller, "ApplicationController" do
+              "\n  rescue_from Exception, with: :log_exception_handler\n"
+            end
+          end
+        end
+      end
+
+      def show_readme
+        readme "INSTALL.md" if behavior == :invoke
+      end
+    end
+  end
+end

data/lib/generators/rails_nexus/templates/INSTALL.md

@@ -0,0 +1,9 @@
+RailsNexus has been installed.
+
+Next steps:
+
+1. Review `config/initializers/rails_nexus.rb` and configure `auth_block`.
+2. Run `bin/rails db:migrate`.
+3. Visit `/rails_nexus` in the host application.
+
+The dashboard denies access until authentication is configured.

data/lib/generators/rails_nexus/templates/backup/backup_helper.sh

@@ -0,0 +1,152 @@
+#!/bin/bash
+# RailsNexus Backup Helper Script
+# Generated by: rails generate rails_nexus:backup
+#
+# Usage:
+#   ./backup_helper.sh run <model>     Run a backup model
+#   ./backup_helper.sh list            List backup files
+#   ./backup_helper.sh status          Show backup health status
+#   ./backup_helper.sh clean <days>    Remove backups older than N days
+
+set -e
+
+# Configuration
+BACKUP_DIR="${BACKUP_DUMP_PATH:-storage/rails_nexus/backups}"
+BUNDLE_PATH="${BUNDLE_PATH:-.bundle}"
+RUBY_ENV="${RUBY_ENV:-production}"
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m'
+
+log_info() { echo -e "${GREEN}[INFO]${NC} $1"; }
+log_warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
+log_error() { echo -e "${RED}[ERROR]${NC} $1"; }
+
+# Run a backup
+run_backup() {
+  local model="$1"
+  if [ -z "$model" ]; then
+    log_error "Usage: $0 run <model_name>"
+    exit 1
+  fi
+  
+  # Lock to prevent concurrent runs
+  LOCKFILE="/tmp/rails_nexus_backup_${model}.lock"
+  exec 200>"$LOCKFILE"
+  if ! flock -n 200; then
+    log_warn "Backup '$model' is already running. Skipping."
+    exit 0
+  fi
+  
+  log_info "Running backup: $model"
+  cd "$(dirname "$0")/../../.."
+  
+  if bundle exec backup perform -t "$model" --triggered_by rails_nexus; then
+    log_info "Backup '$model' completed successfully."
+  else
+    log_error "Backup '$model' FAILED."
+    exit 1
+  fi
+}
+
+# List backup files
+list_backups() {
+  local dir="$BACKUP_DIR"
+  if [ ! -d "$dir" ]; then
+    log_warn "No backup directory found at: $dir"
+    exit 0
+  fi
+  
+  echo "Backup files in: $dir"
+  echo "─────────────────────────────────────────────"
+  printf "%-40s %10s %s\n" "FILE" "SIZE" "MODIFIED"
+  echo "─────────────────────────────────────────────"
+  
+  find "$dir" -maxdepth 1 -type f -name "*.tar.gz*" -o -name "*.sql.gz*" | sort -r | head -20 | while read -r f; do
+    size=$(du -h "$f" | cut -f1)
+    modified=$(stat -c "%y" "$f" 2>/dev/null | cut -d'.' -f1 || date -r "$f" "+%Y-%m-%d %H:%M")
+    printf "%-40s %10s %s\n" "$(basename "$f")" "$size" "$modified"
+  done
+}
+
+# Show backup status
+show_status() {
+  local dir="$BACKUP_DIR"
+  if [ ! -d "$dir" ]; then
+    echo "Status: NOT_CONFIGURED"
+    echo "No backup directory at: $dir"
+    exit 0
+  fi
+  
+  local total_files
+  total_files=$(find "$dir" -maxdepth 1 -type f | wc -l)
+  local total_size
+  total_size=$(du -sh "$dir" 2>/dev/null | cut -f1 || echo "0B")
+  
+  local latest_file
+  latest_file=$(find "$dir" -maxdepth 1 -type f -name "*.tar.gz*" -o -name "*.sql.gz*" 2>/dev/null | sort -r | head -1)
+  
+  if [ -z "$latest_file" ]; then
+    echo "Status: WARNING - No backup files found"
+  else
+    local age_hours
+    age_hours=$(( ($(date +%s) - $(stat -c "%Y" "$latest_file" 2>/dev/null || stat -f "%m" "$latest_file")) / 3600 ))
+    
+    if [ "$age_hours" -lt 24 ]; then
+      echo "Status: HEALTHY"
+    elif [ "$age_hours" -lt 72 ]; then
+      echo "Status: WARNING - Last backup ${age_hours}h ago"
+    else
+      echo "Status: CRITICAL - Last backup ${age_hours}h ago"
+    fi
+  fi
+  
+  echo "Files: $total_files"
+  echo "Size: $total_size"
+  [ -n "$latest_file" ] && echo "Latest: $(basename "$latest_file")"
+}
+
+# Clean old backups
+clean_backups() {
+  local days="${1:-30}"
+  local dir="$BACKUP_DIR"
+  
+  if [ ! -d "$dir" ]; then
+    log_warn "No backup directory found at: $dir"
+    exit 0
+  fi
+  
+  log_info "Removing backups older than $days days..."
+  find "$dir" -maxdepth 1 -type f -mtime +"$days" -delete
+  log_info "Cleanup complete."
+}
+
+# Main
+case "${1:-help}" in
+  run)
+    run_backup "$2"
+    ;;
+  list)
+    list_backups
+    ;;
+  status)
+    show_status
+    ;;
+  clean)
+    clean_backups "$2"
+    ;;
+  *)
+    echo "RailsNexus Backup Helper"
+    echo ""
+    echo "Usage: $0 <command> [args]"
+    echo ""
+    echo "Commands:"
+    echo "  run <model>    Run a backup model (e.g., daily_backup)"
+    echo "  list           List recent backup files"
+    echo "  status         Show backup health status"
+    echo "  clean [days]   Remove backups older than N days (default: 30)"
+    ;;
+esac

data/lib/generators/rails_nexus/templates/backup/config.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+
+##
+# Backup v5.x Configuration
+# Generated by rails_nexus
+#
+# Documentation: http://backup.github.io/backup
+#
+
+# Logging
+# Logger.configure do
+#   console.quiet     = true
+#   logfile.max_bytes = 2_000_000
+#   syslog.enabled    = true
+#   syslog.ident      = '<%= Rails.application.class.module_parent_name.underscore %>_backup'
+# end
+
+# Storage defaults
+# Storage::Local.defaults do |local|
+#   local.path = 'storage/rails_nexus/backups'
+# end
+
+# Notifier defaults
+# Notifier::Mail.defaults do |mail|
+#   mail.from = 'backup@<%= Rails.application.class.module_parent_name.underscore %>.com'
+#   mail.to   = 'admin@<%= Rails.application.class.module_parent_name.underscore %>.com'
+# end

data/lib/generators/rails_nexus/templates/backup/models/daily_backup.rb

@@ -0,0 +1,24 @@
+# encoding: utf-8
+
+# Daily Backup - Generated by rails_nexus
+# Skips large/temporary tables for faster backups
+
+Model.new(:daily_backup, '<%= Rails.application.class.module_parent_name %> Daily Backup') do
+
+  ## MySQL [Database]
+  database MySQL do |db|
+    db.name               = "<%= Rails.configuration.database_configuration[Rails.env]['database'] %>"
+    db.port               = <%= Rails.configuration.database_configuration[Rails.env]['port'] || 3306 %>
+    db.skip_tables        = []
+    db.additional_options = ["--quick"]
+  end
+
+  ## Local [Storage]
+  store_with Local do |local|
+    local.path = 'storage/rails_nexus/backups'
+    local.keep = 30
+  end
+
+  ## Gzip [Compressor]
+  compress_with Gzip
+end

data/lib/generators/rails_nexus/templates/backup/models/full_backup.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+# Full backup template — all tables, local storage only
+
+model :full_backup do
+  # Database
+  database Mysql do |db|
+    db.name = ENV["DATABASE_NAME"] || "myapp_production"
+    db.username = ENV["DATABASE_USER"] || "root"
+    db.password = ENV["DATABASE_PASSWORD"] || ""
+    db.host = ENV["DATABASE_HOST"] || "localhost"
+    db.port = (ENV["DATABASE_PORT"] || 3306).to_i
+    db.dump_options = {
+      single_transaction: true,
+      add_lock_tables: false
+    }
+  end
+
+  # Compress with Gzip
+  compress_with Gzip
+
+  # Store locally
+  store_with Local do |local|
+    local.path = ENV["BACKUP_DUMP_PATH"] || File.expand_path("storage/rails_nexus/backups", Rails.root)
+    local.keep = 10
+  end
+
+  # Notify on failure (optional)
+  notify_by Mail do |mail|
+    mail.on_success = false
+    mail.on_failure = true
+    mail.from = ENV["BACKUP_MAIL_FROM"] || "backup@example.com"
+    mail.to = ENV["BACKUP_MAIL_TO"] || "admin@example.com"
+    mail.smtp = { address: ENV["SMTP_HOST"] || "localhost", port: ENV["SMTP_PORT"] || 587 }
+  end
+end