one-for-all-framework 4.3.0 → 4.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd84838fc3bc3f5241aa3d3a701accc2f9bfe8b6bf7303d708319e14ea68fe17
-  data.tar.gz: 5cce2c8ac4cfbc1586f12c5551eec509ef0536a189d7fa901d53dbb7a2d2f25d
+  metadata.gz: d724d07382e25a25fc566c6c889497bcabca8ef5536f86c13d9337f48507ef74
+  data.tar.gz: d7322c62e8380e22f17773b3202a7574859db716289706591db041205df38b61
 SHA512:
-  metadata.gz: 4ded6af832ba7cb08647f002f871cebf223057733142d8ac21c241d43fc0a96058e1439f3946195c0b231174e07293de69b08011bf2603cdfa9ddadab4bc93b4
-  data.tar.gz: 43a940c1c4288fbf4b273937bc5725c4418736cc88c525db71b494b4cd45b74b642220cf1fb1ce13766dbed1428653bf6907a1c27be1b2c6cd2fdd376889d18c
+  metadata.gz: 896e3107819354a1e335519e4a4ec8f6934bdab41ea7f2e99558bed67ede658295b1be2aeead6d50608d5a9c3b51603e71d1754837f6c45cd93b43580a5b1a72
+  data.tar.gz: 7d9f02100feb5a46ee909932672c03443e585ba7fd6641d05d84006f3de780f5de85e56e381a84c0b4337fc6c59a5e9ea621f5281c112f8093be3063d19c3360

data/.env.example

@@ -2,3 +2,8 @@ DATABASE_URL="sqlite://db/development.sqlite3"
 CLOUDINARY_URL="cloudinary://API_KEY:API_SECRET@CLOUD_NAME"
 EKS_CENT_SECRET_KEY_BASE="your_secret_key"
 EKS_ENV="development"
+MAILER_FROM="admin@example.com"
+SMTP_ADDRESS="smtp.gmail.com"
+SMTP_PORT=587
+SMTP_USER_NAME="your_email@gmail.com"
+SMTP_PASSWORD="your_app_password"

data/Gemfile

@@ -13,6 +13,8 @@ gem 'mongo'
 gem 'dotenv'
 gem 'kramdown'
 gem 'kramdown-parser-gfm'
+gem 'mail'
+gem 'minitest'
 
 group :test do
   gem 'eksa-mination'

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.3.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
@@ -141,6 +148,9 @@ Securely manages admin credentials.
 | `ofa doctor` | **System Health Check.** Validates `.env` config, database connectivity (SQL/MongoDB), Ruby version, and dependencies. |
 | `ofa routes` | **Route Inspection.** Lists all registered routes in your application in a clean tabular format. |
 | `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). |
 
 ---
@@ -154,6 +164,10 @@ Automate the creation of boilerplate code with the generator command.
 | `ofa g api NAME` | Creates a JSON-based controller in `app/controllers/{name}_controller.rb` inheriting from `ApiController`. |
 | `ofa g model NAME` | Generates a database model in `app/models/{name}.rb` integrated with the Sequel ORM. |
 | `ofa g migration NAME` | Creates a timestamped migration file in `db/migrations/`. Use this to define your schema changes. |
+| `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/mailers/application_mailer.rb

@@ -0,0 +1,42 @@
+require 'mail'
+require 'erb'
+
+class ApplicationMailer
+  # Configure default settings if needed
+  def self.mail(to:, subject:, template:, locals: {})
+    # Template name expected: "welcome_mailer/welcome"
+    template_path = File.join(APP_ROOT, 'app', 'views', 'mailers', "#{template}.erb")
+    
+    unless File.exist?(template_path)
+      puts "❌ Mailer Error: Template not found at #{template_path}"
+      return
+    end
+
+    # Create rendering context
+    context = Object.new
+    locals.each { |k, v| context.instance_variable_set("@#{k}", v) }
+    
+    body_content = ERB.new(File.read(template_path)).result(context.instance_eval { binding })
+
+    mail = Mail.new do
+      from    ENV['MAILER_FROM'] || 'admin@example.com'
+      to      to
+      subject subject
+      body    body_content
+      
+      # Optional: set content type to HTML if needed
+      # content_type 'text/html; charset=UTF-8'
+    end
+
+    # In development/test, we might want to just log it
+    if ENV['EKS_ENV'] == 'production'
+      mail.deliver!
+    else
+      puts "--- 📧 EMAIL SENT ---"
+      puts "To:      #{to}"
+      puts "Subject: #{subject}"
+      puts "Body:\n#{body_content}"
+      puts "----------------------"
+    end
+  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.3.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>
@@ -17,7 +17,9 @@
                 <a href="#cms" 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">CMS & Features</a>
                 <a href="#ecommerce" 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">E-Commerce</a>
                 <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="#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>
+                <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>
@@ -98,10 +100,26 @@
                                 <td class="px-6 py-4 font-mono text-primary">./ofa g model NAME</td>
                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400">Creates model & migration linked to Sequel/NoSQL.</td>
                             </tr>
-                            <tr>
-                                <td class="px-6 py-4 font-mono text-primary">./ofa g migration NAME</td>
-                                <td class="px-6 py-4 text-slate-600 dark:text-slate-400">Creates timestamped migration in <code>db/migrations/</code>.</td>
-                            </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g migration NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Creates timestamped migration in <code>db/migrations/</code>.</td>
+                             </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g mailer NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Generates mailer class and ERB templates.</td>
+                             </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g task NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Creates a background task in <code>lib/tasks/</code>.</td>
+                             </tr>
+                             <tr>
+                                 <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>
@@ -290,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>
 
@@ -350,6 +388,75 @@ resources :posts
                 </div>
             </section>
 
+            <!-- Advanced Features -->
+            <section id="advanced" 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-envelope text-primary"></i> Mailers & Tasks
+                </h2>
+                <div class="markdown-content space-y-8">
+                    <div>
+                        <h4 class="font-bold text-lg mb-2">📧 Email Mailers</h4>
+                        <p class="text-sm text-slate-600 dark:text-slate-400">Send transactional emails with ease using ERB templates. Mailers are stored in <code>app/mailers</code> and templates in <code>app/views/mailers</code>.</p>
+                        <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mt-4 font-mono text-sm">
+                            ./ofa g mailer welcome signup
+                        </div>
+                    </div>
+
+                    <div>
+                        <h4 class="font-bold text-lg mb-2">⚙️ Background Tasks</h4>
+                        <p class="text-sm text-slate-600 dark:text-slate-400">Run long-running processes or scheduled jobs using the Task runner. Defined in <code>lib/tasks/</code>.</p>
+                        <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mt-4 font-mono text-sm">
+                            ./ofa g task sync_data<br>
+                            ./ofa task sync_data
+                        </div>
+                    </div>
+                </div>
+            </section>
+
+            <!-- Testing -->
+            <section id="testing" class="glass-panel p-8 md:p-12 text-left">
+                <h2 class="text-3xl font-black tracking-tight mb-6 flex items-center gap-3">
+                    <i class="fas fa-vial text-primary"></i> Automated Testing
+                </h2>
+                <div class="markdown-content">
+                    <p class="text-slate-600 dark:text-slate-400 mb-6">OFA integrates <strong>Minitest</strong> out-of-the-box for reliable application testing. Run all your tests with a single command.</p>
+                    <div class="p-4 bg-slate-900 rounded-2xl font-mono text-sm text-green-400 mb-6">
+                        ./ofa test
+                    </div>
+                    <p class="text-sm text-slate-500">To create a new test file:</p>
+                    <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mt-2 font-mono text-sm">
+                        ./ofa g test user_profile
+                    </div>
+                </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.3.0
+        Framework Version 4.5.0
     </div>
     
     <h1 class="text-5xl md:text-7xl font-black tracking-tight leading-tight">