omnitrack-rb 2.0.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: aa0f487b57d4c47c6a3168bb0b2583982926b1361f30d95a4d349f3a3bae9834
-  data.tar.gz: 2c5c0967326204f7e9e83f5e43b80c05ee97b1ea414af87ada2fb785b11d2211
+  metadata.gz: ff7c5f93aedbb1f18f5b24a083661516212f52c8973b2b464ddef8667701de31
+  data.tar.gz: dfb4173d07da82b896221c87f3c107b1061eea2d1183d5da16787c5420924235
 SHA512:
-  metadata.gz: a27d997c0372cb36c36c4c84816739c66ddf886b6953985ebb27f940fb6f2babf5f2111e8d36555aae09e90c8a10138478d0ba6fc0eca79c11dbc6476c2234fa
-  data.tar.gz: c1bb1d889f61bfdd656ab0ede5b7d2ccc7b432fcf4b7db335c63789d709736caa8dd3cb1d8fe614ec5c7214e46fe28c8cc85ba306fb0cef69b82c48c9ca9db60
+  metadata.gz: 40b53c4312d9986943c0dd6b174b061070731f9a083e3cfd12c171692a6bc11630a68e89a7f013fd8c411dc47e31c3c047f88c8710bf959b5f68870b5c63ff9f
+  data.tar.gz: fbb0e26662fd43e79a9d87d7d6e18b9716681ae232c564deec84b4e0adf64f2a4718c5274a85ac30b956329cf850178b090364bfe62d92eb28d47e6b2553e451

data/.env.example

@@ -41,3 +41,9 @@ TIKTOK_ACCESS_TOKEN=
 SNAPCHAT_ENABLED=false
 SNAPCHAT_PIXEL_ID=
 SNAPCHAT_ACCESS_TOKEN=
+
+# ---------------------------------------------------------------------------
+# OmniTrack Admin Dashboard
+# ---------------------------------------------------------------------------
+OMNITRACK_ADMIN_USERNAME=admin
+OMNITRACK_ADMIN_PASSWORD=change-me

data/AI_GEM_SETUP.md

@@ -57,6 +57,13 @@ rails generate omnitrack:install
 This creates:
 
 - `config/initializers/omnitrack.rb`
+- `db/migrate/*_create_omnitrack_dashboard_tables.rb`
+
+Then run:
+
+```bash
+rails db:migrate
+```
 
 **Boot check (must succeed):**
 
@@ -167,6 +174,7 @@ Until `Omnitrack::Jobs::TrackingJob` and ActiveJob are loaded, the gem runs sync
 |------|--------|
 | `Gemfile` | `gem "omnitrack-rb"` (and `dotenv-rails` if using `.env`) |
 | `config/initializers/omnitrack.rb` | `Omnitrack.configure` |
+| `db/migrate/*_create_omnitrack_dashboard_tables.rb` | Dashboard history tables migration |
 | `.env.example` | Document variable names (no secrets) — optional if committed |
 | `.env` | Local secrets — **gitignored** |
 | `app/views/layouts/...` | `<%= omnitrack_tags %>` for full-stack |

data/README.md

@@ -323,6 +323,47 @@ config.active_job.queue_adapter = :sidekiq
 
 ---
 
+## Admin Dashboard (Full Visitor History)
+
+OmniTrack now includes a dashboard UI at:
+
+`/omnitrack/login` (default mount path)
+
+Features:
+
+- Admin login (username/password)
+- Full visitor lifecycle history (from first request through dispatch)
+- Per-platform delivery status (`success`, `failure`, `queued`, etc.)
+- Event detail page with payload + context snapshots
+- Pagination
+- Arabic/English toggle
+
+Setup:
+
+1. Run installer and migration:
+
+```bash
+rails generate omnitrack:install
+rails db:migrate
+```
+
+2. Set dashboard credentials in ENV:
+
+```bash
+OMNITRACK_ADMIN_USERNAME=admin
+OMNITRACK_ADMIN_PASSWORD=change-me
+```
+
+3. Optional initializer settings:
+
+```ruby
+config.dashboard_enabled  = true
+config.dashboard_per_page = 25
+config.dashboard_mount_path = "/omnitrack" # change per host app if needed
+```
+
+---
+
 ## Middleware
 
 `Omnitrack::Middleware::RequestTracker` is automatically inserted into your Rack stack. It:

data/app/controllers/omnitrack/application_controller.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Omnitrack
+  class ApplicationController < ActionController::Base
+    layout "omnitrack/admin"
+
+    before_action :set_locale
+    before_action :require_admin_authentication
+
+    private
+
+    def require_admin_authentication
+      return if session[:omnitrack_admin_authenticated]
+
+      redirect_to login_path(locale: I18n.locale), alert: t("omnitrack.auth.login_required")
+    end
+
+    def set_locale
+      requested_locale = params[:locale].presence
+      locale = requested_locale&.to_sym
+      I18n.locale = I18n.available_locales.include?(locale) ? locale : I18n.default_locale
+    end
+  end
+end

data/app/controllers/omnitrack/path/application_controller.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Omnitrack
+  module Path
+    class ApplicationController < ::Omnitrack::ApplicationController
+      private
+
+      def require_admin_authentication
+        return if session[:omnitrack_admin_authenticated]
+
+        redirect_to login_path(locale: I18n.locale), alert: t("omnitrack.auth.login_required")
+      end
+    end
+  end
+end

data/app/controllers/omnitrack/path/sessions_controller.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "digest"
+
+module Omnitrack
+  module Path
+    class SessionsController < ApplicationController
+      skip_before_action :require_admin_authentication, only: %i[new create]
+
+      def new; end
+
+      def create
+        if valid_credentials?
+          session[:omnitrack_admin_authenticated] = true
+          redirect_to visit_events_path(locale: I18n.locale), notice: t("omnitrack.auth.login_success")
+        else
+          flash.now[:alert] = t("omnitrack.auth.login_failed")
+          render :new, status: :unprocessable_entity
+        end
+      end
+
+      def destroy
+        session.delete(:omnitrack_admin_authenticated)
+        redirect_to login_path(locale: I18n.locale), notice: t("omnitrack.auth.logout_success")
+      end
+
+      private
+
+      def valid_credentials?
+        secure_compare(params[:username].to_s, Omnitrack.config.admin_username.to_s) &&
+          secure_compare(params[:password].to_s, Omnitrack.config.admin_password.to_s)
+      end
+
+      def secure_compare(value, expected)
+        ActiveSupport::SecurityUtils.secure_compare(Digest::SHA256.hexdigest(value), Digest::SHA256.hexdigest(expected))
+      end
+    end
+  end
+end

data/app/controllers/omnitrack/path/visit_events_controller.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Omnitrack
+  module Path
+    class VisitEventsController < ApplicationController
+      def index
+        @page = [params.fetch(:page, 1).to_i, 1].max
+        @per_page = Omnitrack.config.dashboard_per_page.to_i
+
+        scoped = Omnitrack::VisitEvent.recent_first
+        @total_count = scoped.count
+        @total_pages = (@total_count.to_f / @per_page).ceil
+        @events = scoped.includes(:delivery_statuses).offset((@page - 1) * @per_page).limit(@per_page)
+      end
+
+      def show
+        @event = Omnitrack::VisitEvent.includes(:delivery_statuses).find(params[:id])
+      end
+    end
+  end
+end

data/app/controllers/omnitrack/sessions_controller.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "digest"
+
+module Omnitrack
+  class SessionsController < ApplicationController
+    skip_before_action :require_admin_authentication, only: %i[new create]
+
+    def new; end
+
+    def create
+      if valid_credentials?
+        session[:omnitrack_admin_authenticated] = true
+        redirect_to visit_events_path(locale: I18n.locale), notice: t("omnitrack.auth.login_success")
+      else
+        flash.now[:alert] = t("omnitrack.auth.login_failed")
+        render :new, status: :unprocessable_entity
+      end
+    end
+
+    def destroy
+      session.delete(:omnitrack_admin_authenticated)
+      redirect_to login_path(locale: I18n.locale), notice: t("omnitrack.auth.logout_success")
+    end
+
+    private
+
+    def valid_credentials?
+      secure_compare(params[:username].to_s, Omnitrack.config.admin_username.to_s) &&
+        secure_compare(params[:password].to_s, Omnitrack.config.admin_password.to_s)
+    end
+
+    def secure_compare(value, expected)
+      ActiveSupport::SecurityUtils.secure_compare(Digest::SHA256.hexdigest(value), Digest::SHA256.hexdigest(expected))
+    end
+  end
+end

data/app/controllers/omnitrack/visit_events_controller.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Omnitrack
+  class VisitEventsController < ApplicationController
+    def index
+      @page = [params.fetch(:page, 1).to_i, 1].max
+      @per_page = Omnitrack.config.dashboard_per_page.to_i
+
+      scoped = Omnitrack::VisitEvent.recent_first
+      @total_count = scoped.count
+      @total_pages = (@total_count.to_f / @per_page).ceil
+      @events = scoped.includes(:delivery_statuses).offset((@page - 1) * @per_page).limit(@per_page)
+    end
+
+    def show
+      @event = Omnitrack::VisitEvent.includes(:delivery_statuses).find(params[:id])
+    end
+  end
+end

data/app/models/omnitrack/application_record.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Omnitrack
+  class ApplicationRecord < ActiveRecord::Base
+    self.abstract_class = true
+  end
+end

data/app/models/omnitrack/delivery_status.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Omnitrack
+  class DeliveryStatus < ApplicationRecord
+    self.table_name = "omnitrack_delivery_statuses"
+
+    belongs_to :visit_event,
+               class_name: "Omnitrack::VisitEvent",
+               foreign_key: :visit_event_id,
+               inverse_of: :delivery_statuses
+  end
+end

data/app/models/omnitrack/visit_event.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Omnitrack
+  class VisitEvent < ApplicationRecord
+    self.table_name = "omnitrack_visit_events"
+
+    has_many :delivery_statuses,
+             class_name: "Omnitrack::DeliveryStatus",
+             foreign_key: :visit_event_id,
+             inverse_of: :visit_event,
+             dependent: :delete_all
+
+    scope :recent_first, -> { order(started_at: :desc) }
+  end
+end

data/app/views/layouts/omnitrack/admin.html.erb

@@ -0,0 +1,55 @@
+<!DOCTYPE html>
+<html lang="<%= I18n.locale %>" dir="<%= I18n.locale.to_s == 'ar' ? 'rtl' : 'ltr' %>">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width,initial-scale=1">
+  <title><%= t("omnitrack.ui.title") %></title>
+  <style>
+    :root { --bg:#0f172a; --card:#111827; --text:#f3f4f6; --muted:#9ca3af; --ok:#22c55e; --bad:#ef4444; --warn:#f59e0b; --line:#374151; }
+    body { margin:0; background:var(--bg); color:var(--text); font-family: Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif; }
+    .shell { max-width: 1200px; margin: 0 auto; padding: 24px; }
+    .top { display:flex; justify-content:space-between; align-items:center; gap:12px; margin-bottom:20px; }
+    .brand { font-size: 20px; font-weight: 700; }
+    .card { background:var(--card); border:1px solid var(--line); border-radius:14px; padding:16px; margin-bottom:16px; }
+    .grid { display:grid; gap:12px; }
+    table { width:100%; border-collapse: collapse; }
+    th, td { padding:10px; border-bottom:1px solid var(--line); text-align:start; vertical-align:top; }
+    th { color:var(--muted); font-size: 12px; text-transform: uppercase; letter-spacing:.04em; }
+    a { color:#93c5fd; text-decoration:none; }
+    .badge { border-radius:999px; padding:4px 10px; font-size:12px; font-weight:600; display:inline-block; }
+    .success { background: rgba(34,197,94,.15); color: var(--ok); }
+    .failure { background: rgba(239,68,68,.15); color: var(--bad); }
+    .partial_failure, .processing, .queued, .skipped { background: rgba(245,158,11,.15); color: var(--warn); }
+    .muted { color:var(--muted); }
+    input, button, select { font: inherit; padding:10px 12px; border-radius:10px; border:1px solid var(--line); background:#0b1220; color:var(--text); }
+    button { cursor:pointer; }
+    .row { display:flex; gap:10px; align-items:center; flex-wrap: wrap; }
+    .alert { padding:10px 12px; border-radius:10px; margin-bottom:14px; }
+    .alert-ok { background: rgba(34,197,94,.15); color: var(--ok); }
+    .alert-bad { background: rgba(239,68,68,.15); color: var(--bad); }
+  </style>
+</head>
+<body>
+  <div class="shell">
+    <div class="top">
+      <div class="brand"><%= t("omnitrack.ui.title") %></div>
+      <div class="row">
+        <%= link_to "EN", params.to_unsafe_h.merge(locale: :en) %>
+        <%= link_to "AR", params.to_unsafe_h.merge(locale: :ar) %>
+        <% if session[:omnitrack_admin_authenticated] %>
+          <%= button_to t("omnitrack.auth.logout"), logout_path(locale: I18n.locale), method: :delete, form_class: "row" %>
+        <% end %>
+      </div>
+    </div>
+
+    <% if flash[:notice] %>
+      <div class="alert alert-ok"><%= flash[:notice] %></div>
+    <% end %>
+    <% if flash[:alert] %>
+      <div class="alert alert-bad"><%= flash[:alert] %></div>
+    <% end %>
+
+    <%= yield %>
+  </div>
+</body>
+</html>

data/app/views/omnitrack/path/sessions/new.html.erb

@@ -0,0 +1,16 @@
+<div class="card" style="max-width: 440px; margin: 50px auto;">
+  <h2><%= t("omnitrack.auth.login_title") %></h2>
+  <p class="muted"><%= t("omnitrack.auth.login_hint") %></p>
+
+  <%= form_with url: login_submit_path(locale: I18n.locale), method: :post, local: true, class: "grid" do %>
+    <label>
+      <span><%= t("omnitrack.auth.username") %></span><br>
+      <%= text_field_tag :username, nil, required: true, autocomplete: "username" %>
+    </label>
+    <label>
+      <span><%= t("omnitrack.auth.password") %></span><br>
+      <%= password_field_tag :password, nil, required: true, autocomplete: "current-password" %>
+    </label>
+    <button type="submit"><%= t("omnitrack.auth.login_button") %></button>
+  <% end %>
+</div>

data/app/views/omnitrack/path/visit_events/index.html.erb

@@ -0,0 +1,50 @@
+<div class="card">
+  <div class="row" style="justify-content: space-between;">
+    <h2 style="margin:0;"><%= t("omnitrack.events.title") %></h2>
+    <div class="muted">
+      <%= t("omnitrack.events.total", count: @total_count) %> |
+      <%= t("omnitrack.events.page", current: @page, total: [@total_pages, 1].max) %>
+    </div>
+  </div>
+</div>
+
+<div class="card">
+  <table>
+    <thead>
+      <tr>
+        <th><%= t("omnitrack.events.columns.id") %></th>
+        <th><%= t("omnitrack.events.columns.event") %></th>
+        <th><%= t("omnitrack.events.columns.ip") %></th>
+        <th><%= t("omnitrack.events.columns.started_at") %></th>
+        <th><%= t("omnitrack.events.columns.status") %></th>
+        <th><%= t("omnitrack.events.columns.actions") %></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @events.each do |event| %>
+        <tr>
+          <td><%= event.id %></td>
+          <td><%= event.event_name %></td>
+          <td><%= event.ip.presence || "-" %></td>
+          <td><%= event.started_at %></td>
+          <td><span class="badge <%= event.overall_status %>"><%= event.overall_status %></span></td>
+          <td><%= link_to t("omnitrack.events.view"), visit_event_path(event, locale: I18n.locale) %></td>
+        </tr>
+      <% end %>
+      <% if @events.empty? %>
+        <tr>
+          <td colspan="6" class="muted"><%= t("omnitrack.events.empty") %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>
+
+<div class="row">
+  <% if @page > 1 %>
+    <%= link_to t("omnitrack.events.prev"), visit_events_path(page: @page - 1, locale: I18n.locale) %>
+  <% end %>
+  <% if @page < @total_pages %>
+    <%= link_to t("omnitrack.events.next"), visit_events_path(page: @page + 1, locale: I18n.locale) %>
+  <% end %>
+</div>

data/app/views/omnitrack/path/visit_events/show.html.erb

@@ -0,0 +1,51 @@
+<div class="card">
+  <div class="row" style="justify-content: space-between;">
+    <h2 style="margin:0;"><%= t("omnitrack.events.details_title", id: @event.id) %></h2>
+    <%= link_to t("omnitrack.events.back"), visit_events_path(locale: I18n.locale) %>
+  </div>
+
+  <div class="grid" style="margin-top:12px;">
+    <div><strong><%= t("omnitrack.events.columns.event") %>:</strong> <%= @event.event_name %></div>
+    <div><strong><%= t("omnitrack.events.columns.status") %>:</strong> <span class="badge <%= @event.overall_status %>"><%= @event.overall_status %></span></div>
+    <div><strong><%= t("omnitrack.events.columns.ip") %>:</strong> <%= @event.ip.presence || "-" %></div>
+    <div><strong>User Agent:</strong> <%= @event.user_agent.presence || "-" %></div>
+    <div><strong>Path:</strong> <%= @event.request_method %> <%= @event.request_path %></div>
+    <div><strong>Visitor Token:</strong> <%= @event.visitor_token %></div>
+    <div><strong>Started:</strong> <%= @event.started_at %></div>
+    <div><strong>Completed:</strong> <%= @event.completed_at %></div>
+  </div>
+</div>
+
+<div class="card">
+  <h3><%= t("omnitrack.events.delivery_history") %></h3>
+  <table>
+    <thead>
+      <tr>
+        <th>Adapter</th>
+        <th><%= t("omnitrack.events.columns.status") %></th>
+        <th>Sent At</th>
+        <th>Error</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @event.delivery_statuses.order(sent_at: :asc).each do |delivery| %>
+        <tr>
+          <td><%= delivery.adapter_name %></td>
+          <td><span class="badge <%= delivery.status %>"><%= delivery.status %></span></td>
+          <td><%= delivery.sent_at %></td>
+          <td><%= delivery.error_message.presence || "-" %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>
+
+<div class="card">
+  <h3>Payload</h3>
+  <pre style="white-space: pre-wrap;"><%= JSON.pretty_generate(@event.payload_json || {}) %></pre>
+</div>
+
+<div class="card">
+  <h3>Context</h3>
+  <pre style="white-space: pre-wrap;"><%= JSON.pretty_generate(@event.context_json || {}) %></pre>
+</div>

data/app/views/omnitrack/sessions/new.html.erb

@@ -0,0 +1,16 @@
+<div class="card" style="max-width: 440px; margin: 50px auto;">
+  <h2><%= t("omnitrack.auth.login_title") %></h2>
+  <p class="muted"><%= t("omnitrack.auth.login_hint") %></p>
+
+  <%= form_with url: admin_login_submit_path(locale: I18n.locale), method: :post, local: true, class: "grid" do %>
+    <label>
+      <span><%= t("omnitrack.auth.username") %></span><br>
+      <%= text_field_tag :username, nil, required: true, autocomplete: "username" %>
+    </label>
+    <label>
+      <span><%= t("omnitrack.auth.password") %></span><br>
+      <%= password_field_tag :password, nil, required: true, autocomplete: "current-password" %>
+    </label>
+    <button type="submit"><%= t("omnitrack.auth.login_button") %></button>
+  <% end %>
+</div>

data/app/views/omnitrack/visit_events/index.html.erb

@@ -0,0 +1,50 @@
+<div class="card">
+  <div class="row" style="justify-content: space-between;">
+    <h2 style="margin:0;"><%= t("omnitrack.events.title") %></h2>
+    <div class="muted">
+      <%= t("omnitrack.events.total", count: @total_count) %> |
+      <%= t("omnitrack.events.page", current: @page, total: [@total_pages, 1].max) %>
+    </div>
+  </div>
+</div>
+
+<div class="card">
+  <table>
+    <thead>
+      <tr>
+        <th><%= t("omnitrack.events.columns.id") %></th>
+        <th><%= t("omnitrack.events.columns.event") %></th>
+        <th><%= t("omnitrack.events.columns.ip") %></th>
+        <th><%= t("omnitrack.events.columns.started_at") %></th>
+        <th><%= t("omnitrack.events.columns.status") %></th>
+        <th><%= t("omnitrack.events.columns.actions") %></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @events.each do |event| %>
+        <tr>
+          <td><%= event.id %></td>
+          <td><%= event.event_name %></td>
+          <td><%= event.ip.presence || "-" %></td>
+          <td><%= event.started_at %></td>
+          <td><span class="badge <%= event.overall_status %>"><%= event.overall_status %></span></td>
+          <td><%= link_to t("omnitrack.events.view"), visit_event_path(event, locale: I18n.locale) %></td>
+        </tr>
+      <% end %>
+      <% if @events.empty? %>
+        <tr>
+          <td colspan="6" class="muted"><%= t("omnitrack.events.empty") %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>
+
+<div class="row">
+  <% if @page > 1 %>
+    <%= link_to t("omnitrack.events.prev"), visit_events_path(page: @page - 1, locale: I18n.locale) %>
+  <% end %>
+  <% if @page < @total_pages %>
+    <%= link_to t("omnitrack.events.next"), visit_events_path(page: @page + 1, locale: I18n.locale) %>
+  <% end %>
+</div>

data/app/views/omnitrack/visit_events/show.html.erb

@@ -0,0 +1,51 @@
+<div class="card">
+  <div class="row" style="justify-content: space-between;">
+    <h2 style="margin:0;"><%= t("omnitrack.events.details_title", id: @event.id) %></h2>
+    <%= link_to t("omnitrack.events.back"), visit_events_path(locale: I18n.locale) %>
+  </div>
+
+  <div class="grid" style="margin-top:12px;">
+    <div><strong><%= t("omnitrack.events.columns.event") %>:</strong> <%= @event.event_name %></div>
+    <div><strong><%= t("omnitrack.events.columns.status") %>:</strong> <span class="badge <%= @event.overall_status %>"><%= @event.overall_status %></span></div>
+    <div><strong><%= t("omnitrack.events.columns.ip") %>:</strong> <%= @event.ip.presence || "-" %></div>
+    <div><strong>User Agent:</strong> <%= @event.user_agent.presence || "-" %></div>
+    <div><strong>Path:</strong> <%= @event.request_method %> <%= @event.request_path %></div>
+    <div><strong>Visitor Token:</strong> <%= @event.visitor_token %></div>
+    <div><strong>Started:</strong> <%= @event.started_at %></div>
+    <div><strong>Completed:</strong> <%= @event.completed_at %></div>
+  </div>
+</div>
+
+<div class="card">
+  <h3><%= t("omnitrack.events.delivery_history") %></h3>
+  <table>
+    <thead>
+      <tr>
+        <th>Adapter</th>
+        <th><%= t("omnitrack.events.columns.status") %></th>
+        <th>Sent At</th>
+        <th>Error</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @event.delivery_statuses.order(sent_at: :asc).each do |delivery| %>
+        <tr>
+          <td><%= delivery.adapter_name %></td>
+          <td><span class="badge <%= delivery.status %>"><%= delivery.status %></span></td>
+          <td><%= delivery.sent_at %></td>
+          <td><%= delivery.error_message.presence || "-" %></td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+</div>
+
+<div class="card">
+  <h3>Payload</h3>
+  <pre style="white-space: pre-wrap;"><%= JSON.pretty_generate(@event.payload_json || {}) %></pre>
+</div>
+
+<div class="card">
+  <h3>Context</h3>
+  <pre style="white-space: pre-wrap;"><%= JSON.pretty_generate(@event.context_json || {}) %></pre>
+</div>

data/config/locales/ar.yml

@@ -0,0 +1,33 @@
+ar:
+  omnitrack:
+    ui:
+      title: "لوحة أومنِتراك"
+    auth:
+      login_required: "يرجى تسجيل الدخول كمسؤول أولاً."
+      login_success: "تم تسجيل الدخول بنجاح."
+      login_failed: "اسم المستخدم أو كلمة المرور غير صحيحة."
+      logout_success: "تم تسجيل الخروج بنجاح."
+      logout: "تسجيل الخروج"
+      login_title: "تسجيل دخول المسؤول"
+      login_hint: "استخدم بيانات دخول مسؤول OmniTrack."
+      username: "اسم المستخدم"
+      password: "كلمة المرور"
+      login_button: "دخول"
+    events:
+      title: "سجل الزائر الكامل"
+      details_title: "الحدث رقم %{id}"
+      total: "الإجمالي: %{count}"
+      page: "الصفحة %{current} / %{total}"
+      view: "عرض"
+      back: "العودة إلى الأحداث"
+      prev: "السابق"
+      next: "التالي"
+      empty: "لا توجد أحداث بعد."
+      delivery_history: "سجل الإرسال للمنصات"
+      columns:
+        id: "المعرف"
+        event: "الحدث"
+        ip: "عنوان IP"
+        started_at: "وقت البدء"
+        status: "الحالة"
+        actions: "إجراءات"

data/config/locales/en.yml

@@ -0,0 +1,33 @@
+en:
+  omnitrack:
+    ui:
+      title: "OmniTrack Admin"
+    auth:
+      login_required: "Please login as admin first."
+      login_success: "Logged in successfully."
+      login_failed: "Invalid username or password."
+      logout_success: "Logged out successfully."
+      logout: "Logout"
+      login_title: "Admin Login"
+      login_hint: "Use your OmniTrack admin credentials."
+      username: "Username"
+      password: "Password"
+      login_button: "Login"
+    events:
+      title: "Visitor Event History"
+      details_title: "Event #%{id}"
+      total: "Total: %{count}"
+      page: "Page %{current} / %{total}"
+      view: "View"
+      back: "Back to events"
+      prev: "Previous"
+      next: "Next"
+      empty: "No events found yet."
+      delivery_history: "Delivery History"
+      columns:
+        id: "ID"
+        event: "Event"
+        ip: "IP"
+        started_at: "Started At"
+        status: "Status"
+        actions: "Actions"

data/config/routes.rb

@@ -0,0 +1,10 @@
+Omnitrack::Engine.routes.draw do
+  scope module: :path do
+    get "login", to: "sessions#new", as: :login
+    post "login", to: "sessions#create", as: :login_submit
+    delete "logout", to: "sessions#destroy", as: :logout
+    resources :visit_events, path: "events", only: %i[index show]
+  end
+
+  root to: "path/sessions#new"
+end

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

@@ -1,9 +1,12 @@
 # frozen_string_literal: true
 
 require "rails/generators"
+require "rails/generators/migration"
 
 module Omnitrack
   class InstallGenerator < Rails::Generators::Base
+    include Rails::Generators::Migration
+
     source_root File.expand_path("templates", __dir__)
 
     desc "Creates an Omnitrack initializer and adds it to your application"
@@ -18,12 +21,23 @@ module Omnitrack
       copy_file "env.example", ".env.example"
     end
 
+    def create_dashboard_migration
+      migration_template "create_omnitrack_dashboard_tables.rb",
+                         "db/migrate/create_omnitrack_dashboard_tables.rb"
+    end
+
     def show_readme
       readme "README" if behavior == :invoke
     end
 
     private
 
+    def self.next_migration_number(dirname)
+      @previous_migration_number ||= current_migration_number(dirname)
+      @previous_migration_number = @previous_migration_number.succ
+      @previous_migration_number.to_s
+    end
+
     def readme(path)
       say <<~MSG
 
@@ -35,8 +49,10 @@ module Omnitrack
           1. Copy .env.example to .env (gitignore .env) and set *_ENABLED + secrets
           2. Optional: add gem "dotenv-rails" in development to load .env
           3. Edit config/initializers/omnitrack.rb
-          4. Place <%= omnitrack_tags %> in your layout <head> (full-stack)
-          5. Call Omnitrack.track(...) from controllers/services (see USAGE.md)
+          4. Run rails db:migrate to create OmniTrack dashboard tables
+          5. Visit /omnitrack/login for the dashboard (or custom dashboard_mount_path)
+          6. Place <%= omnitrack_tags %> in your layout <head> (full-stack)
+          7. Call Omnitrack.track(...) from controllers/services (see USAGE.md)
 
         Full docs: README.md — integration checklist: AI_GEM_SETUP.md
         ============================================================

data/lib/generators/omnitrack/install/templates/create_omnitrack_dashboard_tables.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+class CreateOmnitrackDashboardTables < ActiveRecord::Migration[6.0]
+  def change
+    create_table :omnitrack_visit_events do |t|
+      t.string :operation
+      t.string :event_name
+      t.string :request_path
+      t.string :request_method
+      t.string :ip
+      t.string :user_agent
+      t.string :session_id
+      t.string :visitor_token
+      t.string :locale
+      t.json :payload_json
+      t.json :context_json
+      t.datetime :started_at
+      t.datetime :completed_at
+      t.string :overall_status
+      t.timestamps
+    end
+
+    add_index :omnitrack_visit_events, :started_at
+    add_index :omnitrack_visit_events, :visitor_token
+    add_index :omnitrack_visit_events, :overall_status
+
+    create_table :omnitrack_delivery_statuses do |t|
+      t.references :visit_event, null: false, foreign_key: { to_table: :omnitrack_visit_events }
+      t.string :adapter_name
+      t.string :status
+      t.string :error_message
+      t.json :response_json
+      t.json :metadata_json
+      t.datetime :sent_at
+      t.timestamps
+    end
+
+    add_index :omnitrack_delivery_statuses, :status
+    add_index :omnitrack_delivery_statuses, :sent_at
+  end
+end

data/lib/generators/omnitrack/install/templates/env.example

@@ -41,3 +41,9 @@ TIKTOK_ACCESS_TOKEN=
 SNAPCHAT_ENABLED=false
 SNAPCHAT_PIXEL_ID=
 SNAPCHAT_ACCESS_TOKEN=
+
+# ---------------------------------------------------------------------------
+# OmniTrack Dashboard
+# ---------------------------------------------------------------------------
+OMNITRACK_ADMIN_USERNAME=admin
+OMNITRACK_ADMIN_PASSWORD=change-me

data/lib/generators/omnitrack/install/templates/initializer.rb

@@ -109,4 +109,13 @@ Omnitrack.configure do |config|
   # config.on_error = ->(error, adapter) {
   #   Sentry.capture_exception(error, tags: { adapter: adapter.name })
   # }
+
+  # ---------------------------------------------------------------------------
+  # Admin Dashboard (full visitor history + platform delivery statuses)
+  # ---------------------------------------------------------------------------
+  config.dashboard_enabled  = true
+  config.dashboard_per_page = 25
+  config.dashboard_mount_path = "/omnitrack"
+  config.admin_username     = ENV.fetch("OMNITRACK_ADMIN_USERNAME", "admin")
+  config.admin_password     = ENV.fetch("OMNITRACK_ADMIN_PASSWORD", "change-me")
 end

data/lib/omnitrack/audit/recorder.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+require "securerandom"
+
+module Omnitrack
+  module Audit
+    class Recorder
+      def self.start(operation, args)
+        return NullRecorder.new unless available?
+
+        new(operation, args)
+      rescue StandardError
+        NullRecorder.new
+      end
+
+      def self.available?
+        return false unless defined?(ActiveRecord::Base)
+        return false unless Omnitrack.config.dashboard_enabled
+
+        Omnitrack::VisitEvent.table_exists? && Omnitrack::DeliveryStatus.table_exists?
+      end
+
+      def initialize(operation, args)
+        @operation = operation.to_s
+        @args = args
+        @event = create_event!
+      end
+
+      def finish(result)
+        Array(result&.results).each do |adapter_result|
+          Omnitrack::DeliveryStatus.create!(
+            visit_event_id: @event.id,
+            adapter_name: adapter_result.adapter.to_s.presence || "queue",
+            status: adapter_result.status.to_s,
+            error_message: adapter_result.error&.message,
+            response_json: safe_json(adapter_result.data),
+            metadata_json: safe_json(adapter_result.metadata),
+            sent_at: Time.current
+          )
+        end
+
+        @event.update!(
+          overall_status: overall_status_from(result),
+          completed_at: Time.current
+        )
+      rescue StandardError
+        # Never interrupt app flow because of dashboard persistence.
+      end
+
+      def fail!(error)
+        @event&.update!(
+          overall_status: "failure",
+          completed_at: Time.current,
+          context_json: safe_json(base_context.merge(dispatch_error: error.message))
+        )
+      rescue StandardError
+        # no-op
+      end
+
+      private
+
+      def create_event!
+        Omnitrack::VisitEvent.create!(
+          operation: @operation,
+          event_name: extract_event_name,
+          request_path: request_meta[:path],
+          request_method: request_meta[:method],
+          ip: context_hash["ip"],
+          user_agent: context_hash["user_agent"],
+          session_id: request_meta[:session_id],
+          visitor_token: request_meta[:visitor_token] || SecureRandom.uuid,
+          locale: request_meta[:locale],
+          payload_json: safe_json(extract_payload),
+          context_json: safe_json(base_context),
+          started_at: Time.current,
+          overall_status: "processing"
+        )
+      end
+
+      def request_meta
+        @request_meta ||= (context_hash["custom_data"] || {}).transform_keys(&:to_sym)
+      end
+
+      def base_context
+        {
+          click_ids: context_hash["click_ids"],
+          utm_params: context_hash["utm_params"],
+          headers: context_hash["headers"],
+          custom_data: context_hash["custom_data"]
+        }
+      end
+
+      def context_hash
+        @context_hash ||= begin
+          raw = Omnitrack::Context.current&.to_h || {}
+          raw.each_with_object({}) { |(k, v), acc| acc[k.to_s] = v }
+        end
+      end
+
+      def extract_event_name
+        return @args.first.to_s if @operation == "track_event"
+        return "conversion" if @operation == "track_conversion"
+        return "identify" if @operation == "identify_user"
+
+        @operation
+      end
+
+      def extract_payload
+        return @args.second || {} if @operation == "track_event"
+
+        @args.first || {}
+      end
+
+      def overall_status_from(result)
+        return "success" if result.respond_to?(:success?) && result.success?
+        return "partial_failure" if result.respond_to?(:any_failure?) && result.any_failure?
+
+        "queued"
+      end
+
+      def safe_json(value)
+        value.to_h
+      rescue StandardError
+        value
+      end
+    end
+
+    class NullRecorder
+      def finish(_result); end
+
+      def fail!(_error); end
+    end
+  end
+end

data/lib/omnitrack/configuration.rb

@@ -45,6 +45,12 @@ module Omnitrack
     # Hook: called with (event_name, adapter_name, error) on adapter failure
     attr_accessor :on_error
 
+    # Admin dashboard authentication (used by Omnitrack::Engine)
+    attr_accessor :admin_username, :admin_password
+
+    # Admin dashboard behavior
+    attr_accessor :dashboard_enabled, :dashboard_per_page, :dashboard_mount_path
+
     def initialize
       @mode         = :auto
       @adapters     = {}
@@ -57,6 +63,11 @@ module Omnitrack
       @max_retries  = 3
       @retry_delay  = 1
       @on_error     = nil
+      @admin_username = ENV.fetch("OMNITRACK_ADMIN_USERNAME", "admin")
+      @admin_password = ENV.fetch("OMNITRACK_ADMIN_PASSWORD", "change-me")
+      @dashboard_enabled = true
+      @dashboard_per_page = 25
+      @dashboard_mount_path = "/omnitrack"
     end
 
     def validate!
@@ -70,6 +81,17 @@ module Omnitrack
               "Invalid log_level: #{@log_level.inspect}. Must be one of #{VALID_LOG_LVLS}"
       end
 
+      unless @dashboard_per_page.to_i.positive?
+        raise Omnitrack::ConfigurationError,
+              "dashboard_per_page must be a positive integer"
+      end
+
+      mount_path = @dashboard_mount_path.to_s
+      unless mount_path.start_with?("/") && mount_path.length > 1
+        raise Omnitrack::ConfigurationError,
+              "dashboard_mount_path must start with '/' (example: /omnitrack)"
+      end
+
       true
     end
 

data/lib/omnitrack/engine.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Omnitrack
+  class Engine < ::Rails::Engine
+    isolate_namespace Omnitrack
+
+    initializer "omnitrack.load_i18n" do |app|
+      app.config.i18n.load_path += Dir[root.join("config", "locales", "*.yml")]
+    end
+  end
+end

data/lib/omnitrack/middleware/request_tracker.rb

@@ -22,6 +22,13 @@ module Omnitrack
 
         if Omnitrack.config.auto_capture
           ctx = Omnitrack::Context.from_request(request)
+          ctx.merge!(
+            path: request.path,
+            method: request.request_method,
+            session_id: request.session&.id.to_s,
+            visitor_token: request.cookies["omnitrack_visitor_token"] || request.session&.id.to_s,
+            locale: request.params["locale"]
+          )
           Omnitrack::Context.current = ctx
 
           Omnitrack.logger.debug("middleware.request",

data/lib/omnitrack/railtie.rb

@@ -45,6 +45,14 @@ module Omnitrack
       Omnitrack.send(:reset_logger!)
     end
 
+    initializer "omnitrack.mount_dashboard_routes" do |app|
+      next unless Omnitrack.config.dashboard_enabled
+
+      app.routes.prepend do
+        mount Omnitrack::Engine => Omnitrack.config.dashboard_mount_path, as: :omnitrack
+      end
+    end
+
     # Expose rake tasks
     rake_tasks do
       load File.join(__dir__, "tasks/omnitrack.rake")

data/lib/omnitrack/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Omnitrack
-  VERSION = "2.0.0"
+  VERSION = "3.0.0"
 end

data/lib/omnitrack.rb

@@ -15,6 +15,7 @@ require_relative "omnitrack/logger"
 require_relative "omnitrack/context"
 require_relative "omnitrack/registry"
 require_relative "omnitrack/pipeline/dispatcher"
+require_relative "omnitrack/audit/recorder"
 require_relative "omnitrack/adapters/base"
 require_relative "omnitrack/adapters/google_ads"
 require_relative "omnitrack/adapters/google_analytics"
@@ -27,6 +28,7 @@ require_relative "omnitrack/concerns/controller"
 
 # Lazy-load Rails integrations only when Rails is present
 if defined?(Rails)
+  require_relative "omnitrack/engine"
   require_relative "omnitrack/railtie"
   require_relative "generators/omnitrack/install/install_generator"
 end
@@ -136,18 +138,25 @@ module Omnitrack
     private
 
     def dispatch(operation, *args)
+      recorder = Omnitrack::Audit::Recorder.start(operation, args)
+
       if config.async && defined?(Omnitrack::Jobs::TrackingJob)
         Omnitrack::Jobs::TrackingJob.perform_later(operation.to_s, *args)
-        return Omnitrack::MultiResult.new([
+        result = Omnitrack::MultiResult.new([
           Omnitrack::Result.success(metadata: { queued: true, operation: operation })
         ])
+        recorder.finish(result)
+        return result
       end
 
-      Omnitrack::Pipeline::Dispatcher.dispatch(operation, *args)
+      result = Omnitrack::Pipeline::Dispatcher.dispatch(operation, *args)
+      recorder.finish(result)
+      result
     rescue StandardError => e
       # Top-level safety net — never raise into the host application
       logger.error("omnitrack.dispatch_error",
                    operation: operation, error: e.class.name, message: e.message)
+      recorder&.fail!(e)
       Omnitrack::MultiResult.new([
         Omnitrack::Result.failure(error: e)
       ])

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: omnitrack-rb
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Your Name
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-26 00:00:00.000000000 Z
+date: 2026-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -153,8 +153,28 @@ files:
 - LICENSE.txt
 - README.md
 - USAGE.md
+- app/controllers/omnitrack/application_controller.rb
+- app/controllers/omnitrack/path/application_controller.rb
+- app/controllers/omnitrack/path/sessions_controller.rb
+- app/controllers/omnitrack/path/visit_events_controller.rb
+- app/controllers/omnitrack/sessions_controller.rb
+- app/controllers/omnitrack/visit_events_controller.rb
+- app/models/omnitrack/application_record.rb
+- app/models/omnitrack/delivery_status.rb
+- app/models/omnitrack/visit_event.rb
+- app/views/layouts/omnitrack/admin.html.erb
+- app/views/omnitrack/path/sessions/new.html.erb
+- app/views/omnitrack/path/visit_events/index.html.erb
+- app/views/omnitrack/path/visit_events/show.html.erb
+- app/views/omnitrack/sessions/new.html.erb
+- app/views/omnitrack/visit_events/index.html.erb
+- app/views/omnitrack/visit_events/show.html.erb
+- config/locales/ar.yml
+- config/locales/en.yml
+- config/routes.rb
 - lib/generators/omnitrack/install/install_generator.rb
 - lib/generators/omnitrack/install/templates/README
+- lib/generators/omnitrack/install/templates/create_omnitrack_dashboard_tables.rb
 - lib/generators/omnitrack/install/templates/env.example
 - lib/generators/omnitrack/install/templates/initializer.rb
 - lib/omnitrack.rb
@@ -164,10 +184,12 @@ files:
 - lib/omnitrack/adapters/meta.rb
 - lib/omnitrack/adapters/snapchat.rb
 - lib/omnitrack/adapters/tiktok.rb
+- lib/omnitrack/audit/recorder.rb
 - lib/omnitrack/compat/hash_compact_backport.rb
 - lib/omnitrack/concerns/controller.rb
 - lib/omnitrack/configuration.rb
 - lib/omnitrack/context.rb
+- lib/omnitrack/engine.rb
 - lib/omnitrack/errors.rb
 - lib/omnitrack/helpers/view_helpers.rb
 - lib/omnitrack/jobs/tracking_job.rb