tramway 4.0.1.4 → 4.1

data/app/models/tramway/solid_queue/jobs_filter.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Tramway
+  module SolidQueue
+    # Shared status/queue/class/search filtering for SolidQueue jobs, used by both the
+    # jobs controller (for the index page) and the background jobs that process a
+    # filtered set of jobs (e.g. "Destroy all"), since a job's `perform` only receives
+    # plain serializable arguments, not a live `ActionController::Parameters`.
+    class JobsFilter
+      STATUS_FILTERS = {
+        'ready' => ->(relation) { relation.joins(:ready_execution) },
+        'claimed' => ->(relation) { relation.joins(:claimed_execution) },
+        'scheduled' => ->(relation) { relation.joins(:scheduled_execution) },
+        'blocked' => ->(relation) { relation.joins(:blocked_execution) },
+        'failed' => ->(relation) { relation.joins(:failed_execution) },
+        'finished' => ->(relation) { relation.finished }
+      }.freeze
+
+      def initialize(filters = {})
+        @filters = filters.to_h.stringify_keys
+      end
+
+      def jobs
+        relation = apply_status_filter(::SolidQueue::Job.all)
+        relation = relation.where(queue_name: filters['queue_name']) if filters['queue_name'].present?
+        relation = relation.where(class_name: filters['class_name']) if filters['class_name'].present?
+
+        apply_search(relation).distinct
+      end
+
+      def status_counts
+        STATUS_FILTERS.transform_values { |scope| scope.call(::SolidQueue::Job.all).count }
+      end
+
+      private
+
+      attr_reader :filters
+
+      def apply_status_filter(relation)
+        STATUS_FILTERS.fetch(filters['status']) { ->(rel) { rel } }.call(relation)
+      end
+
+      def apply_search(relation)
+        query = filters['query'].to_s.strip
+
+        return relation if query.blank?
+        return relation.where(id: query) if query.match?(/\A\d+\z/)
+
+        relation.where('class_name LIKE :query OR active_job_id LIKE :query', query: "%#{query}%")
+      end
+    end
+  end
+end

data/app/views/tramway/entities/_filters.html.haml

@@ -0,0 +1,15 @@
+- current_filter = params[:filter]
+
+.overflow-hidden.duration-200.ease-out-strong.motion-reduce:duration-0{ class: 'transition-[height,opacity]', data: { 'tramway--collapsible-target': 'panel' } }
+  .flex.flex-wrap.gap-2.mt-2
+    - @filter_counts.each do |filter_name, count|
+      - filter_params = request.query_parameters.except('page').merge(filter: filter_name)
+      - button_type = filter_name.to_s == current_filter ? :primary : :inverse
+      = tramway_button text: "#{filter_name.to_s.upcase} · #{count}",
+        path: public_send(custom_path_method, filter_params), type: button_type, size: :small
+
+    - if current_filter.present?
+      - clear_params = request.query_parameters.except('page', 'filter')
+      = tramway_button tag: :a, path: public_send(custom_path_method, clear_params), type: :inverse,
+        size: :small, tooltip: { text: t('tramway.actions.clear_filter'), event: :hover } do
+        %i.fa.fa-times{ 'aria-hidden' => 'true' }

data/app/views/tramway/entities/_list.html.haml

@@ -20,14 +20,28 @@
     .mt-4
       = decorator.constantize.index_header_content.call(@entities)
 
-  .flex.flex-row.justify-end.mt-2.gap-4
-    - if @entity.page(:index).search
-      = form_with url: public_send(custom_path_method), method: :get, local: true, builder: Tramway::Form::Builder, horizontal: true do |f|
-        = f.text_field :query, label: false, value: params[:query], placeholder: t('tramway.actions.search')
-        = f.submit nil, 'aria-label' => t('tramway.actions.search') do
-          %i.fa.fa-search{ 'aria-hidden' => 'true' }
-
-    = paginate @entities, custom_path_method:
+  - filters_key = "#{@entity.namespace}-#{@entity.name}-index-filters" if @filter_counts.present?
+
+  %div{ data: (@filter_counts.present? ? { controller: 'tramway--collapsible', key: filters_key } : {}) }
+    .flex.flex-row.items-center.mt-2.gap-4{ class: (@filter_counts.present? ? 'justify-between' : 'justify-end') }
+      - if @filter_counts.present?
+        = tramway_button tag: :button, type: :inverse,
+          data: { action: 'tramway--collapsible#toggle', 'tramway--collapsible-target': 'toggle' } do
+          %i.fa.fa-filter.mr-1{ 'aria-hidden' => 'true' }
+          = t('tramway.actions.filters')
+          %i.fa.fa-chevron-down.ml-1.transition-transform.duration-200.ease-out-strong.motion-reduce:duration-0{ 'aria-hidden' => 'true', data: { 'tramway--collapsible-target': 'icon' } }
+
+      .flex.flex-row.items-center.gap-4
+        - if @entity.page(:index).search
+          = form_with url: public_send(custom_path_method), method: :get, local: true, builder: Tramway::Form::Builder, horizontal: true do |f|
+            = f.text_field :query, label: false, value: params[:query], placeholder: t('tramway.actions.search')
+            = f.submit nil, 'aria-label' => t('tramway.actions.search') do
+              %i.fa.fa-search{ 'aria-hidden' => 'true' }
+
+        = paginate @entities, custom_path_method:
+
+    - if @filter_counts.present?
+      = render 'tramway/entities/filters', custom_path_method:
 
   - if index_attributes.empty?
     %p.text-center.mt-10

data/app/views/tramway/plugins/solid_queue/_subnav.html.haml

@@ -0,0 +1,7 @@
+.flex.gap-2.mt-2
+  = tramway_button tag: :a, text: t('tramway.plugins.solid_queue.jobs.title'), path: jobs_path,
+    type: (current_page?(jobs_path) ? :primary : :inverse), size: :small
+  = tramway_button tag: :a, text: t('tramway.plugins.solid_queue.queues.title'), path: queues_path,
+    type: (current_page?(queues_path) ? :primary : :inverse), size: :small
+  = tramway_button tag: :a, text: t('tramway.plugins.solid_queue.recurring_tasks.title'), path: recurring_tasks_path,
+    type: (current_page?(recurring_tasks_path) ? :primary : :inverse), size: :small

data/app/views/tramway/plugins/solid_queue/jobs/index.html.haml

@@ -0,0 +1,89 @@
+- content_for :title, t('tramway.plugins.solid_queue.jobs.title', default: 'Background Jobs')
+
+= tramway_container do
+  .flex.justify-between.items-center
+    = tramway_title do
+      = content_for :title
+
+  = render 'tramway/plugins/solid_queue/subnav'
+
+  %div{ data: { controller: 'tramway--auto-refresh' } }
+    #tramway-solid-queue-jobs-status-filters.flex.flex-wrap.gap-2.mt-2{ data: { 'tramway--auto-refresh-target': 'refreshable' } }
+      - @status_counts.each do |status, count|
+        - status_params = request.query_parameters.except('page').merge(status:)
+        - button_type = status == params[:status] ? :primary : :inverse
+        = tramway_button text: "#{solid_queue_status_label(status)} · #{count}",
+          path: jobs_path(status_params), type: button_type, size: :small
+
+      - if params[:status].present?
+        - clear_params = request.query_parameters.except('page', 'status')
+        = tramway_button tag: :a, path: jobs_path(clear_params), type: :inverse,
+          size: :small, tooltip: { text: t('tramway.actions.clear_filter'), event: :hover } do
+          %i.fa.fa-times{ 'aria-hidden' => 'true' }
+
+    - all_queues_option = [t('tramway.plugins.solid_queue.jobs.all_queues', default: 'All queues'), '']
+    - queue_name_options = [all_queues_option] + @queue_names.map { |name| [name, name] }
+    - all_classes_option = [t('tramway.plugins.solid_queue.jobs.all_classes', default: 'All classes'), '']
+    - class_name_options = [all_classes_option] + @class_names.map { |name| [name, name] }
+
+    = form_with url: jobs_path, method: :get, local: true, builder: Tramway::Form::Builder, horizontal: true do |f|
+      .flex.flex-wrap.items-center.gap-4.mt-2
+        = f.select :queue_name, queue_name_options, label: false, selected: params[:queue_name].to_s
+        = f.select :class_name, class_name_options, label: false, selected: params[:class_name].to_s
+        = f.text_field :query, label: false, value: params[:query], placeholder: t('tramway.actions.search')
+        = f.submit nil, 'aria-label' => t('tramway.actions.search') do
+          %i.fa.fa-search{ 'aria-hidden' => 'true' }
+
+    .flex.justify-between.gap-2.mt-4
+      = tramway_button text: t('tramway.actions.destroy_all'), path: destroy_all_jobs_path(request.query_parameters.except('page')),
+        method: :post, type: :rage, size: :small
+
+      = form_with url: bulk_destroy_jobs_path, method: :post, id: 'tramway-solid-queue-bulk-jobs-form', local: true do
+        .flex.gap-2
+          = tramway_button text: t('tramway.actions.retry'), tag: :button, type: :will, size: :small,
+            formaction: bulk_retry_jobs_path
+          = tramway_button text: t('tramway.actions.discard'), tag: :button, type: :warning, size: :small,
+            formaction: bulk_discard_jobs_path
+          = tramway_button text: t('tramway.actions.destroy'), tag: :button, type: :rage, size: :small,
+            formaction: bulk_destroy_jobs_path
+
+    #tramway-solid-queue-jobs-table{ data: { 'tramway--auto-refresh-target': 'refreshable' } }
+      = tramway_table class: 'mt-4' do
+        = tramway_header headers: ['', 'ID', t('tramway.plugins.solid_queue.jobs.class_name', default: 'Class'),
+          t('tramway.plugins.solid_queue.jobs.queue_name', default: 'Queue'),
+          t('tramway.plugins.solid_queue.jobs.status', default: 'Status'),
+          t('tramway.plugins.solid_queue.jobs.scheduled_at', default: 'Scheduled at'),
+          t('tramway.table.actions_header')]
+        - @jobs.each do |job|
+          = tramway_row do
+            = tramway_cell do
+              = check_box_tag 'job_ids[]', job.id, false, id: "tramway-solid-queue-job-#{job.id}",
+                form: 'tramway-solid-queue-bulk-jobs-form'
+            = tramway_cell do
+              = job.id
+            = tramway_cell do
+              = job.class_name
+            = tramway_cell do
+              = job.queue_name
+            = tramway_cell do
+              = tramway_badge text: solid_queue_status_label(job.status),
+                type: solid_queue_status_badge_type(job.status)
+            = tramway_cell do
+              = job.scheduled_at
+            = tramway_cell do
+              .flex.gap-2
+                = tramway_button tag: :a, path: job_path(job.id), type: :inverse, size: :small do
+                  %i.fa.fa-eye{ 'aria-hidden' => 'true' }
+                - if job.status == :failed
+                  = tramway_button path: retry_job_path(job.id), method: :post, type: :will, size: :small do
+                    %i.fa.fa-redo{ 'aria-hidden' => 'true' }
+                - if job.status != :finished
+                  = tramway_button path: discard_job_path(job.id), method: :post, type: :warning, size: :small do
+                    %i.fa.fa-ban{ 'aria-hidden' => 'true' }
+                = tramway_button path: job_path(job.id), method: :delete, type: :rage, size: :small do
+                  %i.fa.fa-trash{ 'aria-hidden' => 'true' }
+
+      .flex.flex-col.items-center.mt-4.gap-2
+        = paginate @jobs
+        %p.sm:hidden.text-xs.text-zinc-500
+          = page_entries_info @jobs

data/app/views/tramway/plugins/solid_queue/jobs/show.html.haml

@@ -0,0 +1,90 @@
+= tramway_container do
+  .flex.justify-between.items-center
+    = tramway_title do
+      = "#{@job.class_name} ##{@job.id}"
+
+  #tramway-solid-queue-job-details{ data: { controller: 'tramway--auto-refresh',
+    'tramway--auto-refresh-target': 'refreshable' } }
+    = component 'tramway/actions_buttons_container' do
+      = tramway_button tag: :a, text: t('tramway.actions.cancel'), path: jobs_path, type: :inverse
+
+      - if @job.status == :failed
+        = tramway_button text: t('tramway.actions.retry'), path: retry_job_path(@job.id), method: :post,
+          type: :will
+
+      - if @job.status != :finished
+        = tramway_button text: t('tramway.actions.discard'), path: discard_job_path(@job.id), method: :post,
+          type: :warning
+
+      = tramway_button text: t('tramway.actions.destroy'), path: job_path(@job.id), method: :delete, type: :rage
+
+    = tramway_table class: 'mt-4' do
+      = tramway_row do
+        = tramway_cell do
+          = t('tramway.plugins.solid_queue.jobs.status', default: 'Status')
+        = tramway_cell do
+          = tramway_badge text: solid_queue_status_label(@job.status),
+            type: solid_queue_status_badge_type(@job.status)
+
+      = tramway_row do
+        = tramway_cell do
+          = t('tramway.plugins.solid_queue.jobs.queue_name', default: 'Queue')
+        = tramway_cell do
+          = @job.queue_name
+
+      = tramway_row do
+        = tramway_cell do
+          = t('tramway.plugins.solid_queue.jobs.active_job_id', default: 'Active Job ID')
+        = tramway_cell do
+          = @job.active_job_id
+
+      = tramway_row do
+        = tramway_cell do
+          = t('tramway.plugins.solid_queue.jobs.priority', default: 'Priority')
+        = tramway_cell do
+          = @job.priority
+
+      = tramway_row do
+        = tramway_cell do
+          = t('tramway.plugins.solid_queue.jobs.concurrency_key', default: 'Concurrency key')
+        = tramway_cell do
+          = @job.concurrency_key
+
+      = tramway_row do
+        = tramway_cell do
+          = t('tramway.plugins.solid_queue.jobs.scheduled_at', default: 'Scheduled at')
+        = tramway_cell do
+          = @job.scheduled_at
+
+      = tramway_row do
+        = tramway_cell do
+          = t('tramway.plugins.solid_queue.jobs.finished_at', default: 'Finished at')
+        = tramway_cell do
+          = @job.finished_at
+
+      = tramway_row do
+        = tramway_cell do
+          = t('tramway.plugins.solid_queue.jobs.arguments', default: 'Arguments')
+        = tramway_cell do
+          = @job.arguments.inspect
+
+    - if @job.status == :failed
+      .mt-8
+        %h3.text-2xl.font-bold.text-white
+          = t('tramway.plugins.solid_queue.jobs.error', default: 'Error')
+
+        = tramway_table class: 'mt-4' do
+          = tramway_row do
+            = tramway_cell do
+              = t('tramway.plugins.solid_queue.jobs.exception_class', default: 'Exception class')
+            = tramway_cell do
+              = @job.failed_execution.exception_class
+
+          = tramway_row do
+            = tramway_cell do
+              = t('tramway.plugins.solid_queue.jobs.message', default: 'Message')
+            = tramway_cell do
+              = @job.failed_execution.message
+
+        %pre.mt-4.overflow-x-auto.text-sm.text-zinc-400
+          = Array(@job.failed_execution.backtrace).join("\n")

data/app/views/tramway/plugins/solid_queue/queues/index.html.haml

@@ -0,0 +1,46 @@
+- content_for :title, t('tramway.plugins.solid_queue.queues.title', default: 'Queues')
+
+= tramway_container do
+  .flex.justify-between.items-center
+    = tramway_title do
+      = content_for :title
+
+  = render 'tramway/plugins/solid_queue/subnav'
+
+  %div#tramway-solid-queue-queues-table{ data: { controller: 'tramway--auto-refresh',
+    'tramway--auto-refresh-target': 'refreshable' } }
+    = tramway_table class: 'mt-4' do
+      = tramway_header headers: [t('tramway.plugins.solid_queue.queues.name', default: 'Name'),
+        t('tramway.plugins.solid_queue.queues.size', default: 'Size'),
+        t('tramway.plugins.solid_queue.queues.running', default: 'Running'),
+        t('tramway.plugins.solid_queue.queues.latency', default: 'Latency'),
+        t('tramway.plugins.solid_queue.queues.throughput', default: 'Throughput'),
+        t('tramway.plugins.solid_queue.queues.status', default: 'Status'),
+        t('tramway.table.actions_header')]
+      - @queues.each do |queue|
+        = tramway_row do
+          = tramway_cell do
+            = queue.name
+          = tramway_cell do
+            = queue.size
+          = tramway_cell do
+            = solid_queue_running_count(queue)
+          = tramway_cell do
+            = queue.human_latency
+          = tramway_cell do
+            = solid_queue_throughput_label(queue)
+          = tramway_cell do
+            - if queue.paused?
+              = tramway_badge text: t('tramway.plugins.solid_queue.queues.paused', default: 'Paused'), type: :warning
+            - else
+              = tramway_badge text: t('tramway.plugins.solid_queue.queues.active', default: 'Active'), type: :will
+          = tramway_cell do
+            .flex.gap-2
+              - if queue.paused?
+                = tramway_button text: t('tramway.actions.resume'), path: resume_queue_path(queue.name),
+                  method: :post, type: :will, size: :small
+              - else
+                = tramway_button text: t('tramway.actions.pause'), path: pause_queue_path(queue.name),
+                  method: :post, type: :warning, size: :small
+              = tramway_button text: t('tramway.actions.clear'), path: clear_queue_path(queue.name),
+                method: :post, type: :rage, size: :small

data/app/views/tramway/plugins/solid_queue/recurring_tasks/index.html.haml

@@ -0,0 +1,33 @@
+- content_for :title, t('tramway.plugins.solid_queue.recurring_tasks.title', default: 'Recurring Tasks')
+
+= tramway_container do
+  .flex.justify-between.items-center
+    = tramway_title do
+      = content_for :title
+
+  = render 'tramway/plugins/solid_queue/subnav'
+
+  %div#tramway-solid-queue-recurring-tasks-table{ data: { controller: 'tramway--auto-refresh',
+    'tramway--auto-refresh-target': 'refreshable' } }
+    = tramway_table class: 'mt-4' do
+      = tramway_header headers: [t('tramway.plugins.solid_queue.recurring_tasks.key', default: 'Key'),
+        t('tramway.plugins.solid_queue.recurring_tasks.schedule', default: 'Schedule'),
+        t('tramway.plugins.solid_queue.recurring_tasks.class_name', default: 'Class'),
+        t('tramway.plugins.solid_queue.recurring_tasks.queue_name', default: 'Queue'),
+        t('tramway.plugins.solid_queue.recurring_tasks.next_time', default: 'Next run'),
+        t('tramway.table.actions_header')]
+      - @recurring_tasks.each do |task|
+        = tramway_row do
+          = tramway_cell do
+            = task.key
+          = tramway_cell do
+            = task.schedule
+          = tramway_cell do
+            = task.class_name
+          = tramway_cell do
+            = task.queue_name
+          = tramway_cell do
+            = task.next_time
+          = tramway_cell do
+            = tramway_button text: t('tramway.actions.enqueue_now'), path: enqueue_recurring_task_path(task.key),
+              method: :post, type: :will, size: :small

data/config/locales/en.yml

@@ -11,9 +11,18 @@ en:
       new: "New"
       edit: "Edit"
       destroy: "Destroy"
+      destroy_all: "Destroy all"
       save: "Save"
       cancel: "Cancel"
       search: "Search"
+      filters: "Filters"
+      clear_filter: "Clear filter"
+      retry: "Retry"
+      discard: "Discard"
+      pause: "Pause"
+      resume: "Resume"
+      clear: "Clear"
+      enqueue_now: "Run now"
     notices:
       created: "The record is created"
       updated: "The record is updated"
@@ -22,3 +31,58 @@ en:
       placeholders:
         waiting: "Waiting for an answer..."
         type: "Type your message..."
+    plugins:
+      solid_queue:
+        statuses:
+          ready: "Ready"
+          claimed: "Claimed"
+          scheduled: "Scheduled"
+          blocked: "Blocked"
+          failed: "Failed"
+          finished: "Finished"
+        notices:
+          destroyed: "The job is destroyed"
+          retried: "The job is scheduled to retry"
+          discarded: "The job is discarded"
+          paused: "The queue is paused"
+          resumed: "The queue is resumed"
+          cleared: "The queue is cleared"
+          enqueued: "The recurring task is enqueued"
+          bulk_retry_enqueued: "Retrying the selected jobs in the background"
+          bulk_discard_enqueued: "Discarding the selected jobs in the background"
+          bulk_destroy_enqueued: "Destroying the selected jobs in the background"
+          destroy_all_enqueued: "Destroying all matching jobs in the background"
+        jobs:
+          title: "Background Jobs"
+          class_name: "Class"
+          queue_name: "Queue"
+          status: "Status"
+          scheduled_at: "Scheduled at"
+          finished_at: "Finished at"
+          active_job_id: "Active Job ID"
+          priority: "Priority"
+          concurrency_key: "Concurrency key"
+          arguments: "Arguments"
+          error: "Error"
+          exception_class: "Exception class"
+          message: "Message"
+          all_queues: "All queues"
+          all_classes: "All classes"
+        queues:
+          title: "Queues"
+          name: "Name"
+          size: "Size"
+          running: "Running"
+          latency: "Latency"
+          throughput: "Throughput"
+          throughput_value: "%<rate>s/min"
+          status: "Status"
+          paused: "Paused"
+          active: "Active"
+        recurring_tasks:
+          title: "Recurring Tasks"
+          key: "Key"
+          schedule: "Schedule"
+          class_name: "Class"
+          queue_name: "Queue"
+          next_time: "Next run"

data/config/routes.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require 'tramway/helpers/routes_helper'
+require 'tramway/plugins'
 
 # rubocop:disable-next Metrics/BlockLength
 Tramway::Engine.routes.draw do
@@ -54,6 +55,15 @@ Tramway::Engine.routes.draw do
       nest.call(segments)
     end
   end
+
+  Tramway.config.plugins.each do |plugin_name|
+    plugin = Tramway::Plugins.fetch(plugin_name)
+    plugin_config = Tramway.config.plugins.public_send(plugin_name)
+
+    scope path: plugin_config.path do
+      plugin.draw_routes(self, plugin_config)
+    end
+  end
 end
 
 Tramway::Engine.routes.routes.map(&:name).compact.each do |route_name|

data/config/tailwind.config.js

@@ -61,6 +61,7 @@ module.exports = {
     'ease-in-out',
     'md:transition-[width]',
     'transition-[padding-left]',
+    'transition-[height,opacity]',
     'ease-in-out-strong',
     'md:ease-in-out-strong',
     'ease-out-strong',
@@ -281,6 +282,7 @@ module.exports = {
     // === Visibility and typography helpers ===
     'hidden',
     'text-xl',
+    'text-2xl',
     'font-bold',
     'prose',
     'prose-invert',
@@ -468,6 +470,8 @@ module.exports = {
     'whitespace-nowrap',
     'h-fit',
     'gap-1',
+    'mr-1',
+    'ml-1',
     'h-10',
     'px-2.5',
     'py-0.5',

data/lib/generators/tramway/install/install_generator.rb

@@ -4,6 +4,7 @@ require 'rails/generators'
 require 'fileutils'
 require_relative 'font_awesome_helpers'
 require_relative 'layout_helpers'
+require_relative 'solid_queue_helpers'
 
 module Tramway
   module Generators
@@ -115,7 +116,7 @@ module Tramway
 
       def stimulus_controller_imports
         [
-          'import { Navbar, TramwaySelect, UiCheckbox, Tooltip } from "@tramway/tramway"'
+          'import { Navbar, TramwaySelect, UiCheckbox, Tooltip, Collapsible } from "@tramway/tramway"'
         ]
       end
 
@@ -124,7 +125,8 @@ module Tramway
           "application.register('tramway-navbar', Navbar)",
           "application.register('tramway-select', TramwaySelect)",
           "application.register('ui--checkbox', UiCheckbox)",
-          "application.register('tramway-tooltip', Tooltip)"
+          "application.register('tramway-tooltip', Tooltip)",
+          "application.register('tramway--collapsible', Collapsible)"
         ]
       end
 
@@ -299,7 +301,8 @@ module Tramway
           "application.register('tramway-select'",
           "application.register('table-row-preview'",
           "application.register('ui--checkbox'",
-          "application.register('tramway-tooltip'"
+          "application.register('tramway-tooltip'",
+          "application.register('tramway--collapsible'"
         ]
       end
 
@@ -343,6 +346,7 @@ module Tramway
       include InstallGeneratorHelpers
       include InstallGeneratorFontAwesomeHelpers
       include InstallGeneratorLayoutHelpers
+      include InstallGeneratorSolidQueueHelpers
 
       desc 'Installs Tramway dependencies and Tailwind safelist configuration.'
 
@@ -440,6 +444,16 @@ module Tramway
       def ensure_navbar_sidebar_offset_in_application_layout
         ensure_navbar_sidebar_offset
       end
+
+      def ensure_solid_queue_bulk_actions_queue
+        return unless File.exist?(queue_yml_path)
+
+        content = File.read(queue_yml_path)
+        return if content.include?(TRAMWAY_SOLID_QUEUE_BULK_ACTIONS_QUEUE)
+
+        updated = insert_tramway_solid_queue_worker(content)
+        File.write(queue_yml_path, updated) if updated != content
+      end
     end
   end
 end

data/lib/generators/tramway/install/solid_queue_helpers.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module Tramway
+  module Generators
+    # nodoc
+    module InstallGeneratorSolidQueueHelpers
+      TRAMWAY_SOLID_QUEUE_BULK_ACTIONS_QUEUE = 'tramway_solid_queue_bulk_actions'
+      TRAMWAY_SOLID_QUEUE_BULK_ACTIONS_CONCURRENCY = 20
+
+      private
+
+      def queue_yml_path
+        @queue_yml_path ||= File.join(destination_root, 'config/queue.yml')
+      end
+
+      def insert_tramway_solid_queue_worker(content)
+        insertion_index, item_indent = workers_list_insertion_point(content)
+        return content unless insertion_index
+
+        content.dup.insert(insertion_index, tramway_solid_queue_worker_entry(item_indent))
+      end
+
+      # Finds where the `workers:` YAML list ends, so a new worker entry can be appended
+      # right after the existing ones, matching their indentation. This is line-based
+      # (rather than a full YAML parse) so ERB tags, comments, and anchors/aliases already
+      # present in the host app's queue.yml are left untouched.
+      def workers_list_insertion_point(content)
+        lines = content.each_line.to_a
+        workers_line_index = lines.find_index { |line| line.match?(/^[ \t]*workers:[ \t]*\n?\z/) }
+        return [nil, nil] unless workers_line_index
+
+        item_indent = lines[workers_line_index + 1]&.[](/^[ \t]*(?=- )/)
+        return [nil, nil] unless item_indent
+
+        search_range = (workers_line_index + 1)...lines.length
+        end_index = search_range.find { |index| !lines[index].start_with?(item_indent) }
+        end_index ||= lines.length
+
+        [lines[0...end_index].join.length, item_indent]
+      end
+
+      def tramway_solid_queue_worker_entry(indentation)
+        sub_indentation = "#{indentation}  "
+
+        <<~YAML
+          #{indentation}- queues: #{TRAMWAY_SOLID_QUEUE_BULK_ACTIONS_QUEUE}
+          #{sub_indentation}threads: #{TRAMWAY_SOLID_QUEUE_BULK_ACTIONS_CONCURRENCY}
+          #{sub_indentation}processes: 1
+          #{sub_indentation}polling_interval: 1
+        YAML
+      end
+    end
+  end
+end

data/lib/tramway/config.rb

@@ -3,6 +3,7 @@
 require 'anyway'
 require 'singleton'
 require 'tramway/configs/entity'
+require 'tramway/configs/plugins'
 
 module Tramway
   # Basic configuration of Tramway
@@ -13,7 +14,8 @@ module Tramway
     attr_config(
       entities: [],
       application_controller: 'ActionController::Base',
-      theme: :classic
+      theme: :classic,
+      plugins: []
     )
 
     def entities=(collection)
@@ -23,5 +25,9 @@ module Tramway
         Tramway::Configs::Entity.new(**entity_options)
       end)
     end
+
+    def plugins=(names)
+      super(Tramway::Configs::Plugins.new(names))
+    end
   end
 end

data/lib/tramway/configs/entities/page.rb

@@ -10,6 +10,7 @@ module Tramway
         attribute? :scope, Types::Coercible::String
         attribute? :search, Types::Bool
         attribute? :includes, Types::Array.default([].freeze)
+        attribute? :filters, Types::Array.default([].freeze)
       end
     end
   end