rails_error_dashboard 0.1.0

data/app/mailers/rails_error_dashboard/error_notification_mailer.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  class ErrorNotificationMailer < ApplicationMailer
+    def error_alert(error_log, recipients)
+      @error_log = error_log
+      @dashboard_url = dashboard_url(error_log)
+
+      mail(
+        to: recipients,
+        subject: "🚨 [#{error_log.environment.upcase}] #{error_log.error_type}: #{truncate_subject(error_log.message)}"
+      )
+    end
+
+    private
+
+    def dashboard_url(error_log)
+      base_url = RailsErrorDashboard.configuration.dashboard_base_url || "http://localhost:3000"
+      "#{base_url}/error_dashboard/errors/#{error_log.id}"
+    end
+
+    def truncate_subject(message)
+      return "" unless message
+      message.length > 50 ? "#{message[0...50]}..." : message
+    end
+  end
+end

data/app/models/rails_error_dashboard/application_record.rb

@@ -0,0 +1,5 @@
+module RailsErrorDashboard
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/rails_error_dashboard/error_log.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  class ErrorLog < ErrorLogsRecord
+    self.table_name = "rails_error_dashboard_error_logs"
+
+    # User association - works with both single and separate database
+    # When using separate database, joins are not possible, but Rails
+    # will automatically fetch users in a separate query when using includes()
+    # Only define association if User model exists
+    if defined?(::User)
+      belongs_to :user, optional: true
+    end
+
+    validates :error_type, presence: true
+    validates :message, presence: true
+    validates :environment, presence: true
+    validates :occurred_at, presence: true
+
+    scope :unresolved, -> { where(resolved: false) }
+    scope :resolved, -> { where(resolved: true) }
+    scope :recent, -> { order(occurred_at: :desc) }
+    scope :by_environment, ->(env) { where(environment: env) }
+    scope :by_error_type, ->(type) { where(error_type: type) }
+    scope :by_type, ->(type) { where(error_type: type) }
+    scope :by_platform, ->(platform) { where(platform: platform) }
+    scope :last_24_hours, -> { where("occurred_at >= ?", 24.hours.ago) }
+    scope :last_week, -> { where("occurred_at >= ?", 1.week.ago) }
+
+    # Set defaults and tracking
+    before_validation :set_defaults, on: :create
+    before_create :set_tracking_fields
+
+    def set_defaults
+      self.environment ||= Rails.env.to_s
+      self.platform ||= "API"
+    end
+
+    def set_tracking_fields
+      self.error_hash ||= generate_error_hash
+      self.first_seen_at ||= Time.current
+      self.last_seen_at ||= Time.current
+      self.occurrence_count ||= 1
+    end
+
+    # Generate unique hash for error grouping
+    # Includes controller/action for better context-aware grouping
+    def generate_error_hash
+      # Hash based on error class, normalized message, first stack frame, controller, and action
+      digest_input = [
+        error_type,
+        message&.gsub(/\d+/, "N")&.gsub(/"[^"]*"/, '""'), # Normalize numbers and strings
+        backtrace&.lines&.first&.split(":")&.first, # Just the file, not line number
+        controller_name, # Controller context
+        action_name      # Action context
+      ].compact.join("|")
+
+      Digest::SHA256.hexdigest(digest_input)[0..15]
+    end
+
+    # Check if this is a critical error
+    def critical?
+      CRITICAL_ERROR_TYPES.include?(error_type)
+    end
+
+    # Check if error is recent (< 1 hour)
+    def recent?
+      occurred_at >= 1.hour.ago
+    end
+
+    # Check if error is old unresolved (> 7 days)
+    def stale?
+      !resolved? && occurred_at < 7.days.ago
+    end
+
+    # Get severity level
+    def severity
+      return :critical if CRITICAL_ERROR_TYPES.include?(error_type)
+      return :high if HIGH_SEVERITY_ERROR_TYPES.include?(error_type)
+      return :medium if MEDIUM_SEVERITY_ERROR_TYPES.include?(error_type)
+      :low
+    end
+
+    CRITICAL_ERROR_TYPES = %w[
+      SecurityError
+      NoMemoryError
+      SystemStackError
+      SignalException
+      ActiveRecord::StatementInvalid
+    ].freeze
+
+    HIGH_SEVERITY_ERROR_TYPES = %w[
+      ActiveRecord::RecordNotFound
+      ArgumentError
+      TypeError
+      NoMethodError
+      NameError
+    ].freeze
+
+    MEDIUM_SEVERITY_ERROR_TYPES = %w[
+      ActiveRecord::RecordInvalid
+      Timeout::Error
+      Net::ReadTimeout
+      Net::OpenTimeout
+    ].freeze
+
+    # Find existing error by hash or create new one
+    # This is CRITICAL for accurate occurrence tracking
+    def self.find_or_increment_by_hash(error_hash, attributes = {})
+      # Look for unresolved error with same hash in last 24 hours
+      # (resolved errors are considered "fixed" so new occurrence = new issue)
+      existing = unresolved
+                  .where(error_hash: error_hash)
+                  .where("occurred_at >= ?", 24.hours.ago)
+                  .order(last_seen_at: :desc)
+                  .first
+
+      if existing
+        # Increment existing error
+        existing.update!(
+          occurrence_count: existing.occurrence_count + 1,
+          last_seen_at: Time.current,
+          # Update context from latest occurrence
+          user_id: attributes[:user_id] || existing.user_id,
+          request_url: attributes[:request_url] || existing.request_url,
+          request_params: attributes[:request_params] || existing.request_params,
+          user_agent: attributes[:user_agent] || existing.user_agent,
+          ip_address: attributes[:ip_address] || existing.ip_address
+        )
+        existing
+      else
+        # Create new error record
+        # Ensure resolved has a value (default to false)
+        create!(attributes.reverse_merge(resolved: false))
+      end
+    end
+
+    # Log an error with context (delegates to Command)
+    def self.log_error(exception, context = {})
+      Commands::LogError.call(exception, context)
+    end
+
+    # Mark error as resolved (delegates to Command)
+    def resolve!(resolution_data = {})
+      Commands::ResolveError.call(id, resolution_data)
+    end
+
+    # Get error statistics
+    def self.statistics(days = 7)
+      start_date = days.days.ago
+
+      {
+        total: where("occurred_at >= ?", start_date).count,
+        unresolved: where("occurred_at >= ?", start_date).unresolved.count,
+        by_type: where("occurred_at >= ?", start_date)
+          .group(:error_type)
+          .count
+          .sort_by { |_, count| -count }
+          .to_h,
+        by_day: where("occurred_at >= ?", start_date)
+          .group("DATE(occurred_at)")
+          .count
+      }
+    end
+
+    # Find related errors of the same type
+    def related_errors(limit: 5)
+      self.class.where(error_type: error_type)
+          .where.not(id: id)
+          .order(occurred_at: :desc)
+          .limit(limit)
+    end
+
+    private
+
+    # Override user association to use configured user model
+    def self.belongs_to(*args, **options)
+      if args.first == :user
+        user_model = RailsErrorDashboard.configuration.user_model
+        options[:class_name] = user_model if user_model.present?
+      end
+      super
+    end
+  end
+end

data/app/models/rails_error_dashboard/error_logs_record.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Abstract base class for models stored in the error_logs database
+#
+# By default, this connects to the same database as the main application.
+#
+# To enable a separate error logs database:
+# 1. Set use_separate_database: true in the gem configuration
+# 2. Configure error_logs_database settings in config/database.yml
+# 3. Run: rails db:create:error_logs
+# 4. Run: rails db:migrate:error_logs
+#
+# Benefits of separate database:
+# - Performance isolation (error logging doesn't slow down user requests)
+# - Independent scaling (can put error DB on separate server)
+# - Different retention policies (archive old errors without affecting main data)
+# - Security isolation (different access controls for error logs)
+#
+# Trade-offs:
+# - No foreign keys between error_logs and users tables
+# - No joins across databases (Rails handles with separate queries)
+# - Slightly more complex operations (need to manage 2 databases)
+
+module RailsErrorDashboard
+  class ErrorLogsRecord < ActiveRecord::Base
+    self.abstract_class = true
+
+    # Connect to error_logs database (or primary if not using separate DB)
+    # Only connect to separate database if configuration is enabled
+    if RailsErrorDashboard.configuration&.use_separate_database
+      connects_to database: { writing: :error_logs, reading: :error_logs }
+    end
+  end
+end

data/app/views/layouts/rails_error_dashboard/application.html.erb

@@ -0,0 +1,17 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Rails error dashboard</title>
+  <%= csrf_meta_tags %>
+  <%= csp_meta_tag %>
+
+  <%= yield :head %>
+
+  <%= stylesheet_link_tag    "rails_error_dashboard/application", media: "all" %>
+</head>
+<body>
+
+<%= yield %>
+
+</body>
+</html>

data/app/views/layouts/rails_error_dashboard.html.erb

@@ -0,0 +1,351 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Error Dashboard - Audio Intelli API</title>
+    <meta name="viewport" content="width=device-width,initial-scale=1">
+    <%= csrf_meta_tags %>
+    <%= csp_meta_tag %>
+
+    <!-- Bootstrap CSS -->
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
+    <!-- Bootstrap Icons -->
+    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.0/font/bootstrap-icons.css">
+    <!-- Chart.js with date adapter -->
+    <script src="https://cdn.jsdelivr.net/npm/chart.js@4.4.0/dist/chart.umd.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/chartjs-adapter-date-fns@3.0.0/dist/chartjs-adapter-date-fns.bundle.min.js"></script>
+    <script src="https://cdn.jsdelivr.net/npm/chartkick@5.0.1/dist/chartkick.min.js"></script>
+
+    <style>
+      :root {
+        --primary-color: #8B5CF6;
+        --success-color: #10B981;
+        --danger-color: #EF4444;
+        --warning-color: #F59E0B;
+        --info-color: #3B82F6;
+      }
+
+      /* Light mode (default) */
+      body {
+        --bg-color: #F3F4F6;
+        --text-color: #1F2937;
+        --card-bg: #FFFFFF;
+        --sidebar-bg: #FFFFFF;
+        --sidebar-hover: #F9FAFB;
+        --border-color: #E5E7EB;
+        --table-hover: #F9FAFB;
+        --nav-active-bg: #EDE9FE;
+        background-color: var(--bg-color);
+        color: var(--text-color);
+        font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
+        transition: background-color 0.3s ease, color 0.3s ease;
+      }
+
+      /* Dark mode */
+      body.dark-mode {
+        --bg-color: #1A1B26;
+        --text-color: #E4E5E9;
+        --card-bg: #24283B;
+        --sidebar-bg: #1F2130;
+        --sidebar-hover: #2A2D3E;
+        --border-color: #414868;
+        --table-hover: #2A2D3E;
+        --nav-active-bg: #2A2D3E;
+      }
+
+      .card {
+        background-color: var(--card-bg);
+        color: var(--text-color);
+        border-color: var(--border-color);
+      }
+
+      .card-header {
+        background-color: var(--card-bg) !important;
+        color: var(--text-color);
+        border-color: var(--border-color);
+      }
+
+      .navbar {
+        background: linear-gradient(135deg, var(--primary-color), #6D28D9);
+        box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+      }
+
+      .sidebar {
+        background: var(--sidebar-bg);
+        min-height: calc(100vh - 56px);
+        box-shadow: 2px 0 4px rgba(0,0,0,0.05);
+      }
+
+      .sidebar .nav-link {
+        color: var(--text-color);
+        padding: 0.75rem 1.5rem;
+        border-left: 3px solid transparent;
+        transition: all 0.2s;
+      }
+
+      .sidebar .nav-link:hover {
+        background-color: var(--sidebar-hover);
+        color: var(--primary-color);
+        border-left-color: var(--primary-color);
+      }
+
+      .sidebar .nav-link.active {
+        background-color: var(--nav-active-bg);
+        color: var(--primary-color);
+        border-left-color: var(--primary-color);
+        font-weight: 600;
+      }
+
+      .stat-card {
+        border-radius: 0.75rem;
+        border: none;
+        box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+        transition: transform 0.2s, box-shadow 0.2s;
+      }
+
+      .stat-card:hover {
+        transform: translateY(-2px);
+        box-shadow: 0 4px 6px rgba(0,0,0,0.1);
+      }
+
+      .stat-value {
+        font-size: 2rem;
+        font-weight: 700;
+      }
+
+      .stat-label {
+        color: #6B7280;
+        font-size: 0.875rem;
+        text-transform: uppercase;
+        letter-spacing: 0.05em;
+      }
+
+      .badge-ios {
+        background-color: #000000;
+      }
+
+      .badge-android {
+        background-color: #3DDC84;
+        color: #000;
+      }
+
+      .badge-api {
+        background-color: var(--info-color);
+      }
+
+      .table {
+        color: var(--text-color);
+        background-color: var(--card-bg);
+      }
+
+      .table thead {
+        background-color: var(--sidebar-hover);
+        color: var(--text-color);
+      }
+
+      .table tbody {
+        background-color: var(--card-bg);
+      }
+
+      .table-hover tbody tr {
+        background-color: var(--card-bg);
+      }
+
+      .table-hover tbody tr:hover {
+        background-color: var(--table-hover) !important;
+        cursor: pointer;
+      }
+
+      .table-light {
+        background-color: var(--sidebar-hover) !important;
+        color: var(--text-color) !important;
+      }
+
+      /* Fix table cells in dark mode */
+      .table td, .table th {
+        background-color: var(--card-bg) !important;
+        color: var(--text-color) !important;
+        border-color: var(--border-color) !important;
+      }
+
+      .table thead th {
+        background-color: var(--sidebar-hover) !important;
+      }
+
+      .form-control, .form-select {
+        background-color: var(--card-bg);
+        color: var(--text-color);
+        border-color: var(--border-color);
+      }
+
+      .form-control:focus, .form-select:focus {
+        background-color: var(--card-bg);
+        color: var(--text-color);
+        border-color: var(--primary-color);
+      }
+
+      .modal-content {
+        background-color: var(--card-bg);
+        color: var(--text-color);
+      }
+
+      .modal-header, .modal-footer {
+        border-color: var(--border-color);
+      }
+
+      .btn-close {
+        filter: brightness(0) invert(1);
+      }
+
+      body.dark-mode .btn-close {
+        filter: brightness(0) invert(1);
+      }
+
+      .text-muted {
+        color: #9CA3AF !important;
+      }
+
+      .theme-toggle {
+        cursor: pointer;
+        padding: 0.5rem 1rem;
+        border-radius: 0.5rem;
+        background-color: rgba(255, 255, 255, 0.1);
+        color: white;
+        border: none;
+        transition: background-color 0.2s;
+      }
+
+      .theme-toggle:hover {
+        background-color: rgba(255, 255, 255, 0.2);
+      }
+
+      .error-status-resolved {
+        color: var(--success-color);
+      }
+
+      .error-status-unresolved {
+        color: var(--danger-color);
+      }
+
+      .chart-container {
+        position: relative;
+        height: 300px;
+        margin: 1rem 0;
+      }
+    </style>
+  </head>
+
+  <body>
+    <!-- Top Navbar -->
+    <nav class="navbar navbar-dark">
+      <div class="container-fluid">
+        <a class="navbar-brand fw-bold" href="<%= root_path %>">
+          <i class="bi bi-bug-fill"></i>
+          Error Dashboard
+        </a>
+        <div class="d-flex align-items-center gap-3">
+          <button class="theme-toggle" id="themeToggle" onclick="toggleTheme()">
+            <i class="bi bi-moon-fill" id="themeIcon"></i>
+          </button>
+          <div class="text-white">
+            <small><%= Rails.env.titleize %> Environment</small>
+          </div>
+        </div>
+      </div>
+    </nav>
+
+    <div class="container-fluid">
+      <div class="row">
+        <!-- Sidebar -->
+        <nav class="col-md-2 d-md-block sidebar">
+          <div class="position-sticky pt-3">
+            <ul class="nav flex-column">
+              <li class="nav-item">
+                <%= link_to root_path, class: "nav-link #{request.path == root_path ? 'active' : ''}" do %>
+                  <i class="bi bi-speedometer2"></i> Overview
+                <% end %>
+              </li>
+              <li class="nav-item">
+                <%= link_to errors_path, class: "nav-link #{request.path == errors_path ? 'active' : ''}" do %>
+                  <i class="bi bi-list-ul"></i> All Errors
+                <% end %>
+              </li>
+              <li class="nav-item">
+                <%= link_to analytics_errors_path, class: "nav-link #{request.path == analytics_errors_path ? 'active' : ''}" do %>
+                  <i class="bi bi-graph-up"></i> Analytics
+                <% end %>
+              </li>
+            </ul>
+
+            <hr class="my-3">
+
+            <h6 class="sidebar-heading px-3 mt-4 mb-2 text-muted text-uppercase">
+              <small>Quick Filters</small>
+            </h6>
+            <ul class="nav flex-column">
+              <li class="nav-item">
+                <%= link_to errors_path(unresolved: true), class: "nav-link" do %>
+                  <i class="bi bi-exclamation-circle text-danger"></i> Unresolved
+                <% end %>
+              </li>
+              <li class="nav-item">
+                <%= link_to errors_path(platform: 'iOS'), class: "nav-link" do %>
+                  <i class="bi bi-phone"></i> iOS Errors
+                <% end %>
+              </li>
+              <li class="nav-item">
+                <%= link_to errors_path(platform: 'Android'), class: "nav-link" do %>
+                  <i class="bi bi-phone"></i> Android Errors
+                <% end %>
+              </li>
+              <li class="nav-item">
+                <%= link_to errors_path(environment: 'production'), class: "nav-link" do %>
+                  <i class="bi bi-server"></i> Production
+                <% end %>
+              </li>
+            </ul>
+          </div>
+        </nav>
+
+        <!-- Main content -->
+        <main class="col-md-10 ms-sm-auto px-md-4">
+          <%= yield %>
+        </main>
+      </div>
+    </div>
+
+    <!-- Bootstrap JS -->
+    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
+
+    <!-- Theme Toggle Script -->
+    <script>
+      // Load theme from localStorage on page load
+      document.addEventListener('DOMContentLoaded', function() {
+        const savedTheme = localStorage.getItem('theme') || 'light';
+        if (savedTheme === 'dark') {
+          document.body.classList.add('dark-mode');
+          updateThemeIcon(true);
+        }
+      });
+
+      function toggleTheme() {
+        const body = document.body;
+        const isDark = body.classList.toggle('dark-mode');
+
+        // Save preference
+        localStorage.setItem('theme', isDark ? 'dark' : 'light');
+
+        // Update icon
+        updateThemeIcon(isDark);
+      }
+
+      function updateThemeIcon(isDark) {
+        const icon = document.getElementById('themeIcon');
+        if (isDark) {
+          icon.className = 'bi bi-sun-fill';
+        } else {
+          icon.className = 'bi bi-moon-fill';
+        }
+      }
+    </script>
+  </body>
+</html>