lesli_audit 1.1.0 → 1.1.2

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,12 +1,7 @@
-require "useragent"
 module LesliAudit
     class Engine < ::Rails::Engine
         isolate_namespace LesliAudit
-
-        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.0"
-    BUILD = "1778638613"
+    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

@@ -1,14 +1,15 @@
 <div align="center">
-    <img width="100" alt="LesliAudit logo" src="./app/assets/images/lesli_audit/audit-logo.svg" />
-    <h3 align="center">Activity, logs, security and more... for the Lesli Framework.</h3>
+    <h1 align="center">
+        <img width="100" alt="LesliAudit" src="./app/assets/images/lesli_audit/audit-logo.svg" />
+    </h1>
+    <h3 align="center">Audit trails and analytics for the Lesli Framework.</h3>
 </div>
 
 <br />
-<hr/>
 
 <div align="center">
-    <a target="_blank" href="https://github.com/LesliTech/LesliAudit/actions">
-        <img alt="Tests passing" src="https://img.shields.io/badge/Tests-passing-green?style=for-the-badge&logo=github">
+    <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">
@@ -16,83 +17,162 @@
     <a target="_blank" href="https://codecov.io/github/LesliTech/LesliAudit">
         <img alt="Codecov" src="https://img.shields.io/codecov/c/github/LesliTech/LesliAudit?style=for-the-badge&logo=codecov">
     </a>
+    <a target="_blank" href="https://sonarcloud.io/project/overview?id=LesliTech_LesliAudit">
+        <img alt="Sonar Quality Gate" src="https://img.shields.io/sonar/quality_gate/LesliTech_LesliAudit?server=https%3A%2F%2Fsonarcloud.io&style=for-the-badge&logo=sonarqubecloud&label=Quality">
+    </a>
 </div>
 
-<hr/>
 <br />
 
 <div align="center">
     <img
         style="width:100%;max-width:800px;border-radius:6px;"
-        alt="Lesli screenshot" src="./docs/images/screenshot.png" />
+        alt="LesliAudit activity and request history"
+        src="./docs/images/screenshot.png" />
 </div>
 
+---
+
+<br />
+
+## Introduction
+
+LesliAudit is the official audit trail and analytics engine for the [Lesli Framework](https://github.com/LesliTech/Lesli).
+
+It records account activity and provides administrators with searchable operational history and usage insights.
+
 <br />
-<hr/>
+
+## Features
+
+- Account activity and audit logs
+- Request and navigation history
+- 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 />
 
-### Installation
+## Try LesliAudit
+
+- [Try the online demo](https://demo.lesli.dev/)
+- [Run the Docker demo](https://github.com/LesliTech/lesli-docker-demo)
+
+<br />
+
+## Quick Start
+
+### Requirements
+
+- 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
+
+Add the engine to the host Rails application and prepare its database:
 
 ```shell
-# Add LesliAudit engine gem
 bundle add lesli_audit
+bin/rails lesli:db:prepare
+```
+
+### Mount the engine
 
-# Setup & initialize the database
-rake lesli:db:setup
+Applications using Lesli's standard router mount LesliAudit automatically at `/audit`:
+
+```ruby
+# config/routes.rb
+Rails.application.routes.draw do
+    Lesli::Router.mount(self)
+end
 ```
 
+If the application does not use the standard Lesli router, mount the engine directly:
+
 ```ruby
-# Load LesliAudit engine
+# config/routes.rb
 Rails.application.routes.draw do
     mount LesliAudit::Engine => "/audit"
 end
 ```
 
-<br />
-<hr/>
+Start Rails and visit [http://127.0.0.1:3000/audit](http://127.0.0.1:3000/audit):
+
+```shell
+bin/rails server
+```
+
 <br />
 
-### Development 
+## Development
+
+Clone LesliAudit into the host application's `engines` directory:
 
 ```shell
-# clone the lesli repo inside your engine folder: RailsApp/engines
-git clone https://github.com/LesliTech/LesliAudit.git
+cd RailsApp
+mkdir -p engines
+git clone https://github.com/LesliTech/LesliAudit.git engines/LesliAudit
+```
 
-# Load LesliAudit as a Gem
-gem "lesli", path: "engines/LesliAudit"
+Reference the local engine from the host application's `Gemfile`:
 
-# Install the necessary Gems to run LesliAudit
-bundle install
+```ruby
+gem "lesli_audit", path: "engines/LesliAudit"
+```
 
-# Setup & initialize the database
-rake lesli:db:setup
+Install dependencies, prepare the host database, and start Rails:
 
+```shell
+bundle install
+bin/rails lesli:db:prepare
+bin/rails server
 ```
 
-<br />
-<hr/>
-<br />
+### Tests
 
-### Demo
+From a complete Lesli development workspace, run the engine test suite from the LesliAudit directory:
 
-* [online demo](https://demo.lesli.dev/)
-* [docker demo](https://github.com/LesliTech/lesli-docker-demo)
+```shell
+cd engines/LesliAudit
+bin/rails test
+```
 
+<br />
 
-### Documentation
-* [website](https://www.lesli.dev/)
-* [documentation](https://www.lesli.dev/engines/audit)
+## Documentation
+
+- [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)
+- [Source code](https://github.com/LesliTech/LesliAudit)
 
+<br />
 
-### Connect with Lesli
+## Community
 
-* [X: @LesliTech](https://x.com/LesliTech)
-* [Email: hello@lesli.tech](hello@lesli.tech)
-* [Website: https://www.lesli.tech](https://www.lesli.tech)
+- [X: @LesliTech](https://x.com/LesliTech)
+- [hello@lesli.tech](mailto:hello@lesli.tech)
+- [https://www.lesli.tech](https://www.lesli.tech)
 
+<br />
+
+## License
 
-### License
--------
 Copyright (c) 2026, Lesli Technologies, S. A.
 
 This program is free software: you can redistribute it and/or modify
@@ -106,19 +186,16 @@ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
-along with this program. If not, see http://www.gnu.org/licenses/.
+along with this program. If not, see [https://www.gnu.org/licenses/](https://www.gnu.org/licenses/).
 
-<br />
-<hr />
-<br />
-<br />
+The complete license text is available in the [license file](./license).
 
-<div align="center" class="has-text-centered">
-    <img width="200" alt="Lesli logo" src="https://cdn.lesli.tech/lesli/brand/app-logo.svg" />
-    <h3 align="center" class="mt-0">
-        The Open-Source SaaS Development Framework for Ruby on Rails.
-    </h3>
-</div>
+---
 
 <br />
 <br />
+
+<div align="center">
+    <img width="80" alt="Lesli icon" src="https://cdn.lesli.tech/lesli/brand/app-icon.svg" />
+    <h3 align="center">The Open-Source SaaS Development Framework for Ruby on Rails.</h3>
+</div>

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lesli_audit
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.1.2
 platform: ruby
 authors:
 - The Lesli Development Team
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-10-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lesli
@@ -64,7 +65,9 @@ files:
 - app/helpers/lesli_audit/users_helper.rb
 - app/interfaces/lesli_audit/logger_interface.rb
 - app/jobs/lesli_audit/application_job.rb
+- app/jobs/lesli_audit/retention_cleanup_job.rb
 - app/mailers/lesli_audit/application_mailer.rb
+- app/models/concerns/lesli_audit/append_only.rb
 - app/models/lesli_audit/account.rb
 - app/models/lesli_audit/account_device.rb
 - app/models/lesli_audit/account_log.rb
@@ -74,8 +77,11 @@ files:
 - app/models/lesli_audit/user_journal.rb
 - app/models/lesli_audit/user_log.rb
 - app/models/lesli_audit/user_request.rb
+- app/services/lesli_audit/activity_audit.rb
 - app/services/lesli_audit/log_service.rb
 - app/services/lesli_audit/request_service.rb
+- app/services/lesli_audit/retention_cleanup.rb
+- app/services/lesli_audit/user_agent_parser.rb
 - app/services/lesli_audit/user_service.rb
 - app/services/lesli_audit/visitor_service.rb
 - app/views/lesli_audit/dashboards/_component-calendar.html.erb
@@ -118,8 +124,11 @@ licenses:
 - GPL-3.0
 metadata:
   homepage_uri: https://www.lesli.dev/
-  changelog_uri: https://github.com/LesliTech/LesliAudit
+  changelog_uri: https://github.com/LesliTech/LesliAudit/releases
   source_code_uri: https://github.com/LesliTech/LesliAudit
+  bug_tracker_uri: https://github.com/LesliTech/LesliAudit/issues
+  documentation_uri: https://www.lesli.dev/engines/audit/
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -134,7 +143,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 3.5.16
+signing_key:
 specification_version: 4
 summary: Logs Activities & Analytics for The Lesli Framework
 test_files: []