one-for-all-framework 4.4.0 → 4.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 345583a2af3a1c7ee4eb6d923c1d87ea769a5f6e70c98537a36575d1ee89dc03
-  data.tar.gz: 596e7f2abe8bcf277d180e5044e9b5fb77fbfa894c894c92639d7cda3fc4136a
+  metadata.gz: d724d07382e25a25fc566c6c889497bcabca8ef5536f86c13d9337f48507ef74
+  data.tar.gz: d7322c62e8380e22f17773b3202a7574859db716289706591db041205df38b61
 SHA512:
-  metadata.gz: 9b5c07c96b28fc73548e35ecbb81113361d6b32575c4a681bf7bf0b916e2c39e4b18e34032f252c83176116a89d4377d8f1f58ee16acab90cdafb4d0ce467b03
-  data.tar.gz: bcb67f5526ebca56809ec9fa8009199b0911c2668445b8eb15ecd7f5995edde4fd8b33271b4168a416fc04aa87f768947d8109a1e0816a97b2620571cd1f911d
+  metadata.gz: 896e3107819354a1e335519e4a4ec8f6934bdab41ea7f2e99558bed67ede658295b1be2aeead6d50608d5a9c3b51603e71d1754837f6c45cd93b43580a5b1a72
+  data.tar.gz: 7d9f02100feb5a46ee909932672c03443e585ba7fd6641d05d84006f3de780f5de85e56e381a84c0b4337fc6c59a5e9ea621f5281c112f8093be3063d19c3360

data/README.md

@@ -2,7 +2,7 @@
   <img src="public/images/logo.png" width="500" height="500" alt="OFA Framework Logo">
 </p>
 
-# ⚡ One-For-All (OFA) Framework v4.4.0
+# ⚡ One-For-All (OFA) Framework v4.5.0
 
 [![Ruby Version](https://img.shields.io/badge/ruby-%3E%3D%203.0.0-red.svg)](https://www.ruby-lang.org/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
@@ -22,6 +22,9 @@
 -   **🌐 Global Support**: Multi-language (I18n) support and SEO optimization ready.
 -   **🖋️ Rich Text Editor**: Integrated Trix Editor for seamless post and page creation with image upload support.
 -   **📡 Modern API**: Built-in JWT support and automated Swagger/OpenAPI documentation.
+-   **🚧 Maintenance Mode**: Instantly toggle "Under Construction" mode via CLI.
+-   **🔍 Activity Logs**: Full audit trail in CMS to monitor user actions and security.
+-   **🔌 Plugin System**: Modular architecture to extend the framework with custom add-ons.
 
 ---
 
@@ -129,6 +132,10 @@ Switches between local disk and Cloudinary cloud storage.
 Securely manages admin credentials.
 *   **Output:** `✅ Password for 'admin' updated successfully.`
 
+#### `ofa maintenance [on|off]`
+Instantly toggles a premium "Under Construction" page for visitors while allowing admin access.
+*   **Output:** `✅ Maintenance mode has been turned on.`
+
 ---
 
 ### 📁 Project Lifecycle
@@ -143,6 +150,7 @@ Securely manages admin credentials.
 | `ofa swagger` | **OpenAPI Generation.** Auto-generates `openapi.json` for your entire application. |
 | `ofa task NAME` | **Run Background Task.** Executes a task defined in `lib/tasks/`. |
 | `ofa test` | **Run Test Suite.** Executes all unit tests in the `test/` directory using Minitest. |
+| `ofa maintenance on/off` | **Toggle Site Access.** Activates a beautiful maintenance page. Admins can still bypass it to work. |
 | `ofa deploy` | **Production Deployment.** Automatically detects deployment targets (Railway/Docker/Git). |
 
 ---
@@ -159,6 +167,7 @@ Automate the creation of boilerplate code with the generator command.
 | `ofa g mailer NAME ACTION` | Generates a new mailer in `app/mailers/` and an ERB template in `app/views/mailers/`. |
 | `ofa g task NAME` | Creates a new background task file in `lib/tasks/`. |
 | `ofa g test NAME` | Generates a new Minitest unit test in `test/`. |
+| `ofa g plugin NAME` | **Plugin Scaffolding.** Creates a new plugin structure in the `plugins/` directory. |
 | `ofa g post TITLE` | Creates a new Markdown/ERB post in `app/views/posts/`. <br> *Args:* `--category`, `--author`, `--image`. <br> *Example:* `./ofa g post "My First Journey" --category Tech --author "John Doe"` |
 
 ---

data/app/controllers/activity_logs_controller.rb

@@ -0,0 +1,9 @@
+require_relative 'application_controller'
+
+class ActivityLogsController < ApplicationController
+  def index
+    # Fetch logs with user association
+    @logs = ActivityLog.order(Sequel.desc(:created_at)).limit(100).all
+    render 'cms/activity_logs'
+  end
+end

data/app/controllers/application_controller.rb

@@ -46,6 +46,15 @@ class ApplicationController
     @req.env['eks_cent.csrf_token']
   end
 
+  # Activity Logger
+  def log_activity(action, target = nil, details = nil)
+    user_id = session['user_id'] || session[:user_id]
+    return unless user_id
+    ActivityLog.log(user_id, action, target, details)
+  end
+
+  private
+
   def boolean_param(val)
     ['1', 'true', 'on'].include?(val.to_s)
   end

data/app/controllers/pages_controller.rb

@@ -17,6 +17,7 @@ class PagesController < ApplicationController
     data['is_nav'] = boolean_param(data['is_nav'])
     @page = Page.new(data)
     if @page.save
+      log_activity("Created page: #{@page.title}", @page, "Slug: #{@page.slug}, Nav: #{@page.is_nav}")
       redirect_to '/dashboard/pages'
     else
       render 'cms/pages_form'
@@ -34,6 +35,7 @@ class PagesController < ApplicationController
     data['is_active'] = boolean_param(data['is_active'])
     data['is_nav'] = boolean_param(data['is_nav'])
     if @page.update(data)
+      log_activity("Updated page: #{@page.title}", @page, "New Data: #{data.reject{|k| k == 'content'}.to_json}")
       redirect_to '/dashboard/pages'
     else
       render 'cms/pages_form'
@@ -42,8 +44,10 @@ class PagesController < ApplicationController
 
   def destroy
     @page = Page[params['id']]
+    title = @page.title
     delete_all_images_from_content(@page.content) if @page.respond_to?(:content)
     @page.destroy
+    log_activity("Deleted page: #{title}")
     redirect_to '/dashboard/pages'
   end
 end

data/app/controllers/posts_controller.rb

@@ -16,6 +16,7 @@ class PostsController < ApplicationController
     data['is_active'] = boolean_param(data['is_active'])
     @post = Post.new(data)
     if @post.save
+      log_activity("Created post: #{@post.title}", @post, "Category: #{@post.category}")
       redirect_to '/dashboard/posts'
     else
       render 'cms/posts_form'
@@ -32,6 +33,7 @@ class PostsController < ApplicationController
     data = params['post']
     data['is_active'] = boolean_param(data['is_active'])
     if @post.update(data)
+      log_activity("Updated post: #{@post.title}", @post, "New Data: #{data.reject{|k| k == 'content'}.to_json}")
       redirect_to '/dashboard/posts'
     else
       render 'cms/posts_form'
@@ -40,9 +42,11 @@ class PostsController < ApplicationController
 
   def destroy
     @post = Post[params['id']]
+    title = @post.title
     delete_from_storage(@post.image_url) if @post.respond_to?(:image_url)
     delete_all_images_from_content(@post.content) if @post.respond_to?(:content)
     @post.destroy
+    log_activity("Deleted post: #{title}")
     redirect_to '/dashboard/posts'
   end
 end

data/app/middleware/maintenance_middleware.rb

@@ -0,0 +1,32 @@
+class MaintenanceMiddleware
+  def initialize(app)
+    @app = app
+  end
+
+  def call(env)
+    # Reload config to ensure instant mode change without server restart
+    config = JSON.parse(File.read(File.join(APP_ROOT, 'config', 'features.json'))) rescue (defined?(FEATURES_CONFIG) ? FEATURES_CONFIG : {})
+    
+    if config['maintenance']
+      path = env['PATH_INFO']
+      
+      # Allow access to login, static assets, and CMS dashboard (if admin)
+      # This allows admins to turn off maintenance mode via the dashboard
+      allowed_paths = ['/login', '/logout', '/images', '/css', '/js', '/favicon.ico']
+      is_allowed = allowed_paths.any? { |p| path.start_with?(p) }
+      
+      # Also allow if already logged in (admin access)
+      session = env['eks_cent.session'] || env['rack.session'] || {}
+      is_admin = session['user_id'] || session[:user_id]
+      
+      if !is_allowed && !is_admin
+        # Render maintenance page
+        res = EksCent::Response.new
+        res.render('maintenance', layout: false)
+        return [503, res.headers, res.body]
+      end
+    end
+
+    @app.call(env)
+  end
+end

data/app/models/activity_log.rb

@@ -0,0 +1,26 @@
+class ActivityLog < Sequel::Model
+  # Custom user lookup to support both SQL and Mongo users
+  def user
+    return @user if defined?(@user)
+    @user = User.find(id: self.user_id) rescue nil
+  end
+
+  def self.log(user_id, action, target = nil, details = nil)
+    log_entry = {
+      user_id: user_id.to_s,
+      action: action,
+      created_at: Time.now
+    }
+
+    if target
+      log_entry[:target_type] = target.class.name
+      log_entry[:target_id] = target.id.to_s rescue nil
+    end
+
+    if details
+      log_entry[:details] = details.is_a?(Hash) ? details.to_json : details.to_s
+    end
+
+    create(log_entry)
+  end
+end

data/app/models/user.rb

@@ -18,6 +18,11 @@ class User < Sequel::Model
   # Override find for Mongo support
   def self.find(params)
     if mongo?
+      # Map :id to :_id and handle ObjectId conversion
+      if params[:id]
+        id_val = params.delete(:id)
+        params[:_id] = BSON::ObjectId.from_string(id_val) rescue id_val
+      end
       doc = MONGO_CLIENT[:users].find(params).first
       return nil unless doc
       user = User.new

data/app/views/cms/activity_logs.erb

@@ -0,0 +1,177 @@
+<div class="glass-card">
+    <div class="card-header flex justify-between items-center">
+        <div>
+            <h2 class="card-title">Activity Logs (Audit Trail)</h2>
+            <p class="card-subtitle">Keep track of who did what in the CMS dashboard.</p>
+        </div>
+        <a href="/dashboard" class="btn-premium !py-2 !px-4 text-sm flex items-center gap-2">
+            <i class="fas fa-arrow-left"></i> Back to Dashboard
+        </a>
+    </div>
+
+    <div class="table-container">
+        <table class="premium-table">
+            <thead>
+                <tr>
+                    <th>Time</th>
+                    <th>User</th>
+                    <th>Action</th>
+                    <th>Target</th>
+                    <th>Details</th>
+                </tr>
+            </thead>
+            <tbody>
+                <% if @logs.any? %>
+                    <% @logs.each do |log| %>
+                        <tr>
+                            <td data-label="Time" class="text-sm opacity-70">
+                                <%= log.created_at.strftime('%Y-%m-%d %H:%M:%S') %>
+                            </td>
+                            <td data-label="User">
+                                <div class="flex items-center gap-2">
+                                    <div class="avatar-mini">
+                                        <%= log.user ? log.user.username[0].upcase : '?' %>
+                                    </div>
+                                    <span><%= log.user ? log.user.username : 'Unknown' %></span>
+                                </div>
+                            </td>
+                            <td data-label="Action">
+                                <span class="badge badge-primary">
+                                    <%= log.action %>
+                                </span>
+                            </td>
+                            <td data-label="Target">
+                                <% if log.target_type %>
+                                    <span class="text-xs opacity-60"><%= log.target_type %></span>
+                                    <code class="text-xs">#<%= log.target_id %></code>
+                                <% else %>
+                                    -
+                                <% end %>
+                            </td>
+                            <td data-label="Details" class="text-xs opacity-80 max-w-xs truncate">
+                                <%= log.details || '-' %>
+                            </td>
+                        </tr>
+                    <% end %>
+                <% else %>
+                    <tr>
+                        <td colspan="5" class="text-center py-8 opacity-50">
+                            No logs found yet.
+                        </td>
+                    </tr>
+                <% end %>
+            </tbody>
+        </table>
+    </div>
+</div>
+
+<style>
+    .avatar-mini {
+        width: 24px;
+        height: 24px;
+        background: var(--primary);
+        color: white;
+        border-radius: 50%;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        font-size: 0.7rem;
+        font-weight: 600;
+    }
+
+    .premium-table {
+        width: 100%;
+        border-collapse: collapse;
+    }
+
+    .premium-table th {
+        text-align: left;
+        padding: 1rem;
+        border-bottom: 1px solid rgba(255, 255, 255, 0.1);
+        font-size: 0.85rem;
+        text-transform: uppercase;
+        letter-spacing: 0.05em;
+        opacity: 0.7;
+    }
+
+    .premium-table td {
+        padding: 1rem;
+        border-bottom: 1px solid rgba(255, 255, 255, 0.05);
+        font-size: 0.9rem;
+    }
+
+    .premium-table tr:hover {
+        background: rgba(255, 255, 255, 0.02);
+    }
+
+    .badge {
+        padding: 0.2rem 0.6rem;
+        border-radius: 99px;
+        font-size: 0.75rem;
+        font-weight: 500;
+    }
+
+    .badge-primary {
+        background: rgba(99, 102, 241, 0.2);
+        color: #818cf8;
+        border: 1px solid rgba(99, 102, 241, 0.3);
+    }
+
+    .table-container {
+        overflow-x: auto;
+    }
+
+    /* Responsive adjustments */
+    @media (max-width: 768px) {
+        .card-header {
+            flex-direction: column;
+            align-items: flex-start !important;
+            gap: 1rem;
+        }
+
+        .premium-table thead {
+            display: none;
+        }
+
+        .premium-table tr {
+            display: block;
+            margin-bottom: 1.5rem;
+            background: rgba(255, 255, 255, 0.03);
+            border-radius: 12px;
+            padding: 0.5rem;
+            border: 1px solid rgba(255, 255, 255, 0.05);
+        }
+
+        .premium-table td {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            padding: 0.75rem 1rem;
+            border-bottom: 1px solid rgba(255, 255, 255, 0.03);
+            text-align: right;
+        }
+
+        .premium-table td:last-child {
+            border-bottom: none;
+        }
+
+        .premium-table td::before {
+            content: attr(data-label);
+            font-weight: 600;
+            font-size: 0.75rem;
+            text-transform: uppercase;
+            opacity: 0.5;
+            text-align: left;
+            margin-right: 1rem;
+        }
+
+        .premium-table td .flex {
+            justify-content: flex-end;
+        }
+        
+        .truncate {
+            white-space: normal;
+            max-width: 60%;
+        }
+    }
+</style>

data/app/views/dashboard.erb

@@ -35,6 +35,11 @@
                     <span class="font-semibold">Products</span>
                 </a>
             <% end %>
+            
+            <a href="/dashboard/logs" class="flex items-center gap-3 px-4 py-3 rounded-2xl transition-all duration-300 <%= @req.path.start_with?('/dashboard/logs') ? 'bg-primary text-white shadow-lg shadow-primary/30' : 'text-slate-500 hover:bg-white/5' %>">
+                <i class="fas fa-history w-5"></i>
+                <span class="font-semibold">Activity Logs</span>
+            </a>
 
             <div class="h-px bg-white/5 my-4"></div>
 

data/app/views/docs.erb

@@ -1,6 +1,6 @@
 <div class="space-y-12 pb-20">
     <div class="text-left">
-        <div class="badge-premium">Documentation v4.4.0</div>
+        <div class="badge-premium">Documentation v4.5.0</div>
         <h1 class="text-5xl font-black tracking-tighter mb-4 text-slate-700 dark:text-white">Framework <span class="text-primary">Guide</span></h1>
         <p class="text-xl text-slate-500 max-w-2xl leading-relaxed">Everything you need to know about building premium web applications with the One-For-All framework.</p>
     </div>
@@ -19,6 +19,7 @@
                 <a href="#api" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">API & Modern Web</a>
                 <a href="#advanced" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">Mailers & Background Jobs</a>
                 <a href="#testing" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">Automated Testing</a>
+                <a href="#plugins" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">Plugin System</a>
                 <a href="#deploy" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">Deployment</a>
             </nav>
         </aside>
@@ -115,6 +116,10 @@
                                  <td class="px-6 py-4 font-mono text-primary">./ofa g test NAME</td>
                                  <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Generates a Minitest unit test file.</td>
                              </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g plugin NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Scaffolds a new plugin structure in <code>/plugins</code>.</td>
+                             </tr>
 
                             <tr class="bg-slate-500/5"><td colspan="2" class="px-6 py-2 text-[10px] font-black uppercase tracking-tighter text-slate-400">Customization</td></tr>
                             <tr>
@@ -303,6 +308,26 @@ resources :posts
                         <li>• <strong>Image Handling:</strong> Drag-and-drop images directly into the editor with auto-storage sync.</li>
                         <li>• <strong>Code Blocks:</strong> Native support for code blocks with one-click "Copy" functionality.</li>
                     </ul>
+
+                    <h4 class="font-bold text-lg mt-8 mb-4">🔍 Activity Logs (Audit Trail)</h4>
+                    <p class="text-sm text-slate-500 mb-4">Track every action taken by users in the CMS. Automatically logs creation, updates, and deletions of pages and posts.</p>
+                    <ul class="text-xs space-y-2 text-slate-600 dark:text-slate-400">
+                        <li>• <strong>User Identification:</strong> Logs include the username and avatar of the person who performed the action.</li>
+                        <li>• <strong>Detailed Context:</strong> Records specific changes, such as new slugs or modified categories.</li>
+                        <li>• <strong>Database Agnostic:</strong> Works seamlessly with both SQL and MongoDB storage.</li>
+                    </ul>
+
+                    <h4 class="font-bold text-lg mt-8 mb-4">🚧 Maintenance Mode</h4>
+                    <p class="text-sm text-slate-500 mb-4">Instantly activate a professional "Under Construction" page for your visitors using the CLI. Perfect for updates or migrations.</p>
+                    <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mb-4 font-mono text-sm">
+                        ./ofa maintenance on<br>
+                        ./ofa maintenance off
+                    </div>
+                    <ul class="text-xs space-y-2 text-slate-600 dark:text-slate-400">
+                        <li>• <strong>Admin Bypass:</strong> Logged-in administrators can still view and manage the site while maintenance is active.</li>
+                        <li>• <strong>Premium Design:</strong> Features a high-quality Glassmorphism roket animation to keep your brand looking professional even when offline.</li>
+                        <li>• <strong>Dynamic Updates:</strong> Changes take effect instantly without requiring a server restart.</li>
+                    </ul>
                 </div>
             </section>
 
@@ -405,6 +430,33 @@ resources :posts
                 </div>
             </section>
 
+            <!-- Plugin System -->
+            <section id="plugins" class="glass-panel p-8 md:p-12 text-left bg-gradient-to-br from-primary/10 to-transparent">
+                <h2 class="text-3xl font-black tracking-tight mb-6 flex items-center gap-3">
+                    <i class="fas fa-plug text-primary"></i> Plugin System
+                </h2>
+                <div class="markdown-content">
+                    <p>OFA v4.5.0 introduces a powerful <strong>Plugin System</strong> that allows you to extend the framework without modifying the core files. Plugins are located in the <code>/plugins</code> directory.</p>
+                    
+                    <h4 class="font-bold text-lg mt-8 mb-4">🛠️ Working with Plugins</h4>
+                    <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mb-4 font-mono text-sm">
+                        ./ofa g plugin my_awesome_feature
+                    </div>
+                    <p class="text-sm text-slate-500 mb-4">Each plugin has an <code>init.rb</code> file where you can register hooks and routes:</p>
+                    <div class="p-4 bg-slate-900 rounded-2xl font-mono text-xs text-green-400 mb-6">
+<pre>
+OFA.on_boot do
+  puts "Plugin Loaded!"
+end
+
+OFA.add_route(:get, "/my-plugin") do |req, res|
+  res.body << "Hello from Plugin!"
+end
+</pre>
+                    </div>
+                </div>
+            </section>
+
             <!-- Deployment -->
             <section id="deploy" class="glass-panel p-8 md:p-12 text-left border-primary/20">
                 <h2 class="text-3xl font-black tracking-tight mb-6 flex items-center gap-3">

data/app/views/index.erb

@@ -1,6 +1,6 @@
 <div class="text-center space-y-6 max-w-2xl mx-auto py-12">
     <div class="inline-flex items-center px-4 py-1.5 rounded-full bg-primary/10 border border-primary/20 text-primary text-xs font-bold uppercase tracking-wider animate-pulse">
-        Framework Version 4.4.0
+        Framework Version 4.5.0
     </div>
     
     <h1 class="text-5xl md:text-7xl font-black tracking-tight leading-tight">

data/app/views/maintenance.erb

@@ -0,0 +1,143 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Under Construction | One-For-All</title>
+    <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;600&display=swap" rel="stylesheet">
+    <style>
+        :root {
+            --primary: #6366f1;
+            --primary-glow: rgba(99, 102, 241, 0.5);
+            --bg: #0f172a;
+            --glass: rgba(255, 255, 255, 0.05);
+            --glass-border: rgba(255, 255, 255, 0.1);
+        }
+
+        * {
+            margin: 0;
+            padding: 0;
+            box-sizing: border-box;
+            font-family: 'Outfit', sans-serif;
+        }
+
+        body {
+            background: var(--bg);
+            color: white;
+            height: 100vh;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            overflow: hidden;
+            background-image: 
+                radial-gradient(circle at 20% 20%, rgba(99, 102, 241, 0.15) 0%, transparent 40%),
+                radial-gradient(circle at 80% 80%, rgba(236, 72, 153, 0.15) 0%, transparent 40%);
+        }
+
+        .container {
+            text-align: center;
+            padding: 3rem;
+            background: var(--glass);
+            backdrop-filter: blur(20px);
+            border: 1px solid var(--glass-border);
+            border-radius: 2rem;
+            box-shadow: 0 25px 50px -12px rgba(0, 0, 0, 0.5);
+            max-width: 600px;
+            width: 90%;
+            animation: fadeIn 1s ease-out;
+        }
+
+        @keyframes fadeIn {
+            from { opacity: 0; transform: translateY(20px); }
+            to { opacity: 1; transform: translateY(0); }
+        }
+
+        .icon {
+            font-size: 5rem;
+            margin-bottom: 1.5rem;
+            display: inline-block;
+            animation: float 3s ease-in-out infinite;
+        }
+
+        @keyframes float {
+            0%, 100% { transform: translateY(0); }
+            50% { transform: translateY(-10px); }
+        }
+
+        h1 {
+            font-size: 2.5rem;
+            font-weight: 600;
+            margin-bottom: 1rem;
+            background: linear-gradient(to right, #818cf8, #f472b6);
+            -webkit-background-clip: text;
+            -webkit-text-fill-color: transparent;
+        }
+
+        p {
+            font-size: 1.1rem;
+            color: #94a3b8;
+            line-height: 1.6;
+            margin-bottom: 2rem;
+        }
+
+        .loader {
+            width: 100%;
+            height: 4px;
+            background: rgba(255, 255, 255, 0.1);
+            border-radius: 2px;
+            overflow: hidden;
+            margin-bottom: 2rem;
+        }
+
+        .loader-bar {
+            width: 40%;
+            height: 100%;
+            background: var(--primary);
+            box-shadow: 0 0 15px var(--primary-glow);
+            border-radius: 2px;
+            animation: loading 2s infinite ease-in-out;
+        }
+
+        @keyframes loading {
+            0% { transform: translateX(-100%); }
+            100% { transform: translateX(300%); }
+        }
+
+        .footer {
+            font-size: 0.9rem;
+            color: #64748b;
+        }
+
+        .admin-link {
+            margin-top: 2rem;
+            display: block;
+            color: var(--primary);
+            text-decoration: none;
+            font-weight: 500;
+            opacity: 0.5;
+            transition: opacity 0.3s;
+        }
+
+        .admin-link:hover {
+            opacity: 1;
+        }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="icon">🚀</div>
+        <h1>Under Construction</h1>
+        <p>We're working hard to bring you something amazing. Our site is currently undergoing scheduled maintenance. Please check back soon!</p>
+        
+        <div class="loader">
+            <div class="loader-bar"></div>
+        </div>
+
+        <div class="footer">
+            &copy; <%= Time.now.year %> One-For-All Framework. All rights reserved.
+        </div>
+
+        <a href="/login" class="admin-link">Admin Login</a>
+    </div>
+</body>
+</html>

data/bin/ofa

@@ -33,7 +33,7 @@ def help
   puts "  / __ \\/ ____/  /   |                      "
   puts " / / / / /_     / /| |  Framework           "
   puts "/ /_/ / __/    / ___ |  Premium MVC         "
-  puts "\\____/_/      /_/  |_|  v4.4.0              "
+  puts "\\____/_/      /_/  |_|  v4.5.0              "
   puts "                                            "
   puts "✨ One-For-All Framework CLI ✨"
   puts "-----------------------------"
@@ -61,6 +61,7 @@ def help
   puts "  ofa doctor            - Check system health (DB, config, gems)"
   puts "  ofa routes            - List all registered routes"
   puts "  ofa swagger           - Auto-generate OpenAPI/Swagger documentation"
+  puts "  ofa maintenance ACTION - Toggle maintenance mode (on/off)"
   puts "  ofa task NAME         - Run a background task"
   puts "  ofa test              - Run all application tests"
   puts "  ofa run               - Start the application server"
@@ -247,7 +248,7 @@ when 'init'
   puts "  / __ \\/ ____/  /   |                      "
   puts " / / / / /_     / /| |  Framework           "
   puts "/ /_/ / __/    / ___ |  Premium MVC         "
-  puts "\\____/_/      /_/  |_|  v4.4.0              "
+  puts "\\____/_/      /_/  |_|  v4.5.0              "
   puts "                                            "
   puts "Initializing One-For-All project as '#{app_type}' in #{PROJECT_ROOT}..."
 
@@ -327,12 +328,16 @@ when 'init'
     # Middleware setup
     use EksCent::Middleware::ShowExceptions
     use EksCent::Middleware::Session, secret: EksCent.secret_key_base
+    use MaintenanceMiddleware
     use AuthMiddleware
     use JwtMiddleware
     use CSRFMiddleware
     use EksCent::Middleware::Static, root: 'public'
     use EksCent::Middleware::Logger
     
+    # Apply plugin routes
+    OFA.apply_pending_routes(ROUTES) if defined?(OFA)
+    
     run ROUTES
   RUBY
   File.write(File.join(PROJECT_ROOT, 'config.ru'), config_ru_content)
@@ -619,8 +624,28 @@ when 'g'
     content = "<h1>#{name}</h1>\n<p>Author: #{options[:author] || 'Admin'}</p>\n<p>Category: #{options[:category] || 'General'}</p>"
     File.write(file_name, content)
     puts "Created post: #{file_name}"
+  elsif sub == 'plugin' && name
+    dir_path = File.join(PROJECT_ROOT, "plugins/#{name.downcase}")
+    FileUtils.mkdir_p(dir_path)
+    file_name = File.join(dir_path, "init.rb")
+    content = <<~RUBY
+      # Plugin: #{name.capitalize}
+      # Created at: #{Time.now}
+
+      OFA.on_boot do
+        puts "🚀 Plugin #{name.capitalize} loaded!"
+      end
+
+      # Example route added by plugin
+      # OFA.add_route(:get, '/#{name.downcase}') do |req, res|
+      #   res.body << "Hello from #{name.capitalize} Plugin!"
+      # end
+    RUBY
+    File.write(file_name, content)
+    puts "Created Plugin: #{dir_path}"
+    puts "💡 Edit #{file_name} to start building your plugin."
   else
-    puts "Usage: ofa g [controller|api|model|migration|mailer|task|test|post] NAME"
+    puts "Usage: ofa g [controller|api|model|migration|mailer|task|test|post|plugin] NAME"
   end
 
 when 'feature'
@@ -681,6 +706,19 @@ when 'storage'
   File.write(config_path, JSON.pretty_generate(config))
   puts "Application storage set to '#{name}'."
 
+when 'maintenance'
+  ensure_initialized!
+  action = ARGV.shift
+  unless %w[on off].include?(action)
+    puts "Usage: ofa maintenance [on|off]"
+    exit 1
+  end
+  config_path = File.join(PROJECT_ROOT, 'config', 'features.json')
+  config = JSON.parse(File.read(config_path))
+  config['maintenance'] = (action == 'on')
+  File.write(config_path, JSON.pretty_generate(config))
+  puts "Maintenance mode has been turned #{action}."
+
 when 'reset-password'
   ENV['SKIP_MODELS'] = '1'
   Object.const_set(:APP_ROOT, PROJECT_ROOT) unless defined?(APP_ROOT)
@@ -823,7 +861,7 @@ when 'console'
   puts "  / __ \\/ ____/  /   |                      "
   puts " / / / / /_     / /| |  Framework           "
   puts "/ /_/ / __/    / ___ |  Console (REPL)      "
-  puts "\\____/_/      /_/  |_|  v4.4.0              "
+  puts "\\____/_/      /_/  |_|  v4.5.0              "
   puts "                                            "
   puts "✨ Loading environment... (Type 'exit' to quit)"
   

data/config/boot.rb

@@ -9,6 +9,8 @@ begin
 rescue LoadError
 end
 
+require_relative '../lib/plugin_helper'
+
 # Basic project structure constants
 APP_ROOT ||= File.expand_path('..', __dir__)
 
@@ -110,6 +112,14 @@ framework_app = File.expand_path('../app', __dir__)
   end
 end
 
+# Load Plugins
+plugins_dir = File.join(APP_ROOT, 'plugins')
+if File.directory?(plugins_dir)
+  Dir.glob(File.join(plugins_dir, '**', '*.rb')).each do |plugin_file|
+    require plugin_file
+  end
+end
+
 # ─── Routes DSL Extensions ─────────────────────────────────────────────────────
 # Extends EksCent::Router with a `resources` helper that auto-generates RESTful
 # routes (index, show, new, create, edit, update, destroy) for a given resource.
@@ -151,3 +161,6 @@ end
 
 # Load routes
 require_relative 'routes'
+
+# Run Plugin Boot Hooks
+OFA.run_boot_hooks if defined?(OFA)

data/config/database.rb

@@ -130,6 +130,18 @@ if DB
     end
   end
 
+  unless DB.table_exists?(:activity_logs)
+    DB.create_table :activity_logs do
+      primary_key :id
+      String :user_id
+      String :action, null: false
+      String :target_type
+      String :target_id
+      Text :details
+      DateTime :created_at, default: Sequel::CURRENT_TIMESTAMP
+    end
+  end
+
   # Quick Migration for existing tables
   if DB.table_exists?(:pages)
     DB.alter_table(:pages) { add_column :is_active, TrueClass, default: true unless DB[:pages].columns.include?(:is_active) }

data/config/features.json

@@ -4,5 +4,6 @@
   "type": "landing_page",
   "theme": "light_sidebar",
   "storage": "cloudinary",
-  "rich_text": true
+  "rich_text": true,
+  "maintenance": false
 }

data/config/routes.rb

@@ -61,6 +61,10 @@ ROUTES = EksCent::Router.new do
       DashboardController.new(req, res).upload
     end
 
+    get '/dashboard/logs' do |req, res|
+      ActivityLogsController.new(req, res).index
+    end
+
     # Resourceful CMS Routes
     resources :pages, prefix: '/dashboard'
     resources :posts, prefix: '/dashboard'

data/config.ru

@@ -3,9 +3,13 @@ require_relative 'config/boot'
 # Middleware setup
 use EksCent::Middleware::ShowExceptions
 use EksCent::Middleware::Session, secret: EksCent.secret_key_base
+use MaintenanceMiddleware
 use AuthMiddleware
 use CSRFMiddleware
 use EksCent::Middleware::Static, root: 'public'
 use EksCent::Middleware::Logger
 
+# Apply plugin routes
+OFA.apply_pending_routes(ROUTES) if defined?(OFA)
+
 run ROUTES

data/db/migrations/20260502000000_create_products.rb

@@ -1,6 +1,6 @@
 Sequel.migration do
   change do
-    create_table(:products) do
+    create_table?(:products) do
       primary_key :id
       String :name, null: false
       String :slug, null: false, unique: true

data/db/migrations/20260507000000_create_activity_logs.rb

@@ -0,0 +1,13 @@
+Sequel.migration do
+  change do
+    create_table(:activity_logs) do
+      primary_key :id
+      String :user_id
+      String :action, null: false
+      String :target_type
+      String :target_id
+      Text :details
+      DateTime :created_at, default: Sequel::CURRENT_TIMESTAMP
+    end
+  end
+end

data/db/migrations/20260507000001_fix_activity_logs_user_id.rb

@@ -0,0 +1,7 @@
+Sequel.migration do
+  change do
+    alter_table(:activity_logs) do
+      set_column_type :user_id, String
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: one-for-all-framework
 version: !ruby/object:Gem::Version
-  version: 4.4.0
+  version: 4.5.0
 platform: ruby
 authors:
 - Ishikawa Uta
@@ -200,6 +200,7 @@ files:
 - LICENSE
 - Procfile
 - README.md
+- app/controllers/activity_logs_controller.rb
 - app/controllers/api_controller.rb
 - app/controllers/application_controller.rb
 - app/controllers/auth_controller.rb
@@ -214,6 +215,8 @@ files:
 - app/middleware/auth_middleware.rb
 - app/middleware/csrf_middleware.rb
 - app/middleware/jwt_middleware.rb
+- app/middleware/maintenance_middleware.rb
+- app/models/activity_log.rb
 - app/models/page.rb
 - app/models/post.rb
 - app/models/product.rb
@@ -221,6 +224,7 @@ files:
 - app/models/user.rb
 - app/views/blog_home.erb
 - app/views/cart_index.erb
+- app/views/cms/activity_logs.erb
 - app/views/cms/pages_form.erb
 - app/views/cms/pages_index.erb
 - app/views/cms/posts_form.erb
@@ -235,6 +239,7 @@ files:
 - app/views/index.erb
 - app/views/layout.erb
 - app/views/login.erb
+- app/views/maintenance.erb
 - app/views/page.erb
 - app/views/portfolio.erb
 - app/views/post.erb
@@ -255,6 +260,8 @@ files:
 - db/data.sqlite3
 - db/development.sqlite3
 - db/migrations/20260502000000_create_products.rb
+- db/migrations/20260507000000_create_activity_logs.rb
+- db/migrations/20260507000001_fix_activity_logs_user_id.rb
 - ofa
 - public/css/cms.css
 - public/images/logo.jpg