lesli_audit 1.1.1 → 1.1.2

data/app/services/lesli_audit/visitor_service.rb

@@ -34,7 +34,7 @@ module LesliAudit
     class VisitorService < Lesli::ApplicationLesliService
 
         def visits
-            requests = current_user.account.audit.account_requests
+            requests = apply_time_filter(current_user.account.audit.account_requests)
 
             controllers, total_requests = requests.pick(
                 Arel.sql("COUNT(DISTINCT request_controller)"),
@@ -47,26 +47,22 @@ module LesliAudit
             }
         end 
 
-        def visitors 
+        def traffic
             #Rails.cache.fetch(cache_key_for_account(__method__), expires_in: 1.hour) do 
                 group = 'day' 
                 #group = params[:bygroup] if ['month','week','day'].include?(params[:bygroup])
 
-                # only the users of the account
-                usrs = current_user.account.users
-
-                group_by = "DATE_TRUNC('month', created_at)" if group == 'month'
-                group_by = "DATE_TRUNC('week', created_at)" if group == 'week'
-                group_by = "DATE_TRUNC('day', created_at)" if group == 'day'
+                group_by = "DATE_TRUNC('month', date)" if group == 'month'
+                group_by = "DATE_TRUNC('week', date)" if group == 'week'
+                group_by = "DATE_TRUNC('day', date)" if group == 'day'
 
                 # compatibility for SQLite
                 if ActiveRecord::Base.connection.adapter_name == "SQLite"
-                    group_by = "strftime('%Y-%m-%d', created_at)"
+                    group_by = "strftime('%Y-%m-%d', date)"
                 end
 
-                requests = current_user.account.audit.account_requests.group(group_by)
-
-                requests = apply_filters(requests, query)
+                requests = apply_time_filter(current_user.account.audit.account_requests)
+                .group(group_by)
                 
                 requests.limit(10).order("xaxiskey desc").select(
                     "sum(request_count) yaxiskey",
@@ -76,11 +72,9 @@ module LesliAudit
         end 
 
         def requests
-            requests = current_user.account.audit.account_requests
+            requests = apply_time_filter(current_user.account.audit.account_requests)
             .group("request_controller")
 
-            requests = apply_filters(requests, query)
-
             requests = requests.limit(LIMIT).order("requests DESC").select(
                 :request_controller,
                 "sum(request_count) requests"
@@ -88,7 +82,7 @@ module LesliAudit
         end
 
         def os 
-            device_counts = current_user.account.audit.account_devices
+            device_counts = apply_time_filter(current_user.account.audit.account_devices)
             .group(:agent_platform)
             .sum(:agent_count)
 
@@ -105,7 +99,7 @@ module LesliAudit
         end 
 
         def devices 
-            device_counts = current_user.account.audit.account_devices
+            device_counts = apply_time_filter(current_user.account.audit.account_devices)
             .group(:agent_device)
             .sum(:agent_count)
 
@@ -122,7 +116,7 @@ module LesliAudit
         end 
 
         def browsers
-            browser_counts = current_user.account.audit.account_devices
+            browser_counts = apply_time_filter(current_user.account.audit.account_devices)
             .group(:agent_browser)
             .sum(:agent_count)
 
@@ -138,9 +132,9 @@ module LesliAudit
             end
             #Rails.cache.fetch(cache_key_for_account(__method__), expires_in: 4.hour) do 
                 # current_user.account.audit.account_devices
-                # .group(:agent_browser, :created_at)
+                # .group(:agent_browser, :date)
                 # .select(
-                #     'created_at as xaxiskey',
+                #     'date as xaxiskey',
                 #     'agent_browser as dataname',
                 #     'sum(agent_count) as yaxiskey'
                 # ).as_json
@@ -203,37 +197,16 @@ module LesliAudit
             DEVICE_ICON_CLASSES.fetch(device.to_s, DEVICE_ICON_CLASSES["unknown"])
         end
 
-        def apply_filters requests, params
-
-            return requests
-
-            # filter by search string
-            unless params[:search].blank?
-                requests = requests.where(
-                    "lower(request_agent) like :search_string or lower(request_controller) like :search_string or lower(request_action) like :search_string", 
-                    { 
-                        search_string: "%#{params[:search].downcase.gsub(" ","%")}%"
-                    }
-                ) 
+        def apply_time_filter(relation)
+            start_date = case query[:bytime]
+            when "day" then Date.current
+            when "week" then 6.days.ago.to_date
+            when "month" then 29.days.ago.to_date
+            when "sixmonth" then 6.months.ago.to_date
+            when "year" then 1.year.ago.to_date
             end
 
-            # filter by time
-            unless params[:bytime].blank? && params[:bytime] != 'all'
-                requests = requests.where(created_at: (Time.now.beginning_of_day)..) if params[:bytime] == 'day'
-                requests = requests.where(created_at: (Time.now.beginning_of_day - 7.day)..) if params[:bytime] == 'week'
-                requests = requests.where(created_at: (Time.now.beginning_of_day - 30.day)..) if params[:bytime] == 'month'
-                requests = requests.where(created_at: (Time.now.beginning_of_day - 6.month)..) if params[:bytime] == 'sixmonth'
-                requests = requests.where(created_at: (Time.now.beginning_of_day - 1.year)..) if params[:bytime] == 'year'
-            end
-
-            # filter by request format
-            if (!params[:byformat].blank? && ['html', 'json'].include?(params[:byformat]))
-                requests = requests.where(:request_action => 'show') if params[:byformat] == 'html'
-                requests = requests.where(:request_format => params[:byformat])
-            end
-
-            requests
-
+            start_date ? relation.where(date: start_date..) : relation
         end
     end
 end

data/app/views/lesli_audit/logs/show.html.erb

@@ -1,10 +1,16 @@
-<p style="color: green"><%= notice %></p>
+<%= render(LesliView::Layout::Container.new("audit-log")) do %>
+    <%= render(LesliView::Components::Header.new("Audit event")) %>
 
-<%= render @log %>
+    <dl class="grid grid-cols-1 gap-4 rounded-2xl border border-slate-200 bg-white p-5 shadow-sm sm:grid-cols-2">
+        <% %i[engine source action operation description actor_uid session_id created_at].each do |field| %>
+            <div>
+                <dt class="text-sm font-medium text-slate-500"><%= field.to_s.humanize %></dt>
+                <dd class="mt-1 break-words text-sm text-slate-900"><%= @log.public_send(field) %></dd>
+            </div>
+        <% end %>
+    </dl>
 
-<div>
-  <%= link_to "Edit this log", edit_log_path(@log) %> |
-  <%= link_to "Back to logs", logs_path %>
-
-  <%= button_to "Destroy this log", @log, method: :delete %>
-</div>
+    <div class="mt-6">
+        <%= link_to "Back to logs", logs_path, class: "text-sm font-medium text-sky-700 hover:text-sky-900" %>
+    </div>
+<% end %>

data/app/views/lesli_audit/partials/_navigation.html.erb

@@ -33,6 +33,6 @@ Building a better future, one line of code at a time.
 %>
 
 <%= navigation_item(lesli_audit.users_path, 'Users', 'ri-team-line'); %>
-<%= navigation_item(lesli_audit.visitors_path, 'Visitors', 'ri-line-chart-fill'); %>
+<%= navigation_item(lesli_audit.analytics_path, 'Traffic', 'ri-line-chart-fill'); %>
 <%= navigation_item(lesli_audit.requests_path, 'Requests', 'ri-arrow-left-right-fill'); %>
 <%= navigation_item(lesli_audit.logs_path, 'Logs', 'ri-history-line'); %>

data/app/views/lesli_audit/users/index.html.erb

@@ -64,9 +64,6 @@ color_classes = {
             }, {
                 label: "Last activity",
                 field: "last_activity"
-            }, {
-                label: "Resources",
-                field: "resources"
             }, {
                 label: "Requests",
                 field: "requests"

data/app/views/lesli_audit/visitors/index.html.erb

@@ -1,7 +1,7 @@
 
 <%
-visitors = @visitors.reverse
-top_days = visitors.last(3)
+traffic = @traffic.reverse
+top_days = traffic.last(3)
 %>
 
 <%= render(LesliView::Layout::Container.new("audit-analytics")) do %>
@@ -9,7 +9,7 @@ top_days = visitors.last(3)
 
     <section
         class="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-5"
-        aria-label="Visitor overview">
+        aria-label="Traffic overview">
         <article class="rounded-2xl border border-slate-200 bg-white p-5 shadow-sm">
             <h2 class="text-sm font-medium text-slate-500">Controllers</h2>
             <p class="mt-3 text-3xl font-semibold tracking-tight text-slate-900 tabular-nums">
@@ -36,21 +36,21 @@ top_days = visitors.last(3)
 
     <section class="mt-6 rounded-2xl border border-slate-200 bg-white p-5 shadow-sm">
         <%= render(LesliView::Charts::Line.new(
-            title: "Visitors",
-            database_to_dataset: visitors
+            database_to_dataset: traffic,
+            title: "Requests"
         )) %>
     </section>
 
-    <section class="mt-6 grid grid-cols-1 gap-6 lg:grid-cols-3" aria-label="Visitor breakdown">
+    <section class="mt-6 grid grid-cols-1 gap-6 lg:grid-cols-3" aria-label="Request traffic breakdown">
         <article class="min-w-0">
             <%= render(LesliView::Elements::Table.new(
                 columns: [
                     { label: "Browsers", align: :left },
-                    { label: "Visitors", align: :center }
+                    { label: "Requests", align: :center }
                 ],
                 class_name: "!min-w-0",
                 compact: true,
-                caption: "Visitors by browser"
+                caption: "Requests by browser"
             )) do |table| %>
                 <% @browsers.each do |browser| %>
                     <% percentage = browser[:percentage].to_i.clamp(0, 100) %>
@@ -81,11 +81,11 @@ top_days = visitors.last(3)
             <%= render(LesliView::Elements::Table.new(
                 columns: [
                     { label: "OS", align: :left },
-                    { label: "Visitors", align: :center }
+                    { label: "Requests", align: :center }
                 ],
                 class_name: "!min-w-0",
                 compact: true,
-                caption: "Visitors by operating system"
+                caption: "Requests by operating system"
             )) do |table| %>
                 <% @os.each do |device| %>
                     <% percentage = device[:percentage].to_i.clamp(0, 100) %>
@@ -116,11 +116,11 @@ top_days = visitors.last(3)
             <%= render(LesliView::Elements::Table.new(
                 columns: [
                     { label: "Device", align: :left },
-                    { label: "Visitors", align: :center }
+                    { label: "Requests", align: :center }
                 ],
                 class_name: "!min-w-0",
                 compact: true,
-                caption: "Visitors by device"
+                caption: "Requests by device"
             )) do |table| %>
                 <% @devices.each do |device| %>
                     <% percentage = device[:percentage].to_i.clamp(0, 100) %>

data/config/routes.rb

@@ -43,11 +43,12 @@ LesliAudit::Engine.routes.draw do
     resources :users, only: [:index] 
 
     # Analytics:
-    #   Visitors by date
+    #   Requests by date
     #   Trends by date
     #   Most active users
     #   Most active controllers
-    resources :visitors, only: [:index] 
+    get "analytics", to: "visitors#index", as: :analytics
+    resources :visitors, only: [:index]
 
     resources :logs, only: [:index, :show]
 

data/db/migrate/v1.0/0501000110_create_lesli_audit_accounts.rb

@@ -30,8 +30,21 @@ Building a better future, one line of code at a time.
 // · 
 =end
 
-class CreateLesliAuditAccounts < ActiveRecord::Migration[6.0]
+class CreateLesliAuditAccounts < ActiveRecord::Migration[8.1]
     def change
         create_table_lesli_shared_account_10(:lesli_audit)
+
+        remove_index :lesli_audit_accounts, :account_id
+        add_index :lesli_audit_accounts, :account_id,
+            unique: true,
+            name: "index_lesli_audit_accounts_on_account_id"
+
+        # Soft deletion keeps the core row and its audit history. Only a
+        # deliberate hard deletion activates this cascade.
+        remove_foreign_key :lesli_audit_accounts, :lesli_accounts,
+            column: :account_id
+        add_foreign_key :lesli_audit_accounts, :lesli_accounts,
+            column: :account_id,
+            on_delete: :cascade
     end
 end

data/db/migrate/v1.0/0501110110_create_lesli_audit_account_logs.rb

@@ -30,24 +30,28 @@ Building a better future, one line of code at a time.
 // · 
 =end
 
-class CreateLesliAuditAccountLogs < ActiveRecord::Migration[6.0]
+class CreateLesliAuditAccountLogs < ActiveRecord::Migration[8.1]
     def change
         create_table :lesli_audit_account_logs do |t|
             t.string :engine
+            t.string :source
             t.string :action
 
             # Polymorphic subject
             t.string :subject_type
             t.bigint :subject_id
 
-            t.string :operation
-            t.string :description
+            t.string :operation, null: false
+            t.text :description
             t.string :session_id
+            t.string :actor_uid
 
-            t.timestamps
+            t.timestamps null: false
         end
 
-        add_reference(:lesli_audit_account_logs, :user, foreign_key: { to_table: :lesli_users }, null: true) 
-        add_reference(:lesli_audit_account_logs, :account, foreign_key: { to_table: :lesli_audit_accounts }, null: true)
+        add_reference(:lesli_audit_account_logs, :user, foreign_key: { to_table: :lesli_users, on_delete: :nullify }, null: true)
+        add_reference(:lesli_audit_account_logs, :account, foreign_key: { to_table: :lesli_audit_accounts, on_delete: :cascade }, null: false)
+        add_index(:lesli_audit_account_logs, %i[account_id created_at], name: "index_lesli_audit_account_logs_on_account_and_created_at")
+        add_index(:lesli_audit_account_logs, :created_at, name: "index_lesli_audit_account_logs_on_created_at")
     end
 end

data/db/migrate/v1.0/0501110210_create_lesli_audit_account_devices.rb

@@ -33,14 +33,17 @@ Building a better future, one line of code at a time.
 class CreateLesliAuditAccountDevices < ActiveRecord::Migration[8.1]
     def change
         create_table :lesli_audit_account_devices do |t|
-            t.string  :agent_platform
-            t.string  :agent_browser
-            t.string  :agent_device
-            t.integer :agent_count
-            t.date    :created_at
+            t.string :agent_platform, null: false
+            t.string :agent_browser, null: false
+            t.string :agent_device, null: false
+            t.bigint :agent_count, null: false, default: 0
+            t.date :date, null: false
+            t.timestamps null: false
         end
 
-        add_reference(:lesli_audit_account_devices, :account, foreign_key: { to_table: :lesli_audit_accounts })
-        add_index(:lesli_audit_account_devices, %i[agent_platform agent_browser agent_device created_at account_id], unique: true, name: "lesli_audit_devices_index")
+        add_reference(:lesli_audit_account_devices, :account, null: false, foreign_key: { to_table: :lesli_audit_accounts, on_delete: :cascade })
+        add_check_constraint(:lesli_audit_account_devices, "agent_count >= 0", name: "lesli_audit_account_devices_agent_count_nonnegative")
+        add_index(:lesli_audit_account_devices, %i[account_id date agent_platform agent_browser agent_device], unique: true, name: "lesli_audit_devices_index")
+        add_index(:lesli_audit_account_devices, :date, name: "index_lesli_audit_account_devices_on_date")
     end
 end

data/db/migrate/v1.0/0501110310_create_lesli_audit_account_requests.rb

@@ -30,15 +30,18 @@ Building a better future, one line of code at a time.
 // ·
 =end
 
-class CreateLesliAuditAccountRequests < ActiveRecord::Migration[6.0]
+class CreateLesliAuditAccountRequests < ActiveRecord::Migration[8.1]
     def change
         create_table :lesli_audit_account_requests do |t|
-            t.string    :request_controller
-            t.string    :request_action
-            t.integer   :request_count
-            t.date      :created_at
+            t.string :request_controller, null: false
+            t.string :request_action, null: false
+            t.bigint :request_count, null: false, default: 0
+            t.date :date, null: false
+            t.timestamps null: false
         end
-        add_reference(:lesli_audit_account_requests, :account, foreign_key: { to_table: :lesli_audit_accounts })
-        add_index(:lesli_audit_account_requests, %i[request_controller request_action created_at account_id], unique: true, name: "lesli_audit_account_requests_index")
+        add_reference(:lesli_audit_account_requests, :account, null: false, foreign_key: { to_table: :lesli_audit_accounts, on_delete: :cascade })
+        add_check_constraint(:lesli_audit_account_requests, "request_count >= 0", name: "lesli_audit_account_requests_request_count_nonnegative")
+        add_index(:lesli_audit_account_requests, %i[account_id date request_controller request_action], unique: true, name: "lesli_audit_account_requests_index")
+        add_index(:lesli_audit_account_requests, :date, name: "index_lesli_audit_account_requests_on_date")
     end
 end

data/db/migrate/v1.0/0501120110_create_lesli_audit_user_logs.rb

@@ -30,25 +30,29 @@ Building a better future, one line of code at a time.
 // · 
 =end
 
-class CreateLesliAuditUserLogs < ActiveRecord::Migration[6.0]
+class CreateLesliAuditUserLogs < ActiveRecord::Migration[8.1]
     def change
         create_table :lesli_audit_user_logs do |t|
             t.string :engine
             t.string :source
             t.string :action
 
-            t.string :operation
-            t.string :description
-            t.bigint :session_id
+            t.string :operation, null: false
+            t.text :description
+            t.string :session_id
+            t.string :actor_uid
 
             # Polymorphic subject
             t.string :subject_type
             t.bigint :subject_id
 
-            t.timestamps
+            t.timestamps null: false
         end
 
-        add_reference(:lesli_audit_user_logs, :user, foreign_key: { to_table: :lesli_users }) 
-        add_reference(:lesli_audit_user_logs, :account, foreign_key: { to_table: :lesli_audit_accounts })
+        add_reference(:lesli_audit_user_logs, :user, null: true, foreign_key: { to_table: :lesli_users, on_delete: :nullify })
+        add_reference(:lesli_audit_user_logs, :account, null: false, foreign_key: { to_table: :lesli_audit_accounts, on_delete: :cascade })
+        add_index(:lesli_audit_user_logs, %i[account_id created_at], name: "index_lesli_audit_user_logs_on_account_and_created_at")
+        add_index(:lesli_audit_user_logs, %i[user_id created_at], name: "index_lesli_audit_user_logs_on_user_and_created_at")
+        add_index(:lesli_audit_user_logs, :created_at, name: "index_lesli_audit_user_logs_on_created_at")
     end
 end

data/db/migrate/v1.0/0501120210_create_lesli_audit_user_journals.rb

@@ -30,16 +30,27 @@ Building a better future, one line of code at a time.
 // ·
 =end
 
-class CreateLesliAuditUserJournals < ActiveRecord::Migration[6.0]
+class CreateLesliAuditUserJournals < ActiveRecord::Migration[8.1]
     def change
         create_table :lesli_audit_user_journals do |t|
-            t.string  :request_controller
-            t.string  :request_action
-            t.date    :date, index: true
-            t.bigint  :session_id
-            t.timestamps
+            t.string :event_uid, null: false
+            t.string :request_controller
+            t.string :request_action
+            t.date :date, null: false
+            t.string :session_id
+            t.string :agent_platform
+            t.string :agent_browser
+            t.string :agent_device
+            t.boolean :analytics_enabled, null: false, default: true
+            t.boolean :retain, null: false, default: true
+            t.datetime :processed_at
+            t.timestamps null: false
         end
-        add_reference(:lesli_audit_user_journals, :user, foreign_key: { to_table: :lesli_users })
-        add_reference(:lesli_audit_user_journals, :account, foreign_key: { to_table: :lesli_audit_accounts })
+        add_reference(:lesli_audit_user_journals, :user, null: true, foreign_key: { to_table: :lesli_users, on_delete: :nullify })
+        add_reference(:lesli_audit_user_journals, :account, null: false, foreign_key: { to_table: :lesli_audit_accounts, on_delete: :cascade })
+        add_index(:lesli_audit_user_journals, %i[account_id date], name: "index_lesli_audit_user_journals_on_account_and_date")
+        add_index(:lesli_audit_user_journals, %i[account_id event_uid], unique: true, name: "lesli_audit_user_journals_event_index")
+        add_index(:lesli_audit_user_journals, :date, name: "index_lesli_audit_user_journals_on_date")
+        add_index(:lesli_audit_user_journals, :processed_at, name: "index_lesli_audit_user_journals_on_processed_at")
     end
 end

data/db/migrate/v1.0/0501120310_create_lesli_audit_user_requests.rb

@@ -30,18 +30,21 @@ Building a better future, one line of code at a time.
 // ·
 =end
 
-class CreateLesliAuditUserRequests < ActiveRecord::Migration[6.0]
+class CreateLesliAuditUserRequests < ActiveRecord::Migration[8.1]
     def change
         create_table :lesli_audit_user_requests do |t|
-            t.string  :request_controller
-            t.string  :request_action
-            t.integer :request_count
-            t.date    :date, index: true
-            t.bigint  :session_id
-            t.timestamps
+            t.string :request_controller, null: false
+            t.string :request_action, null: false
+            t.bigint :request_count, null: false, default: 0
+            t.date :date, null: false
+            t.string :session_id
+            t.timestamps null: false
         end
-        add_reference(:lesli_audit_user_requests, :user, foreign_key: { to_table: :lesli_users })
-        add_reference(:lesli_audit_user_requests, :account, foreign_key: { to_table: :lesli_audit_accounts })
-        add_index(:lesli_audit_user_requests, %i[request_controller request_action date user_id session_id], unique: true, name: "lesli_audit_user_requests_index")
+        add_reference(:lesli_audit_user_requests, :user, null: false, foreign_key: { to_table: :lesli_users, on_delete: :cascade })
+        add_reference(:lesli_audit_user_requests, :account, null: false, foreign_key: { to_table: :lesli_audit_accounts, on_delete: :cascade })
+        add_check_constraint(:lesli_audit_user_requests, "request_count >= 0", name: "lesli_audit_user_requests_request_count_nonnegative")
+        add_index(:lesli_audit_user_requests, %i[account_id user_id session_id date request_controller request_action], unique: true, name: "lesli_audit_user_requests_index")
+        add_index(:lesli_audit_user_requests, %i[account_id date], name: "index_lesli_audit_user_requests_on_account_and_date")
+        add_index(:lesli_audit_user_requests, :date, name: "index_lesli_audit_user_requests_on_date")
     end
 end

data/db/seed/devices.rb

@@ -68,7 +68,7 @@ current_user = Lesli::User.first
                     :agent_platform => platform,
                     :agent_browser => browser,
                     :agent_device => device,
-                    :created_at => date,
+                    :date => date,
                 )
             end
         end

data/db/seed/requests.rb

@@ -58,7 +58,7 @@ session = current_user.sessions.first
         ).find_or_create_by(
             :request_controller => controller,
             :request_action => "show",
-            :created_at => date,
+            :date => date,
         )
 
         current_user.account.audit.user_requests.create_with(
@@ -66,8 +66,8 @@ session = current_user.sessions.first
         ).find_or_create_by(
             :request_controller => controller,
             :request_action => "show",
-            :created_at => date,
-            :session => session,
+            :date => date,
+            :session_id => session&.id,
             :user => current_user
         )
     end

data/lib/lesli_audit/engine.rb

@@ -1,18 +1,7 @@
-require "useragent"
 module LesliAudit
     class Engine < ::Rails::Engine
         isolate_namespace LesliAudit
-
-        config.to_prepare do
-            unless Lesli::User < LesliAudit::UserAssociations
-                Lesli::User.include(LesliAudit::UserAssociations)
-            end
-        end
-
-        initializer :lesli_admin do |app|
-
-            # register assets manifest
-            config.assets.precompile += %w[lesli_audit_manifest.js]
+        initializer :lesli_audit do |app|
 
             app.config.assets.paths << root.join("app", "javascript").to_s
 

data/lib/lesli_audit/version.rb

@@ -1,4 +1,4 @@
 module LesliAudit
-    VERSION = "1.1.1"
-    BUILD = "1791607001"
+    VERSION = "1.1.2"
+    BUILD = "1792716699"
 end

data/lib/tasks/lesli_audit_tasks.rake

@@ -1,4 +1,12 @@
-# desc "Explaining what the task does"
-# task :lesli_audit do
-#   # Task goes here
-# end
+namespace :lesli_audit do
+    namespace :retention do
+        desc "Delete expired LesliAudit data using the configured retention policy"
+        task cleanup: :environment do
+            deleted = LesliAudit::RetentionCleanup.call
+
+            deleted.each do |table, count|
+                puts "#{table}: #{count} deleted"
+            end
+        end
+    end
+end

data/readme.md

@@ -8,8 +8,8 @@
 <br />
 
 <div align="center">
-    <a target="_blank" href="https://github.com/LesliTech/LesliAudit/actions/workflows/lesli-ci-tests.yaml">
-        <img alt="LesliAudit test status" src="https://img.shields.io/github/actions/workflow/status/LesliTech/LesliAudit/lesli-ci-tests.yaml?branch=master&style=for-the-badge&logo=github&label=tests">
+    <a target="_blank" href="https://github.com/LesliTech/LesliAudit/actions/workflows/lesli-ci-engine.yaml">
+        <img alt="LesliAudit test status" src="https://img.shields.io/github/actions/workflow/status/LesliTech/LesliAudit/lesli-ci-engine.yaml?branch=master&style=for-the-badge&logo=github&label=tests">
     </a>
     <a target="_blank" href="https://rubygems.org/gems/lesli_audit">
         <img alt="Gem Version" src="https://img.shields.io/gem/v/lesli_audit?style=for-the-badge&logo=ruby">
@@ -47,10 +47,16 @@ It records account activity and provides administrators with searchable operatio
 
 - Account activity and audit logs
 - Request and navigation history
-- Visitor and authenticated-user analytics
-- Device and user-agent information
+- Request, device, and authenticated-user analytics
+- Direct account and authenticated-user request counters
+- Configurable batched data retention
+- Normalized browser, platform, and device categories
 - Detailed views for investigating recorded activity
 
+Activity logs are explicit append-only business or security events. They are
+separate from request analytics: user requests are grouped counters, while
+user journals are individual normalized HTTP request events.
+
 <br />
 
 ## Try LesliAudit
@@ -64,7 +70,8 @@ It records account activity and provides administrators with searchable operatio
 
 ### Requirements
 
-- A Rails application with [Lesli](https://rubygems.org/gems/lesli)
+- Ruby 3.x and Rails `~> 8.1`
+- A Rails application with [Lesli](https://rubygems.org/gems/lesli) `~> 5.1.0`
 - SQLite by default, or PostgreSQL when preferred by the host application
 
 ### Install LesliAudit
@@ -143,6 +150,12 @@ bin/rails test
 
 - [Lesli website](https://www.lesli.dev/)
 - [Documentation](https://www.lesli.dev/engines/audit)
+- [Architecture and data policy](./docs/about/architecture.md)
+- [Configuration](./docs/about/configuration.md)
+- [Request analytics](./docs/analytics/overview.md)
+- [Activity events](./docs/events/overview.md)
+- [Operational tasks](./docs/about/tasks.md)
+- [Database](./docs/about/database.md)
 - [Frontend development](./docs/about/frontend.md)
 - [Release notes](https://github.com/LesliTech/LesliAudit/releases)
 - [Issue tracker](https://github.com/LesliTech/LesliAudit/issues)