paper_trail_history 0.1.0

data/app/views/paper_trail_history/versions/show.html.erb

@@ -0,0 +1,134 @@
+<nav aria-label="breadcrumb">
+  <ol class="breadcrumb">
+    <li class="breadcrumb-item"><%= link_to "Models", models_path %></li>
+    <li class="breadcrumb-item"><%= link_to @trackable_model.human_name, model_path(@trackable_model.name) %></li>
+    <li class="breadcrumb-item active">Version #<%= @version.id %></li>
+  </ol>
+</nav>
+
+<div class="d-flex justify-content-between align-items-center mb-4">
+  <h1>Version Details</h1>
+  <div>
+    <% if @decorated_version.can_restore? %>
+      <%= link_to "Restore This Version", 
+          restore_version_path(@version), 
+          method: :patch,
+          data: { 
+            confirm: "Are you sure you want to restore this version? This will overwrite the current data." 
+          },
+          class: "btn btn-warning" %>
+    <% end %>
+    <%= link_to "View Record", model_record_path(@trackable_model.name, @version.item_id), class: "btn btn-outline-primary" %>
+  </div>
+</div>
+
+<div class="row">
+  <div class="col-md-6 mb-4">
+    <div class="card">
+      <div class="card-body">
+        <h5 class="card-title">Version Information</h5>
+        <dl class="row">
+          <dt class="col-sm-4">Version ID:</dt>
+          <dd class="col-sm-8"><code><%= @version.id %></code></dd>
+          
+          <dt class="col-sm-4">Event:</dt>
+          <dd class="col-sm-8">
+            <span class="badge bg-<%= @decorated_version.event_class %>">
+              <i class="bi bi-<%= @decorated_version.event == 'create' ? 'plus' : @decorated_version.event == 'update' ? 'pencil' : 'trash' %>"></i>
+              <%= @decorated_version.event_label %>
+            </span>
+          </dd>
+          
+          <dt class="col-sm-4">When:</dt>
+          <dd class="col-sm-8"><%= @decorated_version.formatted_created_at %></dd>
+          
+          <dt class="col-sm-4">Who:</dt>
+          <dd class="col-sm-8"><%= @decorated_version.whodunnit_display %></dd>
+          
+          <dt class="col-sm-4">Item:</dt>
+          <dd class="col-sm-8">
+            <%= link_to @decorated_version.item_display_name, 
+                model_record_path(@trackable_model.name, @version.item_id),
+                class: "text-decoration-none" %>
+          </dd>
+        </dl>
+      </div>
+    </div>
+  </div>
+
+  <div class="col-md-6 mb-4">
+    <% if @decorated_version.can_restore? %>
+      <div class="card border-warning">
+        <div class="card-body">
+          <h5 class="card-title text-warning">
+            <i class="bi bi-exclamation-triangle"></i>
+            Restore Version
+          </h5>
+          <p class="card-text">
+            This will restore the record to the state it was in at this version.
+            <strong>This action cannot be undone</strong>, but will create a new version entry.
+          </p>
+          <%= link_to "Restore This Version", 
+              restore_version_path(@version), 
+              method: :patch,
+              data: { 
+                confirm: "Are you sure you want to restore this version? This will overwrite the current data and cannot be undone." 
+              },
+              class: "btn btn-warning" %>
+        </div>
+      </div>
+    <% else %>
+      <div class="card border-secondary">
+        <div class="card-body">
+          <h5 class="card-title text-muted">
+            <i class="bi bi-info-circle"></i>
+            Cannot Restore
+          </h5>
+          <p class="card-text text-muted">
+            This version represents the initial creation of the record and cannot be restored.
+          </p>
+        </div>
+      </div>
+    <% end %>
+  </div>
+</div>
+
+<% if @decorated_version.changed_attributes.any? %>
+  <div class="card">
+    <div class="card-header">
+      <h5 class="mb-0">
+        <i class="bi bi-code-square"></i>
+        Changes Made
+      </h5>
+    </div>
+    <div class="card-body">
+      <div class="diff-container">
+        <% @decorated_version.changed_attributes.each do |change| %>
+          <div class="diff-section mb-4">
+            <div class="diff-header">
+              <i class="bi bi-at"></i>
+              <strong><%= change[:attribute] %></strong>
+            </div>
+            <div class="diff-content">
+              <div class="diff-line diff-removed">
+                <span class="diff-marker">-</span>
+                <code><%= change[:old_value] %></code>
+              </div>
+              <div class="diff-line diff-added">
+                <span class="diff-marker">+</span>
+                <code><%= change[:new_value] %></code>
+              </div>
+            </div>
+          </div>
+        <% end %>
+      </div>
+    </div>
+  </div>
+<% else %>
+  <div class="card">
+    <div class="card-body text-center text-muted">
+      <i class="bi bi-info-circle"></i>
+      No detailed change information available for this version.
+    </div>
+  </div>
+<% end %>

data/config/locales/de.yml

@@ -0,0 +1,16 @@
+de:
+  paper_trail_history:
+    errors:
+      version_not_found: "Version nicht gefunden"
+      model_not_found: "Modell '%{model_name}' nicht gefunden oder nicht verfolgbar"
+      restore_failed: "Wiederherstellung fehlgeschlagen: %{error}"
+      cannot_restore_create: "Erstell-Ereignisse können nicht wiederhergestellt werden"
+    messages:
+      restore_from_deletion: "Datensatz aus Löschung wiederhergestellt"
+      restore_to_previous: "Datensatz auf vorherige Version wiederhergestellt"
+    events:
+      created: "Erstellt"
+      updated: "Aktualisiert"
+      deleted: "Gelöscht"
+    actors:
+      system: "System"

data/config/locales/en.yml

@@ -0,0 +1,16 @@
+en:
+  paper_trail_history:
+    errors:
+      version_not_found: "Version not found"
+      model_not_found: "Model '%{model_name}' not found or not trackable"
+      restore_failed: "Failed to restore: %{error}"
+      cannot_restore_create: "Cannot restore create events"
+    messages:
+      restore_from_deletion: "Record restored from deletion"
+      restore_to_previous: "Record restored to previous version"
+    events:
+      created: "Created"
+      updated: "Updated" 
+      deleted: "Deleted"
+    actors:
+      system: "System"

data/config/routes.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+PaperTrailHistory::Engine.routes.draw do
+  root 'models#index'
+
+  resources :models, only: %i[index show], param: :name do
+    member do
+      get :versions
+    end
+
+    resources :records, only: [:show], param: :record_id do
+      member do
+        get :versions
+      end
+    end
+  end
+
+  resources :versions, only: [:show] do
+    member do
+      patch :restore
+    end
+  end
+end

data/lib/paper_trail_history/engine.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module PaperTrailHistory
+  # Engine to integrate PaperTrailHistory into a Rails application.
+  class Engine < ::Rails::Engine
+    isolate_namespace PaperTrailHistory
+  end
+end

data/lib/paper_trail_history/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module PaperTrailHistory
+  VERSION = '0.1.0'
+end

data/lib/paper_trail_history.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'paper_trail'
+require 'paper_trail_history/version'
+require 'paper_trail_history/engine'
+
+# PaperTrailHistory is a Ruby on Rails engine that provides a history of changes made to models using
+# the PaperTrail gem. It allows you to track changes, view previous versions of records, and restore them if needed.
+#
+# This engine integrates with the PaperTrail gem to provide a user-friendly interface for viewing and managing
+# the history of changes made to your models. It includes routes, controllers, and views to display the history
+# of changes in a structured manner.
+module PaperTrailHistory
+  # Your code goes here...
+end

data/lib/tasks/paper_trail_history_tasks.rake

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# desc "Explaining what the task does"
+# task :paper_trail_history do
+#   # Task goes here
+# end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: paper_trail_history
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Benjamin Deutscher
+bindir: bin
+cert_chain: []
+date: 2025-08-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: paper_trail
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '15.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '15.0'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.2'
+description: |
+  PaperTrailHistory is a mountable Rails engine that provides a comprehensive web interface for viewing, searching,
+  and managing audit trail versions created by the PaperTrail gem. Features include listing trackable models,
+  browsing version history, filtering and searching changes, and restoring previous versions of records.
+email:
+- ben@bdeutscher.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/assets/stylesheets/paper_trail_history/application.css
+- app/controllers/paper_trail_history/application_controller.rb
+- app/controllers/paper_trail_history/models_controller.rb
+- app/controllers/paper_trail_history/records_controller.rb
+- app/controllers/paper_trail_history/versions_controller.rb
+- app/helpers/paper_trail_history/application_helper.rb
+- app/jobs/paper_trail_history/application_job.rb
+- app/mailers/paper_trail_history/application_mailer.rb
+- app/models/paper_trail_history/application_record.rb
+- app/models/paper_trail_history/trackable_model.rb
+- app/models/paper_trail_history/version_decorator.rb
+- app/models/paper_trail_history/version_service.rb
+- app/views/layouts/paper_trail_history/application.html.erb
+- app/views/paper_trail_history/models/index.html.erb
+- app/views/paper_trail_history/models/show.html.erb
+- app/views/paper_trail_history/models/versions.html.erb
+- app/views/paper_trail_history/records/show.html.erb
+- app/views/paper_trail_history/records/versions.html.erb
+- app/views/paper_trail_history/shared/_version_filters.html.erb
+- app/views/paper_trail_history/shared/_versions_table.html.erb
+- app/views/paper_trail_history/versions/show.html.erb
+- config/locales/de.yml
+- config/locales/en.yml
+- config/routes.rb
+- lib/paper_trail_history.rb
+- lib/paper_trail_history/engine.rb
+- lib/paper_trail_history/version.rb
+- lib/tasks/paper_trail_history_tasks.rake
+homepage: https://github.com/its-bede/paper_trail_history
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/its-bede/paper_trail_history
+  source_code_uri: https://github.com/its-bede/paper_trail_history
+  changelog_uri: https://github.com/its-bede/paper_trail_history/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.6
+specification_version: 4
+summary: A Rails engine providing a web interface for managing PaperTrail versions.
+test_files: []