job_harbor 0.1.0

data/app/components/job_harbor/per_page_selector_component.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class PerPageSelectorComponent < ApplicationComponent
+    PAGE_SIZES = [ 10, 25, 50, 100 ].freeze
+
+    def initialize(current_per_page:, current_path:, params: {})
+      @current_per_page = current_per_page.to_i
+      @current_path = current_path
+      @params = params.to_h.symbolize_keys.except(:per_page, :page, :controller, :action)
+    end
+
+    def call
+      content_tag(:div, class: "sqd-per-page-selector") do
+        safe_join([
+          content_tag(:span, "Show", class: "sqd-per-page-label"),
+          content_tag(:select,
+            class: "sqd-per-page-select",
+            data: { action: "change->per-page#change" }
+          ) do
+            safe_join(PAGE_SIZES.map { |size| option_tag(size) })
+          end
+        ])
+      end
+    end
+
+    private
+
+    def option_tag(size)
+      url = build_url(size)
+      selected = size == @current_per_page
+      content_tag(:option, size, value: url, selected: selected)
+    end
+
+    def build_url(per_page)
+      query_params = @params.merge(per_page: per_page)
+      "#{@current_path}?#{query_params.to_query}"
+    end
+  end
+end

data/app/components/job_harbor/queue_card_component.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class QueueCardComponent < ApplicationComponent
+    def initialize(queue:)
+      @queue = queue
+    end
+
+    def call
+      content_tag(:div, class: "sqd-queue-card") do
+        safe_join([
+          header,
+          stats,
+          actions
+        ])
+      end
+    end
+
+    private
+
+    def header
+      content_tag(:div, class: "sqd-queue-header") do
+        safe_join([
+          link_to(@queue.name, queue_path(@queue.name), class: "sqd-queue-name"),
+          render(BadgeComponent.new(status: @queue.paused? ? :paused : :active))
+        ])
+      end
+    end
+
+    def stats
+      content_tag(:div, class: "sqd-queue-stats") do
+        safe_join([
+          stat("Pending", @queue.pending_count),
+          stat("Scheduled", @queue.scheduled_count),
+          stat("In Progress", @queue.in_progress_count)
+        ])
+      end
+    end
+
+    def stat(label, value)
+      content_tag(:div, class: "sqd-queue-stat") do
+        safe_join([
+          content_tag(:span, value, class: "sqd-queue-stat-value"),
+          content_tag(:span, label, class: "sqd-queue-stat-label")
+        ])
+      end
+    end
+
+    def actions
+      content_tag(:div, class: "sqd-actions", style: "margin-top: 1rem;") do
+        if @queue.paused?
+          button_to "Resume", resume_queue_path(@queue.name), method: :delete, class: "sqd-btn sqd-btn-sm sqd-btn-primary"
+        else
+          button_to "Pause", pause_queue_path(@queue.name), method: :post, class: "sqd-btn sqd-btn-sm sqd-btn-secondary"
+        end
+      end
+    end
+  end
+end

data/app/components/job_harbor/refresh_selector_component.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class RefreshSelectorComponent < ApplicationComponent
+    INTERVALS = [
+      { label: "Off", value: 0 },
+      { label: "15s", value: 15 },
+      { label: "30s", value: 30 },
+      { label: "1m", value: 60 },
+      { label: "5m", value: 300 }
+    ].freeze
+
+    def initialize(default_interval: nil)
+      @default_interval = default_interval || sq_config.poll_interval
+    end
+
+    def call
+      content_tag(:div, class: "sqd-refresh-selector") do
+        safe_join([
+          refresh_icon,
+          interval_select
+        ])
+      end
+    end
+
+    private
+
+    def refresh_icon
+      content_tag(:svg, REFRESH_ICON.html_safe,
+        class: "sqd-refresh-icon",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        "stroke-width": "2",
+        "stroke-linecap": "round",
+        "stroke-linejoin": "round"
+      )
+    end
+
+    def interval_select
+      content_tag(:select,
+        class: "sqd-refresh-select",
+        data: { action: "change->refresh-selector#change" },
+        "aria-label": "Auto-refresh interval"
+      ) do
+        safe_join(INTERVALS.map { |interval| option_tag(interval) })
+      end
+    end
+
+    def option_tag(interval)
+      selected = interval[:value] == @default_interval
+      content_tag(:option, interval[:label], value: interval[:value], selected: selected)
+    end
+
+    REFRESH_ICON = '<polyline points="23 4 23 10 17 10"/><polyline points="1 20 1 14 7 14"/><path d="M3.51 9a9 9 0 0 1 14.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0 0 20.49 15"/>'
+  end
+end

data/app/components/job_harbor/stat_card_component.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class StatCardComponent < ApplicationComponent
+    ICONS = {
+      pending: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z"/>',
+      scheduled: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 7V3m8 4V3m-9 8h10M5 21h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"/>',
+      in_progress: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"/>',
+      failed: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>',
+      finished: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z"/>',
+      blocked: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M18.364 18.364A9 9 0 005.636 5.636m12.728 12.728A9 9 0 015.636 5.636m12.728 12.728L5.636 5.636"/>',
+      workers: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M9 3v2m6-2v2M9 19v2m6-2v2M5 9H3m2 6H3m18-6h-2m2 6h-2M7 19h10a2 2 0 002-2V7a2 2 0 00-2-2H7a2 2 0 00-2 2v10a2 2 0 002 2zM9 9h6v6H9V9z"/>',
+      queues: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 6h16M4 10h16M4 14h16M4 18h16"/>',
+      throughput: '<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 7h8m0 0v8m0-8l-8 8-4-4-6 6"/>'
+    }.freeze
+
+    COLORS = {
+      pending: "info",
+      scheduled: "warning",
+      in_progress: "info",
+      failed: "danger",
+      finished: "success",
+      blocked: nil,
+      workers: "success",
+      queues: "info",
+      throughput: "success"
+    }.freeze
+
+    def initialize(label:, value:, type: nil, link: nil)
+      @label = label
+      @value = value
+      @type = type&.to_sym
+      @link = link
+    end
+
+    def call
+      content_tag(:div, class: "sqd-stat-card") do
+        safe_join([
+          header,
+          value_display
+        ])
+      end
+    end
+
+    private
+
+    def header
+      content_tag(:div, class: "sqd-stat-header") do
+        safe_join([
+          content_tag(:span, @label, class: "sqd-stat-label"),
+          icon_svg
+        ])
+      end
+    end
+
+    def value_display
+      color_class = COLORS[@type]
+      classes = [ "sqd-stat-value" ]
+      classes << color_class if color_class
+
+      if @link
+        link_to @value, @link, class: classes.join(" ")
+      else
+        content_tag(:span, @value, class: classes.join(" "))
+      end
+    end
+
+    def icon_svg
+      return "" unless @type
+
+      icon_path = ICONS[@type]
+      return "" unless icon_path
+
+      content_tag(:svg, icon_path.html_safe, class: "sqd-stat-icon", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor")
+    end
+  end
+end

data/app/components/job_harbor/theme_toggle_component.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class ThemeToggleComponent < ApplicationComponent
+    SUN_ICON = '<circle cx="12" cy="12" r="5"/><line x1="12" y1="1" x2="12" y2="3"/><line x1="12" y1="21" x2="12" y2="23"/><line x1="4.22" y1="4.22" x2="5.64" y2="5.64"/><line x1="18.36" y1="18.36" x2="19.78" y2="19.78"/><line x1="1" y1="12" x2="3" y2="12"/><line x1="21" y1="12" x2="23" y2="12"/><line x1="4.22" y1="19.78" x2="5.64" y2="18.36"/><line x1="18.36" y1="5.64" x2="19.78" y2="4.22"/>'
+    MOON_ICON = '<path d="M21 12.79A9 9 0 1 1 11.21 3 7 7 0 0 0 21 12.79z"/>'
+
+    def call
+      content_tag(:button,
+        class: "sqd-theme-toggle",
+        type: "button",
+        aria: { label: "Toggle theme" },
+        data: { action: "click->theme-toggle#toggle" }
+      ) do
+        safe_join([
+          sun_icon,
+          moon_icon
+        ])
+      end
+    end
+
+    private
+
+    def sun_icon
+      content_tag(:svg, SUN_ICON.html_safe,
+        class: "sqd-theme-icon sqd-theme-icon-sun",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        "stroke-width": "2",
+        "stroke-linecap": "round",
+        "stroke-linejoin": "round"
+      )
+    end
+
+    def moon_icon
+      content_tag(:svg, MOON_ICON.html_safe,
+        class: "sqd-theme-icon sqd-theme-icon-moon",
+        viewBox: "0 0 24 24",
+        fill: "none",
+        stroke: "currentColor",
+        "stroke-width": "2",
+        "stroke-linecap": "round",
+        "stroke-linejoin": "round"
+      )
+    end
+  end
+end

data/app/components/job_harbor/worker_card_component.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class WorkerCardComponent < ApplicationComponent
+    STALE_THRESHOLD = 5.minutes
+
+    def initialize(worker:)
+      @worker = worker
+    end
+
+    def call
+      content_tag(:div, class: "sqd-worker-card") do
+        safe_join([
+          header,
+          details,
+          queues_list
+        ])
+      end
+    end
+
+    private
+
+    def header
+      content_tag(:div, class: "sqd-worker-header") do
+        safe_join([
+          content_tag(:span, worker_name, class: "sqd-worker-name"),
+          render(BadgeComponent.new(status: heartbeat_status))
+        ])
+      end
+    end
+
+    def worker_name
+      @worker.name.presence || "Worker ##{@worker.id}"
+    end
+
+    def heartbeat_status
+      if stale?
+        :blocked
+      else
+        :active
+      end
+    end
+
+    def stale?
+      return true unless @worker.last_heartbeat_at
+
+      @worker.last_heartbeat_at < STALE_THRESHOLD.ago
+    end
+
+    def details
+      content_tag(:div, class: "sqd-worker-stats") do
+        safe_join([
+          stat("Hostname", @worker.hostname),
+          stat("PID", @worker.pid),
+          stat("Last Heartbeat", heartbeat_time)
+        ])
+      end
+    end
+
+    def stat(label, value)
+      content_tag(:div, class: "sqd-worker-stat") do
+        safe_join([
+          content_tag(:span, value, class: "sqd-worker-stat-value"),
+          content_tag(:span, label, class: "sqd-worker-stat-label")
+        ])
+      end
+    end
+
+    def heartbeat_time
+      return "Never" unless @worker.last_heartbeat_at
+
+      time_ago_in_words(@worker.last_heartbeat_at) + " ago"
+    end
+
+    def queues_list
+      return "" unless @worker.respond_to?(:queues) && @worker.queues.present?
+
+      content_tag(:div, style: "margin-top: 1rem;") do
+        safe_join([
+          content_tag(:span, "Queues: ", class: "sqd-text-muted"),
+          @worker.queues.map { |q| content_tag(:code, q, class: "sqd-code", style: "margin-right: 0.5rem;") }
+        ].flatten)
+      end
+    end
+  end
+end

data/app/controllers/job_harbor/application_controller.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class ApplicationController < ::ApplicationController
+    protect_from_forgery with: :exception
+
+    before_action :authorize_access
+
+    layout "job_harbor/application"
+
+    helper_method :sq_config, :nav_counts
+
+    private
+
+    def authorize_access
+      return if JobHarbor.configuration.authorize(self)
+
+      redirect_to main_app.root_path, alert: "Admin access required."
+    end
+
+    def sq_config
+      JobHarbor.configuration
+    end
+
+    def set_page_title(title)
+      @page_title = title
+    end
+
+    def nav_counts
+      @nav_counts ||= {
+        workers: SolidQueue::Process.where(kind: "Worker").count,
+        recurring_tasks: recurring_task_count
+      }
+    end
+
+    def recurring_task_count
+      return 0 unless sq_config.enable_recurring_tasks
+
+      SolidQueue::RecurringTask.count
+    rescue
+      0
+    end
+  end
+end

data/app/controllers/job_harbor/dashboard_controller.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class DashboardController < ApplicationController
+    def index
+      @stats = DashboardStats.new
+      @failure_stats = FailureStats.new.stats if sq_config.enable_failure_stats
+
+      if sq_config.enable_charts
+        @chart_range = params[:chart_range] || sq_config.default_chart_range
+        @chart_data = ChartData.new(range: @chart_range).series
+      end
+
+      set_page_title "Dashboard"
+    end
+  end
+end

data/app/controllers/job_harbor/jobs_controller.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class JobsController < ApplicationController
+    before_action :set_job, only: [ :show, :retry, :discard ]
+
+    def index
+      @status = params[:status]
+      @per_page = per_page_param
+      @class_name = params[:class_name]
+      @queue_name = params[:queue_name]
+
+      @pagy, @jobs = JobPresenter.all_with_status(
+        @status,
+        page: params[:page],
+        per_page: @per_page,
+        class_name: @class_name,
+        queue_name: @queue_name
+      )
+      @counts = job_counts
+      @filter_data = filter_data
+      set_page_title @status ? "#{@status.titleize} Jobs" : "All Jobs"
+    end
+
+    def show
+      set_page_title "Job ##{@job.id}"
+    end
+
+    def search
+      query = params[:q].to_s.strip
+      if query.present?
+        @per_page = per_page_param
+        @pagy, @jobs = JobPresenter.search(query, page: params[:page], per_page: @per_page)
+        set_page_title "Search Results"
+      else
+        redirect_to jobs_path
+      end
+    end
+
+    def retry
+      if @job.can_retry?
+        perform_retry(@job)
+        redirect_to job_path(@job), notice: "Job has been queued for retry."
+      else
+        redirect_to job_path(@job), alert: "This job cannot be retried."
+      end
+    end
+
+    def discard
+      if @job.can_discard?
+        perform_discard(@job)
+        redirect_to jobs_path(status: params[:return_status]), notice: "Job has been discarded."
+      else
+        redirect_to job_path(@job), alert: "This job cannot be discarded."
+      end
+    end
+
+    def retry_all
+      status = params[:status]
+      count = retry_all_jobs(status)
+      redirect_to jobs_path(status: status), notice: "#{count} jobs queued for retry."
+    end
+
+    def discard_all
+      status = params[:status]
+      count = discard_all_jobs(status)
+      redirect_to jobs_path(status: status), notice: "#{count} jobs discarded."
+    end
+
+    private
+
+    def set_job
+      @job = JobPresenter.find(params[:id])
+    rescue ActiveRecord::RecordNotFound
+      redirect_to jobs_path, alert: "Job not found."
+    end
+
+    def per_page_param
+      per_page = params[:per_page].to_i
+      valid_sizes = JobHarbor::PerPageSelectorComponent::PAGE_SIZES
+      valid_sizes.include?(per_page) ? per_page : sq_config.jobs_per_page
+    end
+
+    def filter_data
+      {
+        class_names: SolidQueue::Job.distinct.pluck(:class_name).sort,
+        queue_names: SolidQueue::Job.distinct.pluck(:queue_name).sort
+      }
+    end
+
+    def job_counts
+      {
+        all: SolidQueue::Job.count,
+        pending: SolidQueue::ReadyExecution.count,
+        scheduled: SolidQueue::ScheduledExecution.count,
+        in_progress: SolidQueue::ClaimedExecution.count,
+        failed: SolidQueue::FailedExecution.count,
+        blocked: SolidQueue::BlockedExecution.count,
+        finished: SolidQueue::Job.where.not(finished_at: nil).count
+      }
+    end
+
+    def perform_retry(job)
+      failed_execution = SolidQueue::FailedExecution.find_by(job_id: job.id)
+      return unless failed_execution
+
+      failed_execution.retry
+    end
+
+    def perform_discard(job)
+      # Remove from any execution tables
+      SolidQueue::FailedExecution.where(job_id: job.id).delete_all
+      SolidQueue::BlockedExecution.where(job_id: job.id).delete_all
+      SolidQueue::ScheduledExecution.where(job_id: job.id).delete_all
+      SolidQueue::ReadyExecution.where(job_id: job.id).delete_all
+
+      # Mark job as finished (discarded)
+      SolidQueue::Job.where(id: job.id).update_all(finished_at: Time.current)
+    end
+
+    def retry_all_jobs(status)
+      return 0 unless status == "failed"
+
+      count = 0
+      SolidQueue::FailedExecution.find_each do |fe|
+        fe.retry
+        count += 1
+      end
+      count
+    end
+
+    def discard_all_jobs(status)
+      case status
+      when "failed"
+        count = SolidQueue::FailedExecution.count
+        job_ids = SolidQueue::FailedExecution.pluck(:job_id)
+        SolidQueue::FailedExecution.delete_all
+        SolidQueue::Job.where(id: job_ids).update_all(finished_at: Time.current)
+        count
+      when "blocked"
+        count = SolidQueue::BlockedExecution.count
+        job_ids = SolidQueue::BlockedExecution.pluck(:job_id)
+        SolidQueue::BlockedExecution.delete_all
+        SolidQueue::Job.where(id: job_ids).update_all(finished_at: Time.current)
+        count
+      else
+        0
+      end
+    end
+  end
+end

data/app/controllers/job_harbor/queues_controller.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class QueuesController < ApplicationController
+    before_action :set_queue, only: [ :show, :pause, :resume ]
+
+    def index
+      @queues = QueueStats.all
+      set_page_title "Queues"
+    end
+
+    def show
+      @pagy, @jobs = JobPresenter.all_with_status(
+        nil,
+        page: params[:page],
+        per_page: sq_config.jobs_per_page
+      )
+      # Filter to only jobs in this queue
+      @jobs = @jobs.select { |j| j.queue_name == @queue.name }
+      set_page_title "Queue: #{@queue.name}"
+    end
+
+    def pause
+      @queue.pause!
+      redirect_to queues_path, notice: "Queue '#{@queue.name}' has been paused."
+    end
+
+    def resume
+      @queue.resume!
+      redirect_to queues_path, notice: "Queue '#{@queue.name}' has been resumed."
+    end
+
+    private
+
+    def set_queue
+      @queue = QueueStats.find(params[:name])
+      redirect_to queues_path, alert: "Queue not found." unless @queue
+    end
+  end
+end

data/app/controllers/job_harbor/recurring_tasks_controller.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class RecurringTasksController < ApplicationController
+    before_action :set_task, only: [ :show, :enqueue_now ]
+
+    def index
+      @tasks = SolidQueue::RecurringTask.order(:key)
+      set_page_title "Recurring Tasks"
+    end
+
+    def show
+      @recent_executions = SolidQueue::RecurringExecution
+        .where(task_key: @task.key)
+        .order(created_at: :desc)
+        .limit(20)
+      set_page_title "Task: #{@task.key}"
+    end
+
+    def enqueue_now
+      @task.enqueue(at: Time.current)
+      redirect_to recurring_task_path(@task), notice: "Task '#{@task.key}' has been enqueued."
+    rescue => e
+      redirect_to recurring_task_path(@task), alert: "Failed to enqueue task: #{e.message}"
+    end
+
+    private
+
+    def set_task
+      @task = SolidQueue::RecurringTask.find(params[:id])
+    rescue ActiveRecord::RecordNotFound
+      redirect_to recurring_tasks_path, alert: "Recurring task not found."
+    end
+  end
+end

data/app/controllers/job_harbor/workers_controller.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module JobHarbor
+  class WorkersController < ApplicationController
+    def index
+      @workers = SolidQueue::Process.order(last_heartbeat_at: :desc)
+      @active_count = @workers.where("last_heartbeat_at > ?", 5.minutes.ago).count
+      @stale_count = @workers.count - @active_count
+      set_page_title "Workers"
+    end
+  end
+end

data/app/helpers/job_harbor/application_helper.rb

@@ -0,0 +1,4 @@
+module JobHarbor
+  module ApplicationHelper
+  end
+end