super_admin 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ec0af8666f1869249cfb770f05f2ef9891bd321359fe4f03f1af34409c9b24b6
+  data.tar.gz: f6e7dcb811c07530fabcf6517a0c0109ff54c4ffe3fa3a09ab0a2ed40ab3f1f9
+SHA512:
+  metadata.gz: d76e98768f788a4cc2dcfcdea9bf98c3bf0ccb7e0dd71c80c5d92eba4a35d134ec85b6d7ed4c28918acb109792c2e6c3d18ac300e640faa5f75428d54fafa424
+  data.tar.gz: dbdf1d1f0e045e750667eddf83477b2e799eaf047a2113c42f20457d56b32c6a45f8c480bd7b47539b7610cfa95bfdbc71e6a37face6c655c681d14e3fbd0d85

data/README.md

@@ -0,0 +1,216 @@
+# SuperAdmin 🚀
+
+[![Gem Version](https://badge.fury.io/rb/super_admin.svg)](https://badge.fury.io/rb/super_admin)
+[![CI Status](https://github.com/ThibautBaissac/super_admin/actions/workflows/ci.yml/badge.svg)](https://github.com/ThibautBaissac/super_admin/actions/workflows/ci.yml)
+[![Ruby Style Guide](https://img.shields.io/badge/code_style-rubocop-brightgreen.svg)](https://github.com/rubocop/rubocop)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**A modern, flexible administration engine for Rails applications**
+
+SuperAdmin is a mountable Rails engine that provides a full-featured administration interface inspired by Administrate and ActiveAdmin, built for modern Rails 7+ applications with Hotwire, Turbo, and Tailwind CSS.
+
+![SuperAdmin Dashboard](docs/images/dashboard-interface.png)
+
+**Quick Links:** [📖 Documentation](docs/) • [⚡ Features](docs/FEATURES.md) • [🚀 Quick Start](#quick-start) • [🤝 Contributing](#contributing)
+
+---
+
+## Why SuperAdmin?
+
+- **Built for Rails 7+** - Takes full advantage of Hotwire, Turbo, and modern Rails features
+- **⚡ Fast by Default** - Turbo-powered interactions without writing JavaScript
+- **Beautiful UI** - Modern, responsive design with Tailwind CSS
+- **Easy to Customize** - Simple DSL that doesn't get in your way
+- **Batteries Included** - Audit logging, CSV exports, and authorization built-in
+- **Quick Setup** - Get a full admin panel running in under 5 minutes
+
+## Status
+
+> **In Active Development** - This gem is currently in active development. APIs may change between versions. Production use is not recommended until v1.0 release.
+
+## Requirements
+
+- **Ruby** >= 3.2
+- **Rails** >= 7.1
+- **ImportMap Rails** (default in Rails 8+)
+
+## Installation
+
+### 1. Add the Gem
+
+```ruby
+gem "super_admin", git: "https://github.com/ThibautBaissac/super_admin.git"
+```
+
+Then run:
+```bash
+bundle install
+```
+
+### 2. Install SuperAdmin
+
+```bash
+rails generate super_admin:install
+rails db:migrate
+```
+
+### 3. Mount the Engine
+
+Add to your `config/routes.rb`:
+
+```ruby
+mount SuperAdmin::Engine => '/super_admin'
+```
+
+### 4. Generate Dashboards
+
+```bash
+# Generate dashboards for all models
+rails generate super_admin:dashboard
+
+# Or for a specific model
+rails generate super_admin:dashboard User
+```
+
+### 5. Start Your Server
+
+```bash
+bin/dev
+```
+
+Visit `/super_admin` and you're done! 🎉
+
+## Quick Start
+
+### Customize a Dashboard
+
+Edit the generated dashboard to control which attributes are displayed:
+
+```ruby
+# app/dashboards/super_admin/user_dashboard.rb
+module SuperAdmin
+  class UserDashboard < BaseDashboard
+    # Attributes shown in the table view
+    def collection_attributes
+      %i[id email name created_at]
+    end
+
+    # Attributes shown in the detail view
+    def show_attributes
+      %i[id email name role created_at updated_at posts]
+    end
+
+    # Attributes shown in the form
+    def form_attributes
+      %i[email name role bio]
+    end
+  end
+end
+```
+
+### Configure Authorization
+
+In `config/initializers/super_admin.rb`:
+
+```ruby
+SuperAdmin.configure do |config|
+  # Use Pundit
+  config.authorization_adapter = :pundit
+
+  # Or custom authorization
+  config.authorize_with do
+    redirect_to root_path unless current_user&.admin?
+  end
+
+  # Number of records per page
+  config.records_per_page = 20
+
+  # Maximum nested depth for associations
+  config.max_nested_depth = 3
+end
+```
+
+## Key Features
+
+- **Full CRUD Operations** - Create, read, update, delete with minimal configuration
+- **Advanced Filtering** - Search, filter, and sort with dynamic UI
+- **CSV Exports** - Background job processing with status tracking
+- **Audit Logging** - Track all admin activities automatically
+- **Nested Associations** - Smart form builder with configurable depth
+- **Authorization** - Pundit, CanCanCan, or custom authorization
+- **Turbo Streams** - Real-time updates without page reloads
+- **Accessibility** - WCAG 2.1 compliant with ARIA labels and keyboard navigation
+
+[📖 See all features](docs/FEATURES.md)
+
+## Documentation
+
+- **[Features](docs/FEATURES.md)** - Complete feature list
+- **[Architecture](CLAUDE.md)** - Technical architecture and patterns
+- **[Contributing](CONTRIBUTING.md)** - How to contribute
+- **[Code of Conduct](CODE_OF_CONDUCT.md)** - Community guidelines
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/ThibautBaissac/super_admin.git
+cd super_admin
+bundle install
+```
+
+### Running Tests
+
+```bash
+bin/rails test
+```
+
+### Code Quality
+
+```bash
+bin/rubocop
+```
+
+### Testing with a Rails App
+
+```bash
+cd test/dummy
+bin/rails db:seed
+bin/dev
+# Visit http://localhost:3000/super_admin/
+```
+
+## Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feat/my-feature`)
+3. Write tests for your changes
+4. Run tests and linter (`bin/rails test && bin/rubocop`)
+5. Commit your changes (`git commit -am 'Add new feature'`)
+6. Push to the branch (`git push origin feat/my-feature`)
+7. Create a Pull Request
+
+## License
+
+SuperAdmin is released under the [MIT License](MIT-LICENSE).
+
+## Support
+
+- 🐛 [Report a Bug](https://github.com/ThibautBaissac/super_admin/issues/new?labels=bug)
+- 💡 [Request a Feature](https://github.com/ThibautBaissac/super_admin/issues/new?labels=enhancement)
+- 📖 [Documentation](docs/)
+
+## Acknowledgments
+
+SuperAdmin is inspired by:
+- [Administrate](https://github.com/thoughtbot/administrate) - Thoughtbot's admin framework
+- [ActiveAdmin](https://github.com/activeadmin/activeadmin) - The Ruby on Rails framework for creating elegant backends
+
+---
+
+Made with ❤️ by [Thibaut Baissac](https://github.com/ThibautBaissac)
+
+[⭐ Star this repo](https://github.com/ThibautBaissac/super_admin) • [🐛 Report an issue](https://github.com/ThibautBaissac/super_admin/issues)

data/Rakefile

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+
+APP_RAKEFILE = File.expand_path("test/dummy/Rakefile", __dir__)
+load APP_RAKEFILE if File.exist?(APP_RAKEFILE)
+
+load "rails/tasks/engine.rake"
+load "rails/tasks/statistics.rake"
+
+require "rake/testtask"
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << "test"
+  t.pattern = "test/**/*_test.rb"
+  t.verbose = false
+end
+
+# Documentation with YARD
+begin
+  require "yard"
+  YARD::Rake::YardocTask.new do |t|
+    t.files = [ "app/**/*.rb", "lib/**/*.rb" ]
+    t.options = [ "--markup", "markdown", "--readme", "README.md" ]
+  end
+rescue LoadError
+  # YARD not available
+end
+
+task default: :test

data/app/assets/stylesheets/super_admin/application.css

@@ -0,0 +1,15 @@
+/*
+ * This is a manifest file that'll be compiled into application.css, which will include all the files
+ * listed below.
+ *
+ * Any CSS and SCSS file within this directory, lib/assets/stylesheets, vendor/assets/stylesheets,
+ * or any plugin's vendor/assets/stylesheets directory can be referenced here using a relative path.
+ *
+ * You're free to add application-wide styles to this file and they'll appear at the bottom of the
+ * compiled file so the styles you add here take precedence over styles defined in any other CSS/SCSS
+ * files in this directory. Styles in this file should be added after the last require_* statement.
+ * It is generally better to create a new file per style scope.
+ *
+ *= require_tree .
+ *= require_self
+ */

data/app/assets/stylesheets/super_admin/tailwind.css

@@ -0,0 +1 @@
+*,:after,:before{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }::backdrop{--tw-border-spacing-x:0;--tw-border-spacing-y:0;--tw-translate-x:0;--tw-translate-y:0;--tw-rotate:0;--tw-skew-x:0;--tw-skew-y:0;--tw-scale-x:1;--tw-scale-y:1;--tw-pan-x: ;--tw-pan-y: ;--tw-pinch-zoom: ;--tw-scroll-snap-strictness:proximity;--tw-gradient-from-position: ;--tw-gradient-via-position: ;--tw-gradient-to-position: ;--tw-ordinal: ;--tw-slashed-zero: ;--tw-numeric-figure: ;--tw-numeric-spacing: ;--tw-numeric-fraction: ;--tw-ring-inset: ;--tw-ring-offset-width:0px;--tw-ring-offset-color:#fff;--tw-ring-color:rgba(59,130,246,.5);--tw-ring-offset-shadow:0 0 #0000;--tw-ring-shadow:0 0 #0000;--tw-shadow:0 0 #0000;--tw-shadow-colored:0 0 #0000;--tw-blur: ;--tw-brightness: ;--tw-contrast: ;--tw-grayscale: ;--tw-hue-rotate: ;--tw-invert: ;--tw-saturate: ;--tw-sepia: ;--tw-drop-shadow: ;--tw-backdrop-blur: ;--tw-backdrop-brightness: ;--tw-backdrop-contrast: ;--tw-backdrop-grayscale: ;--tw-backdrop-hue-rotate: ;--tw-backdrop-invert: ;--tw-backdrop-opacity: ;--tw-backdrop-saturate: ;--tw-backdrop-sepia: ;--tw-contain-size: ;--tw-contain-layout: ;--tw-contain-paint: ;--tw-contain-style: }/*! tailwindcss v3.4.17 | MIT License | https://tailwindcss.com*/*,:after,:before{border:0 solid #e5e7eb;box-sizing:border-box}:after,:before{--tw-content:""}:host,html{line-height:1.5;-webkit-text-size-adjust:100%;font-family:ui-sans-serif,system-ui,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-feature-settings:normal;font-variation-settings:normal;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-tap-highlight-color:transparent}body{line-height:inherit;margin:0}hr{border-top-width:1px;color:inherit;height:0}abbr:where([title]){-webkit-text-decoration:underline dotted;text-decoration:underline dotted}h1,h2,h3,h4,h5,h6{font-size:inherit;font-weight:inherit}a{color:inherit;text-decoration:inherit}b,strong{font-weight:bolder}code,kbd,pre,samp{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-feature-settings:normal;font-size:1em;font-variation-settings:normal}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}table{border-collapse:collapse;border-color:inherit;text-indent:0}button,input,optgroup,select,textarea{color:inherit;font-family:inherit;font-feature-settings:inherit;font-size:100%;font-variation-settings:inherit;font-weight:inherit;letter-spacing:inherit;line-height:inherit;margin:0;padding:0}button,select{text-transform:none}button,input:where([type=button]),input:where([type=reset]),input:where([type=submit]){-webkit-appearance:button;background-color:transparent;background-image:none}:-moz-focusring{outline:auto}:-moz-ui-invalid{box-shadow:none}progress{vertical-align:baseline}::-webkit-inner-spin-button,::-webkit-outer-spin-button{height:auto}[type=search]{-webkit-appearance:textfield;outline-offset:-2px}::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{-webkit-appearance:button;font:inherit}summary{display:list-item}blockquote,dd,dl,figure,h1,h2,h3,h4,h5,h6,hr,p,pre{margin:0}fieldset{margin:0}fieldset,legend{padding:0}menu,ol,ul{list-style:none;margin:0;padding:0}dialog{padding:0}textarea{resize:vertical}input::-moz-placeholder,textarea::-moz-placeholder{color:#9ca3af;opacity:1}input::placeholder,textarea::placeholder{color:#9ca3af;opacity:1}[role=button],button{cursor:pointer}:disabled{cursor:default}audio,canvas,embed,iframe,img,object,svg,video{display:block;vertical-align:middle}img,video{height:auto;max-width:100%}[hidden]:where(:not([hidden=until-found])){display:none}body{overflow-x:hidden}.container{width:100%}@media (min-width:640px){.container{max-width:640px}}@media (min-width:768px){.container{max-width:768px}}@media (min-width:1024px){.container{max-width:1024px}}@media (min-width:1280px){.container{max-width:1280px}}@media (min-width:1536px){.container{max-width:1536px}}.sr-only{height:1px;margin:-1px;overflow:hidden;padding:0;position:absolute;width:1px;clip:rect(0,0,0,0);border-width:0;white-space:nowrap}.fixed{position:fixed}.sticky{position:sticky}.inset-0{inset:0}.inset-y-0{bottom:0;top:0}.left-0{left:0}.top-0{top:0}.z-20{z-index:20}.z-30{z-index:30}.z-40{z-index:40}.col-span-2{grid-column:span 2/span 2}.-mx-3{margin-left:-.75rem;margin-right:-.75rem}.mx-2{margin-left:.5rem;margin-right:.5rem}.mx-auto{margin-left:auto;margin-right:auto}.mb-1{margin-bottom:.25rem}.mb-2{margin-bottom:.5rem}.mb-3{margin-bottom:.75rem}.mb-4{margin-bottom:1rem}.mb-6{margin-bottom:1.5rem}.mb-8{margin-bottom:2rem}.ml-2{margin-left:.5rem}.ml-3{margin-left:.75rem}.mr-2{margin-right:.5rem}.mt-0\.5{margin-top:.125rem}.mt-1{margin-top:.25rem}.mt-2{margin-top:.5rem}.mt-4{margin-top:1rem}.mt-6{margin-top:1.5rem}.mt-8{margin-top:2rem}.mt-auto{margin-top:auto}.block{display:block}.inline-block{display:inline-block}.flex{display:flex}.inline-flex{display:inline-flex}.table{display:table}.grid{display:grid}.hidden{display:none}.h-12{height:3rem}.h-4{height:1rem}.h-5{height:1.25rem}.h-6{height:1.5rem}.h-8{height:2rem}.h-full{height:100%}.min-h-screen{min-height:100vh}.w-12{width:3rem}.w-4{width:1rem}.w-5{width:1.25rem}.w-6{width:1.5rem}.w-64{width:16rem}.w-8{width:2rem}.w-full{width:100%}.min-w-0{min-width:0}.min-w-\[180px\]{min-width:180px}.min-w-\[200px\]{min-width:200px}.min-w-full{min-width:100%}.max-w-3xl{max-width:48rem}.max-w-4xl{max-width:56rem}.max-w-5xl{max-width:64rem}.max-w-7xl{max-width:80rem}.max-w-full{max-width:100%}.max-w-md{max-width:28rem}.max-w-xs{max-width:20rem}.flex-1{flex:1 1 0%}.flex-shrink-0{flex-shrink:0}.-translate-x-full{--tw-translate-x:-100%}.-translate-x-full,.transform{transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.cursor-pointer{cursor:pointer}.list-inside{list-style-position:inside}.list-disc{list-style-type:disc}.grid-cols-1{grid-template-columns:repeat(1,minmax(0,1fr))}.grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.flex-col{flex-direction:column}.flex-wrap{flex-wrap:wrap}.items-start{align-items:flex-start}.items-end{align-items:flex-end}.items-center{align-items:center}.justify-end{justify-content:flex-end}.justify-center{justify-content:center}.justify-between{justify-content:space-between}.gap-2{gap:.5rem}.gap-3{gap:.75rem}.gap-4{gap:1rem}.gap-x-4{-moz-column-gap:1rem;column-gap:1rem}.gap-y-6{row-gap:1.5rem}.space-x-1>:not([hidden])~:not([hidden]){--tw-space-x-reverse:0;margin-left:calc(.25rem*(1 - var(--tw-space-x-reverse)));margin-right:calc(.25rem*var(--tw-space-x-reverse))}.space-x-2>:not([hidden])~:not([hidden]){--tw-space-x-reverse:0;margin-left:calc(.5rem*(1 - var(--tw-space-x-reverse)));margin-right:calc(.5rem*var(--tw-space-x-reverse))}.space-y-1>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-bottom:calc(.25rem*var(--tw-space-y-reverse));margin-top:calc(.25rem*(1 - var(--tw-space-y-reverse)))}.space-y-2>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-bottom:calc(.5rem*var(--tw-space-y-reverse));margin-top:calc(.5rem*(1 - var(--tw-space-y-reverse)))}.space-y-4>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-bottom:calc(1rem*var(--tw-space-y-reverse));margin-top:calc(1rem*(1 - var(--tw-space-y-reverse)))}.space-y-6>:not([hidden])~:not([hidden]){--tw-space-y-reverse:0;margin-bottom:calc(1.5rem*var(--tw-space-y-reverse));margin-top:calc(1.5rem*(1 - var(--tw-space-y-reverse)))}.divide-y>:not([hidden])~:not([hidden]){--tw-divide-y-reverse:0;border-bottom-width:calc(1px*var(--tw-divide-y-reverse));border-top-width:calc(1px*(1 - var(--tw-divide-y-reverse)))}.divide-gray-200>:not([hidden])~:not([hidden]){--tw-divide-opacity:1;border-color:rgb(229 231 235/var(--tw-divide-opacity,1))}.overflow-auto{overflow:auto}.overflow-hidden{overflow:hidden}.overflow-x-auto{overflow-x:auto}.overflow-y-auto{overflow-y:auto}.truncate{overflow:hidden;text-overflow:ellipsis}.truncate,.whitespace-nowrap{white-space:nowrap}.whitespace-pre-wrap{white-space:pre-wrap}.rounded{border-radius:.25rem}.rounded-full{border-radius:9999px}.rounded-lg{border-radius:.5rem}.rounded-md{border-radius:.375rem}.border{border-width:1px}.border-2{border-width:2px}.border-b{border-bottom-width:1px}.border-t{border-top-width:1px}.border-dashed{border-style:dashed}.border-blue-200{--tw-border-opacity:1;border-color:rgb(191 219 254/var(--tw-border-opacity,1))}.border-blue-300{--tw-border-opacity:1;border-color:rgb(147 197 253/var(--tw-border-opacity,1))}.border-blue-400{--tw-border-opacity:1;border-color:rgb(96 165 250/var(--tw-border-opacity,1))}.border-gray-200{--tw-border-opacity:1;border-color:rgb(229 231 235/var(--tw-border-opacity,1))}.border-gray-300{--tw-border-opacity:1;border-color:rgb(209 213 219/var(--tw-border-opacity,1))}.border-gray-800{--tw-border-opacity:1;border-color:rgb(31 41 55/var(--tw-border-opacity,1))}.border-green-200{--tw-border-opacity:1;border-color:rgb(187 247 208/var(--tw-border-opacity,1))}.border-red-200{--tw-border-opacity:1;border-color:rgb(254 202 202/var(--tw-border-opacity,1))}.border-transparent{border-color:transparent}.border-yellow-200{--tw-border-opacity:1;border-color:rgb(254 240 138/var(--tw-border-opacity,1))}.bg-blue-100{--tw-bg-opacity:1;background-color:rgb(219 234 254/var(--tw-bg-opacity,1))}.bg-blue-200{--tw-bg-opacity:1;background-color:rgb(191 219 254/var(--tw-bg-opacity,1))}.bg-blue-50{--tw-bg-opacity:1;background-color:rgb(239 246 255/var(--tw-bg-opacity,1))}.bg-blue-500{--tw-bg-opacity:1;background-color:rgb(59 130 246/var(--tw-bg-opacity,1))}.bg-blue-600{--tw-bg-opacity:1;background-color:rgb(37 99 235/var(--tw-bg-opacity,1))}.bg-blue-700{--tw-bg-opacity:1;background-color:rgb(29 78 216/var(--tw-bg-opacity,1))}.bg-blue-900{--tw-bg-opacity:1;background-color:rgb(30 58 138/var(--tw-bg-opacity,1))}.bg-blue-opacity{background-color:rgba(59,130,246,.1)}.bg-gray-100{--tw-bg-opacity:1;background-color:rgb(243 244 246/var(--tw-bg-opacity,1))}.bg-gray-200{--tw-bg-opacity:1;background-color:rgb(229 231 235/var(--tw-bg-opacity,1))}.bg-gray-300{--tw-bg-opacity:1;background-color:rgb(209 213 219/var(--tw-bg-opacity,1))}.bg-gray-50{--tw-bg-opacity:1;background-color:rgb(249 250 251/var(--tw-bg-opacity,1))}.bg-gray-700{--tw-bg-opacity:1;background-color:rgb(55 65 81/var(--tw-bg-opacity,1))}.bg-gray-800{--tw-bg-opacity:1;background-color:rgb(31 41 55/var(--tw-bg-opacity,1))}.bg-gray-900{--tw-bg-opacity:1;background-color:rgb(17 24 39/var(--tw-bg-opacity,1))}.bg-green-100{--tw-bg-opacity:1;background-color:rgb(220 252 231/var(--tw-bg-opacity,1))}.bg-green-200{--tw-bg-opacity:1;background-color:rgb(187 247 208/var(--tw-bg-opacity,1))}.bg-green-50{--tw-bg-opacity:1;background-color:rgb(240 253 244/var(--tw-bg-opacity,1))}.bg-green-500{--tw-bg-opacity:1;background-color:rgb(34 197 94/var(--tw-bg-opacity,1))}.bg-green-600{--tw-bg-opacity:1;background-color:rgb(22 163 74/var(--tw-bg-opacity,1))}.bg-green-700{--tw-bg-opacity:1;background-color:rgb(21 128 61/var(--tw-bg-opacity,1))}.bg-green-900{--tw-bg-opacity:1;background-color:rgb(20 83 45/var(--tw-bg-opacity,1))}.bg-green-opacity{background-color:rgba(34,197,94,.1)}.bg-red-100{--tw-bg-opacity:1;background-color:rgb(254 226 226/var(--tw-bg-opacity,1))}.bg-red-200{--tw-bg-opacity:1;background-color:rgb(254 202 202/var(--tw-bg-opacity,1))}.bg-red-400{--tw-bg-opacity:1;background-color:rgb(248 113 113/var(--tw-bg-opacity,1))}.bg-red-50{--tw-bg-opacity:1;background-color:rgb(254 242 242/var(--tw-bg-opacity,1))}.bg-red-600{--tw-bg-opacity:1;background-color:rgb(220 38 38/var(--tw-bg-opacity,1))}.bg-red-700{--tw-bg-opacity:1;background-color:rgb(185 28 28/var(--tw-bg-opacity,1))}.bg-red-900{--tw-bg-opacity:1;background-color:rgb(127 29 29/var(--tw-bg-opacity,1))}.bg-red-opacity{background-color:rgba(239,68,68,.1)}.bg-white{--tw-bg-opacity:1;background-color:rgb(255 255 255/var(--tw-bg-opacity,1))}.bg-yellow-100{--tw-bg-opacity:1;background-color:rgb(254 249 195/var(--tw-bg-opacity,1))}.bg-yellow-200{--tw-bg-opacity:1;background-color:rgb(254 240 138/var(--tw-bg-opacity,1))}.bg-yellow-50{--tw-bg-opacity:1;background-color:rgb(254 252 232/var(--tw-bg-opacity,1))}.bg-yellow-600{--tw-bg-opacity:1;background-color:rgb(202 138 4/var(--tw-bg-opacity,1))}.bg-yellow-700{--tw-bg-opacity:1;background-color:rgb(161 98 7/var(--tw-bg-opacity,1))}.bg-yellow-900{--tw-bg-opacity:1;background-color:rgb(113 63 18/var(--tw-bg-opacity,1))}.bg-yellow-opacity{background-color:rgba(234,179,8,.1)}.bg-opacity-50{--tw-bg-opacity:0.5}.bg-gradient-blue{background-image:linear-gradient(135deg,#e0f2fe,#bae6fd)}.bg-gradient-green{background-image:linear-gradient(135deg,#d1fae5,#a7f3d0)}.bg-gradient-red{background-image:linear-gradient(135deg,#fee2e2,#fecaca)}.bg-gradient-to-r{background-image:linear-gradient(to right,var(--tw-gradient-stops))}.bg-gradient-yellow{background-image:linear-gradient(135deg,#fef3c7,#fde68a)}.from-gray-50{--tw-gradient-from:#f9fafb var(--tw-gradient-from-position);--tw-gradient-to:rgba(249,250,251,0) var(--tw-gradient-to-position);--tw-gradient-stops:var(--tw-gradient-from),var(--tw-gradient-to)}.to-gray-100{--tw-gradient-to:#f3f4f6 var(--tw-gradient-to-position)}.p-1\.5{padding:.375rem}.p-12{padding:3rem}.p-2{padding:.5rem}.p-3{padding:.75rem}.p-4{padding:1rem}.px-2{padding-left:.5rem;padding-right:.5rem}.px-2\.5{padding-left:.625rem;padding-right:.625rem}.px-3{padding-left:.75rem;padding-right:.75rem}.px-4{padding-left:1rem;padding-right:1rem}.px-6{padding-left:1.5rem;padding-right:1.5rem}.py-0\.5{padding-bottom:.125rem;padding-top:.125rem}.py-1{padding-bottom:.25rem;padding-top:.25rem}.py-2{padding-bottom:.5rem;padding-top:.5rem}.py-3{padding-bottom:.75rem;padding-top:.75rem}.py-4{padding-bottom:1rem;padding-top:1rem}.py-6{padding-bottom:1.5rem;padding-top:1.5rem}.py-8{padding-bottom:2rem;padding-top:2rem}.pt-0\.5{padding-top:.125rem}.pt-2{padding-top:.5rem}.pt-4{padding-top:1rem}.pt-6{padding-top:1.5rem}.text-left{text-align:left}.text-center{text-align:center}.text-right{text-align:right}.align-middle{vertical-align:middle}.font-mono{font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace}.text-2xl{font-size:1.5rem;line-height:2rem}.text-3xl{font-size:1.875rem;line-height:2.25rem}.text-base{font-size:1rem;line-height:1.5rem}.text-lg{font-size:1.125rem;line-height:1.75rem}.text-sm{font-size:.875rem;line-height:1.25rem}.text-xl{font-size:1.25rem;line-height:1.75rem}.text-xs{font-size:.75rem;line-height:1rem}.font-bold{font-weight:700}.font-medium{font-weight:500}.font-semibold{font-weight:600}.uppercase{text-transform:uppercase}.capitalize{text-transform:capitalize}.italic{font-style:italic}.leading-5{line-height:1.25rem}.leading-relaxed{line-height:1.625}.tracking-wider{letter-spacing:.05em}.text-blue-400{--tw-text-opacity:1;color:rgb(96 165 250/var(--tw-text-opacity,1))}.text-blue-600{--tw-text-opacity:1;color:rgb(37 99 235/var(--tw-text-opacity,1))}.text-blue-700{--tw-text-opacity:1;color:rgb(29 78 216/var(--tw-text-opacity,1))}.text-blue-800{--tw-text-opacity:1;color:rgb(30 64 175/var(--tw-text-opacity,1))}.text-blue-900{--tw-text-opacity:1;color:rgb(30 58 138/var(--tw-text-opacity,1))}.text-gray-300{--tw-text-opacity:1;color:rgb(209 213 219/var(--tw-text-opacity,1))}.text-gray-400{--tw-text-opacity:1;color:rgb(156 163 175/var(--tw-text-opacity,1))}.text-gray-500{--tw-text-opacity:1;color:rgb(107 114 128/var(--tw-text-opacity,1))}.text-gray-600{--tw-text-opacity:1;color:rgb(75 85 99/var(--tw-text-opacity,1))}.text-gray-700{--tw-text-opacity:1;color:rgb(55 65 81/var(--tw-text-opacity,1))}.text-gray-800{--tw-text-opacity:1;color:rgb(31 41 55/var(--tw-text-opacity,1))}.text-gray-900{--tw-text-opacity:1;color:rgb(17 24 39/var(--tw-text-opacity,1))}.text-green-400{--tw-text-opacity:1;color:rgb(74 222 128/var(--tw-text-opacity,1))}.text-green-600{--tw-text-opacity:1;color:rgb(22 163 74/var(--tw-text-opacity,1))}.text-green-700{--tw-text-opacity:1;color:rgb(21 128 61/var(--tw-text-opacity,1))}.text-green-800{--tw-text-opacity:1;color:rgb(22 101 52/var(--tw-text-opacity,1))}.text-green-900{--tw-text-opacity:1;color:rgb(20 83 45/var(--tw-text-opacity,1))}.text-indigo-600{--tw-text-opacity:1;color:rgb(79 70 229/var(--tw-text-opacity,1))}.text-red-400{--tw-text-opacity:1;color:rgb(248 113 113/var(--tw-text-opacity,1))}.text-red-600{--tw-text-opacity:1;color:rgb(220 38 38/var(--tw-text-opacity,1))}.text-red-700{--tw-text-opacity:1;color:rgb(185 28 28/var(--tw-text-opacity,1))}.text-red-800{--tw-text-opacity:1;color:rgb(153 27 27/var(--tw-text-opacity,1))}.text-red-900{--tw-text-opacity:1;color:rgb(127 29 29/var(--tw-text-opacity,1))}.text-white{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity,1))}.text-yellow-600{--tw-text-opacity:1;color:rgb(202 138 4/var(--tw-text-opacity,1))}.text-yellow-700{--tw-text-opacity:1;color:rgb(161 98 7/var(--tw-text-opacity,1))}.text-yellow-800{--tw-text-opacity:1;color:rgb(133 77 14/var(--tw-text-opacity,1))}.text-yellow-900{--tw-text-opacity:1;color:rgb(113 63 18/var(--tw-text-opacity,1))}.shadow{--tw-shadow:0 1px 3px 0 rgba(0,0,0,.1),0 1px 2px -1px rgba(0,0,0,.1);--tw-shadow-colored:0 1px 3px 0 var(--tw-shadow-color),0 1px 2px -1px var(--tw-shadow-color)}.shadow,.shadow-md{box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.shadow-md{--tw-shadow:0 4px 6px -1px rgba(0,0,0,.1),0 2px 4px -2px rgba(0,0,0,.1);--tw-shadow-colored:0 4px 6px -1px var(--tw-shadow-color),0 2px 4px -2px var(--tw-shadow-color)}.shadow-sm{--tw-shadow:0 1px 2px 0 rgba(0,0,0,.05);--tw-shadow-colored:0 1px 2px 0 var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.outline{outline-style:solid}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.transition-all{transition-duration:.15s;transition-property:all;transition-timing-function:cubic-bezier(.4,0,.2,1)}.transition-colors{transition-duration:.15s;transition-property:color,background-color,border-color,text-decoration-color,fill,stroke;transition-timing-function:cubic-bezier(.4,0,.2,1)}.transition-transform{transition-duration:.15s;transition-property:transform;transition-timing-function:cubic-bezier(.4,0,.2,1)}.duration-300{transition-duration:.3s}.ease-in-out{transition-timing-function:cubic-bezier(.4,0,.2,1)}.hover\:bg-black\/5:hover{background-color:rgba(0,0,0,.05)}.hover\:bg-gray-100:hover{--tw-bg-opacity:1;background-color:rgb(243 244 246/var(--tw-bg-opacity,1))}.hover\:bg-gray-50:hover{--tw-bg-opacity:1;background-color:rgb(249 250 251/var(--tw-bg-opacity,1))}.hover\:bg-gray-800:hover{--tw-bg-opacity:1;background-color:rgb(31 41 55/var(--tw-bg-opacity,1))}.hover\:text-blue-900:hover{--tw-text-opacity:1;color:rgb(30 58 138/var(--tw-text-opacity,1))}.hover\:text-gray-700:hover{--tw-text-opacity:1;color:rgb(55 65 81/var(--tw-text-opacity,1))}.hover\:text-gray-900:hover{--tw-text-opacity:1;color:rgb(17 24 39/var(--tw-text-opacity,1))}.hover\:text-indigo-900:hover{--tw-text-opacity:1;color:rgb(49 46 129/var(--tw-text-opacity,1))}.hover\:text-red-700:hover{--tw-text-opacity:1;color:rgb(185 28 28/var(--tw-text-opacity,1))}.hover\:text-white:hover{--tw-text-opacity:1;color:rgb(255 255 255/var(--tw-text-opacity,1))}.focus\:border-blue-500:focus{--tw-border-opacity:1;border-color:rgb(59 130 246/var(--tw-border-opacity,1))}.focus\:outline-none:focus{outline:2px solid transparent;outline-offset:2px}.focus\:ring-2:focus{--tw-ring-offset-shadow:var(--tw-ring-inset) 0 0 0 var(--tw-ring-offset-width) var(--tw-ring-offset-color);--tw-ring-shadow:var(--tw-ring-inset) 0 0 0 calc(2px + var(--tw-ring-offset-width)) var(--tw-ring-color);box-shadow:var(--tw-ring-offset-shadow),var(--tw-ring-shadow),var(--tw-shadow,0 0 #0000)}.focus\:ring-inset:focus{--tw-ring-inset:inset}.focus\:ring-blue-500:focus{--tw-ring-opacity:1;--tw-ring-color:rgb(59 130 246/var(--tw-ring-opacity,1))}.focus\:ring-current:focus{--tw-ring-color:currentColor}.focus\:ring-gray-500:focus{--tw-ring-opacity:1;--tw-ring-color:rgb(107 114 128/var(--tw-ring-opacity,1))}.focus\:ring-offset-2:focus{--tw-ring-offset-width:2px}@media (min-width:640px){.sm\:mx-0{margin-left:0;margin-right:0}.sm\:mb-6{margin-bottom:1.5rem}.sm\:mb-8{margin-bottom:2rem}.sm\:ml-4{margin-left:1rem}.sm\:mt-6{margin-top:1.5rem}.sm\:table-cell{display:table-cell}.sm\:h-10{height:2.5rem}.sm\:h-5{height:1.25rem}.sm\:w-10{width:2.5rem}.sm\:w-5{width:1.25rem}.sm\:grid-cols-2{grid-template-columns:repeat(2,minmax(0,1fr))}.sm\:flex-row{flex-direction:row}.sm\:items-center{align-items:center}.sm\:justify-between{justify-content:space-between}.sm\:gap-3{gap:.75rem}.sm\:gap-4{gap:1rem}.sm\:gap-6{gap:1.5rem}.sm\:space-x-2>:not([hidden])~:not([hidden]){--tw-space-x-reverse:0;margin-left:calc(.5rem*(1 - var(--tw-space-x-reverse)));margin-right:calc(.5rem*var(--tw-space-x-reverse))}.sm\:p-4{padding:1rem}.sm\:p-6{padding:1.5rem}.sm\:px-4{padding-left:1rem;padding-right:1rem}.sm\:px-6{padding-left:1.5rem;padding-right:1.5rem}.sm\:py-2\.5{padding-bottom:.625rem;padding-top:.625rem}.sm\:py-4{padding-bottom:1rem;padding-top:1rem}.sm\:py-5{padding-bottom:1.25rem;padding-top:1.25rem}.sm\:py-8{padding-bottom:2rem;padding-top:2rem}.sm\:text-3xl{font-size:1.875rem;line-height:2.25rem}.sm\:text-base{font-size:1rem;line-height:1.5rem}.sm\:text-lg{font-size:1.125rem;line-height:1.75rem}.sm\:text-sm{font-size:.875rem;line-height:1.25rem}}@media (min-width:768px){.md\:flex-row{flex-direction:row}.md\:items-center{align-items:center}.md\:justify-between{justify-content:space-between}}@media (min-width:1024px){.lg\:static{position:static}.lg\:mb-6{margin-bottom:1.5rem}.lg\:mr-3{margin-right:.75rem}.lg\:hidden{display:none}.lg\:translate-x-0{--tw-translate-x:0px;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}.lg\:grid-cols-3{grid-template-columns:repeat(3,minmax(0,1fr))}.lg\:justify-start{justify-content:flex-start}.lg\:px-4{padding-left:1rem;padding-right:1rem}.lg\:px-8{padding-left:2rem;padding-right:2rem}.lg\:py-6{padding-bottom:1.5rem;padding-top:1.5rem}.lg\:text-2xl{font-size:1.5rem;line-height:2rem}}

data/app/assets/stylesheets/super_admin/tailwind.source.css

@@ -0,0 +1,25 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/* SuperAdmin custom styles */
+/* These styles extend Tailwind's utility classes for SuperAdmin-specific needs */
+
+@layer utilities {
+  /* Ensure mobile menu overlay appears above content */
+  .z-mobile-menu {
+    z-index: 40;
+  }
+
+  /* Smooth transitions for mobile menu */
+  .transition-sidebar {
+    transition: transform 0.3s ease-in-out;
+  }
+}
+
+@layer base {
+  /* Prevent horizontal scroll on mobile */
+  body {
+    overflow-x: hidden;
+  }
+}

data/app/controllers/super_admin/application_controller.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module SuperAdmin
+  # Base application controller for SuperAdmin namespace.
+  # Delegates authentication and layout decisions to configuration to ease gem extraction.
+  class ApplicationController < SuperAdmin.configuration.parent_controller_constant
+    layout -> { SuperAdmin.configuration.layout }
+
+    helper SuperAdmin::ApplicationHelper
+
+    before_action :authenticate_super_admin_user!, if: -> { SuperAdmin.configuration.authenticate_with.present? }
+    around_action :with_super_admin_locale, if: -> { SuperAdmin.configuration.default_locale.present? }
+
+    private
+
+    def authenticate_super_admin_user!
+      strategy = SuperAdmin.configuration.authenticate_with
+
+      case strategy
+      when Proc
+        invoke_proc_strategy(strategy, self)
+      when Symbol, String
+        send(strategy)
+      end
+    end
+
+    def with_super_admin_locale(&block)
+      locale = SuperAdmin.configuration.default_locale || I18n.default_locale
+      I18n.with_locale(locale, &block)
+    end
+
+    def current_user
+      strategy = SuperAdmin.configuration.current_user_method
+
+      case strategy
+      when Proc
+        result = invoke_proc_strategy(strategy, self)
+
+        if result.nil?
+          original_receiver = proc_original_receiver(strategy)
+          if original_receiver && !original_receiver.equal?(self)
+            begin
+              alternate = invoke_proc_strategy(strategy, original_receiver)
+              result = alternate unless alternate.nil?
+            rescue NameError, NoMethodError
+              # Ignore fallback errors; return the best effort result
+            end
+          end
+        end
+
+        return result unless result.nil?
+
+        defined?(super) ? super : nil
+      when Symbol, String
+        strategy_name = strategy.to_sym
+
+        if strategy_name == __method__
+          defined?(super) ? super : nil
+        elsif respond_to?(strategy_name, true)
+          send(strategy_name)
+        elsif defined?(super)
+          super
+        end
+      else
+        defined?(super) ? super : nil
+      end
+    end
+
+    def invoke_proc_strategy(strategy, receiver)
+      return unless strategy
+
+      arity = strategy.arity
+
+      if arity.zero?
+        receiver.instance_exec(&strategy)
+      else
+        strategy.call(receiver)
+      end
+    rescue ArgumentError
+      strategy.call(receiver)
+    end
+
+    def proc_original_receiver(strategy)
+      strategy.binding.receiver
+    rescue ArgumentError
+      nil
+    end
+  end
+end

data/app/controllers/super_admin/associations_controller.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+module SuperAdmin
+  # API controller for association search in forms.
+  # Enables pagination and search in large collections.
+  class AssociationsController < SuperAdmin::BaseController
+    # GET /super_admin/associations/search
+    # Parameters: model, q (query), page, selected_id
+    def search
+      model_class = SuperAdmin::ModelInspector.find_model(params[:model])
+
+      unless model_class
+        return render json: { error: "Model not found" }, status: :not_found
+      end
+
+      query = params[:q].to_s.strip
+      page = [ params[:page].to_i, 1 ].max
+      selected_id = params[:selected_id].presence
+      per_page = SuperAdmin.association_pagination_limit
+
+      scope = build_search_scope(model_class, query)
+
+      total_count = scope.count
+      records = scope.offset((page - 1) * per_page).limit(per_page)
+
+      # Include currently selected record if not in results
+      selected_record = nil
+      if selected_id.present?
+        selected_record = model_class.find_by(id: selected_id)
+        records = [ selected_record ] + records.to_a if selected_record && page == 1
+        records.uniq!(&:id) if selected_record
+      end
+
+      render json: {
+        results: records.map { |r| { id: r.id, text: sanitize_output(display_label_for(r)) } },
+        pagination: {
+          more: (page * per_page) < total_count,
+          page: page,
+          per_page: per_page,
+          total: total_count
+        }
+      }
+    rescue StandardError => e
+      Rails.logger.error("SuperAdmin::AssociationsController - Search error: #{e.message}")
+      render json: { error: "Search failed" }, status: :internal_server_error
+    end
+
+    private
+
+    def display_label_for(record)
+      return record.to_s unless record.respond_to?(:attributes)
+
+      name = record.respond_to?(:name) ? record.name.presence : nil
+      email = record.respond_to?(:email) ? record.email.presence : nil
+      title = record.respond_to?(:title) ? record.title.presence : nil
+      label = record.respond_to?(:label) ? record.label.presence : nil
+
+      if name && email
+        "#{name} (#{email})"
+      elsif name
+        name
+      elsif title && email
+        "#{title} (#{email})"
+      elsif title
+        title
+      elsif email
+        email
+      elsif label
+        label
+      else
+        record.to_s
+      end
+    end
+
+    def build_search_scope(model_class, query)
+      scope = model_class.all
+
+      return scope if query.blank?
+
+      searchable_columns = detect_searchable_columns(model_class)
+
+      return scope if searchable_columns.empty?
+
+      # Build secure Arel conditions instead of string interpolation
+      arel_table = model_class.arel_table
+      sanitized_query = sanitize_sql_like(query)
+      pattern = "%#{sanitized_query}%"
+
+      # Use ILIKE for PostgreSQL (case-insensitive), LIKE with LOWER() for SQLite
+      use_ilike = ActiveRecord::Base.connection.adapter_name.downcase.include?("postgres")
+
+      arel_conditions = searchable_columns.map do |column_name|
+        # Ensure column exists in the table to prevent injection
+        next unless model_class.column_names.include?(column_name)
+
+        column = arel_table[column_name.to_sym]
+
+        if use_ilike
+          column.matches(pattern, nil, true) # Third argument = case_insensitive for PostgreSQL
+        else
+          # For SQLite and other databases, use LOWER() for case-insensitive search
+          Arel::Nodes::NamedFunction.new("LOWER", [ column ])
+            .matches(Arel::Nodes.build_quoted(pattern.downcase))
+        end
+      end.compact
+
+      return scope if arel_conditions.empty?
+
+      # Combine conditions with OR
+      combined_condition = arel_conditions.reduce { |memo, condition| memo.or(condition) }
+      scope.where(combined_condition)
+    end
+
+    def detect_searchable_columns(model_class)
+      string_columns = model_class.columns
+                                  .select { |col| %i[string text].include?(col.type) }
+                                  .map(&:name)
+
+      priority_columns = %w[name title label email username]
+      searchable = string_columns & priority_columns
+
+      searchable = string_columns.first(3) if searchable.empty?
+
+      searchable
+    end
+
+    def sanitize_sql_like(string)
+      string.gsub(/[%_]/) { |match| "\\#{match}" }
+    end
+
+    # Sanitize output to prevent XSS attacks
+    def sanitize_output(string)
+      ERB::Util.html_escape(string.to_s)
+    end
+  end
+end

data/app/controllers/super_admin/audit_logs_controller.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module SuperAdmin
+  # Read-only view over audit events recorded within SuperAdmin.
+  class AuditLogsController < SuperAdmin::BaseController
+    before_action :ensure_audit_log_table!
+
+    def index
+      scope = SuperAdmin::AuditLog.recent
+      scope = scope.where(action: params[:action_type]) if params[:action_type].present?
+      scope = scope.where(resource_type: params[:resource_type]) if params[:resource_type].present?
+      scope = apply_query(scope)
+
+      @pagy, @audit_logs = pagy(scope, limit: 25)
+    end
+
+    private
+
+    def apply_query(scope)
+      return scope unless params[:query].present?
+
+      term = "%#{params[:query].to_s.strip.downcase}%"
+      scope.where(
+        "LOWER(user_email) LIKE :term OR LOWER(resource_type) LIKE :term OR LOWER(action) LIKE :term",
+        term: term
+      )
+    end
+
+    def ensure_audit_log_table!
+      return if SuperAdmin::AuditLog.table_exists?
+
+      flash[:alert] = t("super_admin.audit_logs.missing_table")
+      redirect_to super_admin_root_path
+    rescue ActiveRecord::NoDatabaseError, ActiveRecord::StatementInvalid
+      flash[:alert] = t("super_admin.audit_logs.missing_table")
+      redirect_to super_admin_root_path
+    end
+  end
+end