omnitrack-rb 0.1.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3159ca70c1926bd7576f69daa82b043b7712219c920ad13c956560294b52940c
-  data.tar.gz: 8f86771d6bba1b2c6531b1076c369eb464faa40406d111aacebe0610273f83df
+  metadata.gz: ff7c5f93aedbb1f18f5b24a083661516212f52c8973b2b464ddef8667701de31
+  data.tar.gz: dfb4173d07da82b896221c87f3c107b1061eea2d1183d5da16787c5420924235
 SHA512:
-  metadata.gz: d49fed2d40c06182c33922feafdf8fb7969480c3468d03b95248594fb16517ce0e6f8cc3171c002bd3d8b83ce9fa097d0f61bb88bdf7156015cfa10ea50d16de
-  data.tar.gz: d95277587d7eab7b07e4cebbad26e593d96ee00dafff1ebcbcc45953d073db1255c6b27585011e61b006131078c93814d6e530e4986660a6d0c7cd692efef4db
+  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

@@ -4,6 +4,30 @@ Use this document when **adding `omnitrack-rb` to an existing Rails 6+ app** so
 
 ---
 
+## 0. Ruby version (including 2.7.8)
+
+The gem declares **`required_ruby_version >= 2.7.0`** and is written to run on **Ruby 2.7.8** without Ruby 3-only syntax. Your **host app** should use a supported Ruby and lock it so CI and production match.
+
+**Example in the host `Gemfile` (optional but recommended):**
+
+```ruby
+ruby "2.7.8"   # or "3.0.6", "3.2.2", etc. — must be >= 2.7.0
+```
+
+**Check locally:**
+
+```bash
+ruby -v    # should be 2.7.8 or newer
+```
+
+**Rails:** use **Rails 6.x or 7.x** (or newer) with a Ruby version that Rails supports for that release. If the app is stuck on **Ruby 2.7.8**, keep **Rails 6.1.x** (or the last 6.x line you use) unless you have verified a newer stack.
+
+**Bundler:** Bundler 2.x is typical; run `bundle install` with the same Ruby the app uses in production.
+
+Nothing else is required for 2.7.8 specifically — no extra `require` in `application.rb`; the Railtie loads OmniTrack like any other Rails engine/gem.
+
+---
+
 ## 1. Gemfile (required)
 
 In the **host** application `Gemfile`:
@@ -33,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):**
 
@@ -128,6 +159,7 @@ Until `Omnitrack::Jobs::TrackingJob` and ActiveJob are loaded, the gem runs sync
 
 | Symptom | What to do |
 |--------|------------|
+| `ruby` version error from Bundler | Host `Gemfile` `ruby "x.y.z"` must match your runtime; use `ruby -v` and align RVM/rbenv/asdf. |
 | `uninitialized constant Omnitrack` | Run `bundle install`; ensure `config/application.rb` loads Bundler default group; boot with `bin/rails c`. |
 | `ENV[...] is nil` in logs | Adapters with `enabled: true` but missing tokens may log or skip; set `*_ENABLED=false` until credentials exist. |
 | Job errors when `async: true` | Set `config.async = false` until ActiveJob and queue are configured, or add queue adapter. |
@@ -142,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/CHANGELOG.md

@@ -2,18 +2,26 @@
 
 ## [Unreleased]
 
+## [2.0.0] - 2026-04-26
+
 ### Added
 - `AI_GEM_SETUP.md` — step-by-step integration for host apps (Bundler, initializer, ENV, ActiveJob, pitfalls)
 - `.env.example` — variable names matching the install template; install generator copies `env.example` → `.env.example` when missing
 - `USAGE.md` — concrete ERB/Ruby examples for layout, HTML/API controllers, and a service object
+- `lib/omnitrack/compat/hash_compact_backport` — `Hash#compact` on Rubies before 3.1 (e.g. 2.7.x, 3.0)
 
 ### Fixed
+- **Ruby 2.7.8** and **Ruby 3.0** compatibility: no endless `def` or `filter_map` (require Ruby 3+ in core for those); compatible `Enumerable` + `Hash#compact` usage
 - Conventional `lib/omnitrack` gem layout, loadable `require "omnitrack"`
 - `rails generate omnitrack:install` generator at `lib/generators/omnitrack/install/`
 - `Omnitrack::Controller` as an alias of `Omnitrack::Concerns::Controller`
 - Default `adapter_name` for adapters uses `underscore` (snake_case) so config keys (e.g. `google_ads`) match the registry; `Omnitrack.reset!` re-registers first-party adapters in tests
 - `activesupport` as a direct runtime dependency; explicit requires for `ActiveSupport` extensions used at load time
 
+### Upgrade from 0.1.0
+- In the host `Gemfile`, pin `gem "omnitrack-rb", "~> 2.0"` and run `bundle update omnitrack-rb`
+- If you had relied on a mis-registered adapter key (`:googleads` from an old build), use **`google_ads`** in `config.adapters` (and env-driven flags) to match the registry
+
 ## [0.1.0] - 2024-01-15
 
 ### Added

data/README.md

@@ -1,7 +1,7 @@
 # OmniTrack-rb 🎯
 
 [![Gem Version](https://img.shields.io/gem/v/omnitrack-rb)](https://rubygems.org/gems/omnitrack-rb)
-[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%202.7-red)](https://www.ruby-lang.org)
+[![Ruby](https://img.shields.io/badge/ruby-2.7%2B-red)](https://www.ruby-lang.org)
 [![Rails](https://img.shields.io/badge/rails-%3E%3D%206.0-red)](https://rubyonrails.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE.txt)
 
@@ -9,6 +9,8 @@
 
 OmniTrack dispatches events to multiple ad/analytics platforms through a clean adapter pattern — works identically in full-stack and API-only Rails apps, never crashes your main application, and emits structured JSON logs to a dedicated file.
 
+Runtime: **Ruby ≥ 2.7** (including **2.7.8**) and **Rails ≥ 6**. No Ruby 3-only syntax in the gem runtime.
+
 **Practical usage (file placement + method examples):** [USAGE.md](USAGE.md)  
 **Add the gem to any Rails app without boot errors (ENV, jobs, checklists):** [AI_GEM_SETUP.md](AI_GEM_SETUP.md)  
 **ENV variable names (copy into host `.env.example`):** [.env.example](.env.example)
@@ -321,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/compat/hash_compact_backport.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+# Hash#compact was added in Ruby 3.1. This gem supports Ruby 2.7+ and runs on
+# Ruby 3.0 with no core Hash#compact, so we backport only when missing.
+
+unless {}.respond_to?(:compact)
+  class Hash
+    def compact
+      select { |_, v| !v.nil? }
+    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/context.rb

@@ -54,9 +54,17 @@ module Omnitrack
       self
     end
 
-    def gclid  = click_ids[:gclid]
-    def fbclid = click_ids[:fbclid]
-    def ttclid = click_ids[:ttclid]
+    def gclid
+      click_ids[:gclid]
+    end
+
+    def fbclid
+      click_ids[:fbclid]
+    end
+
+    def ttclid
+      click_ids[:ttclid]
+    end
 
     # Full context as a hash — passed into adapter payloads
     def to_h

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/registry.rb

@@ -38,7 +38,7 @@ module Omnitrack
       # Instantiate all *enabled* adapters based on current configuration.
       # @return [Array<Omnitrack::Adapters::Base>]
       def enabled_adapters
-        MUTEX.synchronize { @adapters.dup }.filter_map do |adapter_name, klass|
+        MUTEX.synchronize { @adapters.dup }.map do |adapter_name, klass|
           cfg = Omnitrack.config.adapter_config(adapter_name)
           next unless cfg.fetch(:enabled, false)
 
@@ -47,7 +47,7 @@ module Omnitrack
           Omnitrack.logger.error("registry.init_error",
                                  adapter: adapter_name, message: e.message)
           nil
-        end
+        end.compact
       end
 
       # Clear all registrations (useful in tests)

data/lib/omnitrack/version.rb

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

data/lib/omnitrack.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "omnitrack/compat/hash_compact_backport"
 require "active_support/concern"
 require "active_support/core_ext/object/blank"
 require "active_support/core_ext/string/inflections"
@@ -14,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"
@@ -26,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
@@ -135,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: 0.1.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,9 +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