admin_suite 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8a3f83815ccce6bcb0e0a38e07e0b90d6d969309b2e3302e1870135f02793762
-  data.tar.gz: 2564e620eaa8c66030d8f774b1d4246eaa4359955ce2a5670f62f069a88a58af
+  metadata.gz: 22d3fb1dd5649136ae88ea54aa4b948790c1e1fd7a81681ffd07707f82d6494a
+  data.tar.gz: 00c3ba3433eb3d9d59289c70d75fe9b0a3f613a043b6dc1d109b7af4a375272e
 SHA512:
-  metadata.gz: '071608f05dc059b788b90350e9cfbd590d417bf124f3327dbf151202d32f2c71359f3c6ba442e13fba7138d8fc7b28d96e52687825bf64beb66c4058dd640eb9'
-  data.tar.gz: ac7a393a423342b228c9489492d361e34f98afaaf9e9527a1a71639ecc3d0ee7ce59ddfae3988d1d83ccac474a69764ce7b7d7afed0e346026642bd9c69bb3f2
+  metadata.gz: b104f41152647c491a4f318beb6d1b2ea7f69619af6c7cb9ee05fef3a32b719aef73f48200e6b0bd5efc4c2ad7fe85637db40dc3023d63a3281cd39882539b7f
+  data.tar.gz: 8d27c97e8790b50d59f769abacdc1a19158158fcb284d31b6e3785fcb8064e3020ef8577e3b1960681038314ea865e1502ba408e7db8359924ea5accc39bb99e

data/app/assets/admin_suite.css

@@ -9,6 +9,7 @@
  */
 
 body.admin-suite {
+  color-scheme: light;
   --admin-suite-bg: #f8fafc; /* slate-50 */
   --admin-suite-fg: #0f172a; /* slate-900 */
   --admin-suite-muted: #475569; /* slate-600 */
@@ -265,6 +266,133 @@ body.admin-suite .admin-suite-sidebar .admin-suite-sidebar-muted {
   color: rgba(255, 255, 255, 0.75);
 }
 
+/* Responsive layout fallbacks (engine-owned)
+   ----------------------------------------
+   Tailwind v4 emits media queries like `@media (width >= 64rem)`, which can fail
+   in some embedded/older browsers. For critical layout, we provide classic
+   `min-width` media queries so the UI remains usable everywhere. */
+
+/* Dashboard row grid (>= 1024px)
+   Used by `render_dashboard_rows` to honor panel `span`. */
+body.admin-suite .admin-suite-dashboard-row {
+  display: grid;
+  grid-template-columns: repeat(1, minmax(0, 1fr));
+  gap: 1.5rem; /* ~ gap-6 */
+}
+
+@media (min-width: 1024px) {
+  body.admin-suite .admin-suite-dashboard-row {
+    grid-template-columns: repeat(12, minmax(0, 1fr));
+  }
+}
+
+/* Cards panel grids (portals/resources) */
+body.admin-suite .admin-suite-cards-grid {
+  display: grid;
+  grid-template-columns: repeat(1, minmax(0, 1fr));
+}
+
+body.admin-suite .admin-suite-cards-grid--portals {
+  gap: 1rem; /* ~ gap-4 */
+}
+
+body.admin-suite .admin-suite-cards-grid--resources {
+  gap: 0.75rem; /* ~ gap-3 */
+}
+
+@media (min-width: 640px) {
+  body.admin-suite .admin-suite-cards-grid--resources {
+    grid-template-columns: repeat(2, minmax(0, 1fr)); /* sm:grid-cols-2 */
+  }
+}
+
+@media (min-width: 768px) {
+  body.admin-suite .admin-suite-cards-grid--portals {
+    grid-template-columns: repeat(2, minmax(0, 1fr)); /* md:grid-cols-2 */
+  }
+}
+
+@media (min-width: 1024px) {
+  body.admin-suite .admin-suite-cards-grid--portals {
+    grid-template-columns: repeat(4, minmax(0, 1fr)); /* lg:grid-cols-4 */
+  }
+
+  body.admin-suite .admin-suite-cards-grid--resources {
+    grid-template-columns: repeat(3, minmax(0, 1fr)); /* lg:grid-cols-3 */
+  }
+}
+
+/* Portal fallback sections grid (>= 1024px) */
+body.admin-suite .admin-suite-portal-sections-grid {
+  display: grid;
+  grid-template-columns: repeat(1, minmax(0, 1fr));
+  gap: 1.5rem; /* ~ gap-6 */
+}
+
+@media (min-width: 1024px) {
+  body.admin-suite .admin-suite-portal-sections-grid {
+    grid-template-columns: repeat(2, minmax(0, 1fr));
+  }
+}
+
+/* Desktop sidebar visibility (>= 1024px) */
+body.admin-suite .admin-suite-desktop-sidebar {
+  display: none;
+  flex-shrink: 0;
+}
+
+/* Prevent flex children from overflowing (required for nested tables). */
+body.admin-suite .admin-suite-main {
+  min-width: 0;
+}
+
+@media (min-width: 1024px) {
+  body.admin-suite .admin-suite-desktop-sidebar {
+    display: flex;
+  }
+
+  /* Ensure the mobile menu button/overlay never show on desktop */
+  body.admin-suite .admin-suite-mobile-menu-button {
+    display: none;
+  }
+
+  body.admin-suite .admin-suite-mobile-overlay,
+  body.admin-suite .admin-suite-mobile-sidebar {
+    display: none !important;
+  }
+}
+
+/* Two-column resource layouts */
+body.admin-suite .admin-suite-two-col {
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem; /* ~ gap-6 */
+}
+
+@media (min-width: 768px) {
+  body.admin-suite .admin-suite-two-col {
+    flex-direction: row;
+  }
+
+  body.admin-suite .admin-suite-two-col__sidebar {
+    flex: 0 0 auto;
+  }
+
+  body.admin-suite .admin-suite-two-col__sidebar--filters {
+    width: 16rem; /* ~ w-64 */
+  }
+
+  body.admin-suite .admin-suite-two-col__sidebar--details {
+    width: 20rem; /* ~ w-80 */
+  }
+}
+
+/* Ensure the engine sidebar has a stable width even without Tailwind. */
+body.admin-suite .admin-suite-sidebar {
+  width: 18rem; /* ~ w-72 */
+  height: 100%;
+}
+
 .form-group { margin-bottom: 1rem; }
 .form-label {
   display: block;

data/app/controllers/admin_suite/application_controller.rb

@@ -72,6 +72,37 @@ module AdminSuite
       retry
     end
 
+    # Loads the root dashboard definition files (safe to call per-request).
+    #
+    # Host apps typically define this in:
+    # - `config/admin_suite/dashboard.rb`
+    # - `app/admin_suite/dashboard.rb`
+    #
+    # @return [void]
+    def ensure_root_dashboard_loaded!
+      if Rails.env.development?
+        globs = Array(AdminSuite.config.dashboard_globs).flat_map { |g| Dir[g] }.uniq
+        # Re-evaluate dashboard layout on each request in development.
+        # Always reset, even when no files match, so removed dashboards are cleared.
+        AdminSuite.reset_root_dashboard!
+        globs.each { |file| load file }
+      else
+        # In non-dev, load once.
+        return if AdminSuite.config.root_dashboard_loaded
+        globs = Array(AdminSuite.config.dashboard_globs).flat_map { |g| Dir[g] }.uniq
+        if globs.empty?
+          # Avoid hitting the filesystem on every request when no dashboard files exist.
+          AdminSuite.config.root_dashboard_loaded = true
+          return
+        end
+        globs.each { |file| require file }
+        AdminSuite.config.root_dashboard_loaded = true
+      end
+    rescue NameError
+      require "admin_suite"
+      retry
+    end
+
     # Builds the navigation structure from registered resources.
     #
     # @return [Hash]

data/app/controllers/admin_suite/dashboard_controller.rb

@@ -3,256 +3,89 @@
 module AdminSuite
   class DashboardController < ApplicationController
     def index
-      # Ensure portal/resource metadata is available.
-      items = navigation_items
+      ensure_root_dashboard_loaded!
 
-      @health = build_root_health
-      @stats = build_root_stats(items)
-      @recent = build_root_recent
+      items = navigation_items
+      @portal_cards = build_portal_cards(items)
 
-      @portal_cards =
-        items.sort_by { |(_k, v)| (v[:order] || 100).to_i }.map do |portal_key, portal|
-          color = portal[:color].presence || default_portal_color(portal_key)
-          {
-            key: portal_key,
-            label: portal[:label] || portal_key.to_s.humanize,
-            description: portal[:description],
-            color: color,
-            icon: portal[:icon],
-            path: portal_path(portal: portal_key),
-            count: portal[:sections].values.sum { |s| s[:items].size }
-          }
-        end
+      @page_title = eval_setting(AdminSuite.config.root_dashboard_title, default: "Admin Suite")
+      @page_description =
+        eval_setting(
+          AdminSuite.config.root_dashboard_description,
+          default: "Admin framework for managing application resources across one or more portals."
+        )
 
-      @dashboard_sections = build_sections
+      @dashboard_rows = resolve_root_dashboard_rows(items)
     end
 
     private
 
-    def default_portal_color(portal_key)
-      case portal_key.to_sym
-      when :ops then "amber"
-      when :email then "emerald"
-      when :ai then "cyan"
-      when :assistant then "violet"
-      when :payments then "emerald"
-      else "slate"
-      end
-    end
-
-    def build_sections
-      sections = []
-
-      sections << {
-        title: "System Health",
-        subtitle: nil,
-        rows: [
-          AdminSuite::UI::RowDefinition.new(panels: [
-            AdminSuite::UI::PanelDefinition.new(type: :health, title: "Application", options: { span: 3, status: @health.dig(:app, :status), metrics: @health.dig(:app, :metrics) }),
-            AdminSuite::UI::PanelDefinition.new(type: :health, title: "Scraping Pipeline", options: { span: 3, status: @health.dig(:scraping, :status), metrics: @health.dig(:scraping, :metrics) }),
-            AdminSuite::UI::PanelDefinition.new(type: :health, title: "LLM API", options: { span: 3, status: @health.dig(:llm, :status), metrics: @health.dig(:llm, :metrics) }),
-            AdminSuite::UI::PanelDefinition.new(type: :health, title: "Assistant", options: { span: 3, status: @health.dig(:assistant, :status), metrics: @health.dig(:assistant, :metrics) })
-          ])
-        ]
-      }
-
-      sections << {
-        title: nil,
-        subtitle: nil,
-        rows: [
-          AdminSuite::UI::RowDefinition.new(panels: [
-            AdminSuite::UI::PanelDefinition.new(
-              type: :cards,
-              title: "Portals",
-              options: { span: 12, variant: :portals, resources: @portal_cards }
-            )
-          ])
-        ]
-      }
-
-      sections << {
-        title: nil,
-        subtitle: nil,
-        rows: [
-          AdminSuite::UI::RowDefinition.new(panels: [
-            AdminSuite::UI::PanelDefinition.new(type: :stat, title: "Total Resources", options: { span: 3, variant: :mini, color: :slate, value: @stats[:total_resources] }),
-            AdminSuite::UI::PanelDefinition.new(type: :stat, title: "Ops Resources", options: { span: 3, variant: :mini, color: :amber, value: @stats[:ops_resources] }),
-            AdminSuite::UI::PanelDefinition.new(type: :stat, title: "Email Resources", options: { span: 2, variant: :mini, color: :emerald, value: @stats[:email_resources] }),
-            AdminSuite::UI::PanelDefinition.new(type: :stat, title: "AI Resources", options: { span: 2, variant: :mini, color: :cyan, value: @stats[:ai_resources] }),
-            AdminSuite::UI::PanelDefinition.new(type: :stat, title: "Assistant Resources", options: { span: 2, variant: :mini, color: :violet, value: @stats[:assistant_resources] })
-          ])
-        ]
-      }
-
-      sections << {
-        title: "Recent Activity",
-        subtitle: nil,
-        rows: [
-          AdminSuite::UI::RowDefinition.new(panels: [
-            AdminSuite::UI::PanelDefinition.new(type: :recent, title: "Recent Signups", options: { span: 3, scope: @recent[:recent_users], view_all_path: ->(view) { view.resources_path(portal: :ops, resource_name: "users") } }),
-            AdminSuite::UI::PanelDefinition.new(type: :recent, title: "Recent Applications", options: { span: 3, scope: @recent[:recent_applications], view_all_path: ->(view) { view.resources_path(portal: :ops, resource_name: "interview_applications") } }),
-            AdminSuite::UI::PanelDefinition.new(type: :recent, title: "Recent Assistant", options: { span: 3, scope: @recent[:recent_threads], view_all_path: ->(view) { view.resources_path(portal: :assistant, resource_name: "assistant_threads") } }),
-            AdminSuite::UI::PanelDefinition.new(type: :recent, title: "Recent Scraping", options: { span: 3, scope: @recent[:recent_scraping], view_all_path: ->(view) { view.resources_path(portal: :ops, resource_name: "scraping_attempts") } })
-          ])
-        ]
-      }
-
-      sections
-    end
-
-    def build_root_stats(items)
-      {
-        total_resources: Admin::Base::Resource.registered_resources.count,
-        portals: items.keys.count,
-        ops_resources: Admin::Base::Resource.resources_for_portal(:ops).count,
-        email_resources: Admin::Base::Resource.resources_for_portal(:email).count,
-        ai_resources: Admin::Base::Resource.resources_for_portal(:ai).count,
-        assistant_resources: Admin::Base::Resource.resources_for_portal(:assistant).count
-      }
+    def eval_setting(value, default:)
+      evaluated = value.respond_to?(:call) ? value.call(self) : value
+      evaluated.to_s.presence || default
     rescue StandardError
-      { total_resources: 0, portals: 0, ops_resources: 0, email_resources: 0, ai_resources: 0, assistant_resources: 0 }
+      default
     end
 
-    def build_root_recent
-      {
-        recent_users: -> { defined?(::User) ? ::User.order(created_at: :desc).limit(5) : [] },
-        recent_applications: -> { defined?(::InterviewApplication) ? ::InterviewApplication.order(created_at: :desc).limit(5) : [] },
-        recent_threads: -> { defined?(::Assistant::ChatThread) ? ::Assistant::ChatThread.order(created_at: :desc).limit(5) : [] },
-        recent_scraping: -> { defined?(::ScrapingAttempt) ? ::ScrapingAttempt.order(created_at: :desc).limit(5) : [] }
-      }
-    end
-
-    def build_root_health
-      {
-        app: app_health,
-        scraping: scraping_health,
-        llm: llm_health,
-        assistant: assistant_health
-      }
+    def build_portal_cards(items)
+      items.sort_by { |(_k, v)| (v[:order] || 100).to_i }.map do |portal_key, portal|
+        color = portal[:color].presence || default_portal_color(portal_key)
+        {
+          key: portal_key,
+          label: portal[:label] || portal_key.to_s.humanize,
+          description: portal[:description],
+          color: color,
+          icon: portal[:icon],
+          path: portal_path(portal: portal_key),
+          count: (portal[:sections] || {}).values.sum { |s| Array(s[:items]).size }
+        }
+      end
     end
 
-    def app_health
-      return { status: :unknown, metrics: {} } unless defined?(::User)
-
-      metrics = {
-        "Users" => safe_count(::User),
-        "24h signups" => safe_count(::User, ->(rel) { rel.where("created_at > ?", 24.hours.ago) }),
-        "Applications" => (defined?(::InterviewApplication) ? safe_count(::InterviewApplication) : "—"),
-        "Job listings" => (defined?(::JobListing) ? safe_count(::JobListing) : "—")
-      }
+    def resolve_root_dashboard_rows(items)
+      definition = AdminSuite.root_dashboard_definition
+      configured_rows = definition&.rows
+      return configured_rows unless configured_rows.nil?
 
-      { status: :healthy, metrics: metrics }
-    rescue StandardError
-      { status: :unknown, metrics: {} }
+      build_default_root_dashboard_rows(items)
     end
 
-    def scraping_health
-      return { status: :unknown, metrics: {} } unless defined?(::ScrapingAttempt)
+    def build_default_root_dashboard_rows(items)
+      portal_cards = @portal_cards
+      total_portals = items.keys.count
+      total_resources = safe_resource_count
 
-      recent_attempts = ::ScrapingAttempt.where("created_at > ?", 24.hours.ago)
-      total = recent_attempts.count
-      successful = recent_attempts.where(status: :completed).count
-      failed = recent_attempts.where(status: :failed).count
-      stuck = recent_attempts.where(status: :processing).where("updated_at < ?", 1.hour.ago).count
+      definition = AdminSuite::UI::DashboardDefinition.new
+      dsl = AdminSuite::UI::DashboardDSL.new(definition)
 
-      success_rate = total > 0 ? (successful.to_f / total * 100).round : 0
-      status =
-        if stuck > 5 || (total > 10 && success_rate < 50)
-          :critical
-        elsif stuck > 0 || (total > 10 && success_rate < 80)
-          :degraded
-        else
-          :healthy
-        end
-
-      {
-        status: status,
-        metrics: {
-          "24h attempts" => total,
-          "success rate" => "#{success_rate}%",
-          "failed" => failed,
-          "stuck" => stuck
-        }
-      }
-    rescue StandardError
-      { status: :unknown, metrics: {} }
-    end
-
-    def llm_health
-      return { status: :unknown, metrics: {} } unless defined?(::Ai::LlmApiLog)
-
-      recent_logs = ::Ai::LlmApiLog.where("created_at > ?", 24.hours.ago)
-      total = recent_logs.count
-      successful = recent_logs.where(status: :success).count
-      failed = recent_logs.where(status: :failed).count
-      avg_latency = recent_logs.where(status: :success).average(:latency_ms)&.round || 0
-      total_cost_cents = recent_logs.sum(:estimated_cost_cents) || 0
-      total_cost = (total_cost_cents / 100.0).round(2)
+      dsl.row do
+        cards_panel "Portals", span: 12, variant: :portals, resources: portal_cards
+      end
 
-      success_rate = total > 0 ? (successful.to_f / total * 100).round : 0
-      status =
-        if total > 10 && success_rate < 80
-          :critical
-        elsif total > 10 && success_rate < 95
-          :degraded
-        else
-          :healthy
-        end
+      dsl.row do
+        stat_panel "Portals", total_portals, span: 6, variant: :mini, color: :slate
+        stat_panel "Resources", total_resources, span: 6, variant: :mini, color: :slate
+      end
 
-      {
-        status: status,
-        metrics: {
-          "24h calls" => total,
-          "success rate" => "#{success_rate}%",
-          "avg latency" => "#{avg_latency}ms",
-          "24h cost" => "$#{total_cost}",
-          "failed" => failed
-        }
-      }
-    rescue StandardError
-      { status: :unknown, metrics: {} }
+      definition.rows
     end
 
-    def assistant_health
-      return { status: :unknown, metrics: {} } unless defined?(::Assistant::ToolExecution)
-
-      recent_threads = (defined?(::Assistant::ChatThread) ? ::Assistant::ChatThread.where("created_at > ?", 24.hours.ago) : nil)
-      recent_executions = ::Assistant::ToolExecution.where("created_at > ?", 24.hours.ago)
-
-      total_executions = recent_executions.count
-      successful = recent_executions.where(status: :completed).count
-      failed = recent_executions.where(status: :failed).count
-      pending = ::Assistant::ToolExecution.where(status: :pending_approval).count
-
-      success_rate = total_executions > 0 ? (successful.to_f / total_executions * 100).round : 100
-      status =
-        if failed > 10
-          :critical
-        elsif pending > 20 || (total_executions > 10 && success_rate < 70)
-          :degraded
-        else
-          :healthy
-        end
-
-      {
-        status: status,
-        metrics: {
-          "24h threads" => (recent_threads ? recent_threads.count : "—"),
-          "24h tool runs" => total_executions,
-          "success rate" => "#{success_rate}%",
-          "pending" => pending
-        }
-      }
-    rescue StandardError
-      { status: :unknown, metrics: {} }
+    def default_portal_color(portal_key)
+      case portal_key.to_sym
+      when :ops then "amber"
+      when :email then "emerald"
+      when :ai then "cyan"
+      when :assistant then "violet"
+      else "slate"
+      end
     end
 
-    def safe_count(klass, scope_proc = nil)
-      rel = klass.all
-      rel = scope_proc.call(rel) if scope_proc
-      rel.count
+    def safe_resource_count
+      return 0 unless defined?(Admin::Base::Resource)
+
+      Admin::Base::Resource.registered_resources.count
     rescue StandardError
-      "—"
+      0
     end
   end
 end