activeadmin-audit 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 2eea25e963a62183de6ecfa5dbbb1ccdf1fe5fd2
+  data.tar.gz: 26600c5639afb004e950447a9104c9a8600ae083
+SHA512:
+  metadata.gz: 50af6f9fb5257b18c7845fd982aea7a3a618f7b5e0648799f538edb7f4afbf7b213efef0f5f15ed9aff11d141ddeeb5b46f8eb103072a4d5956097e0de4bbe5d
+  data.tar.gz: b63c0beff362edc36238acb03e9b3a48a812982969bfd24605b3e65597ded857f2db5da579ef4247a3bedb24d07ba733d0fc0118439172973b24f404a4532bde

data/.gitignore

@@ -0,0 +1,13 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/dummy/tmp/
+/spec/dummy/public/assets
+/spec/dummy/.sass-cache
+/spec/dummy/log
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require rails_helper

data/.travis.yml

@@ -0,0 +1,24 @@
+sudo: false
+language: ruby
+
+rvm:
+  - 2.1.5
+  - 2.2.4
+  - 2.3.1
+  - ruby-head
+
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+  fast_finish: true
+
+before_install: gem update --remote bundler
+install:
+  - bundle install --retry=3
+script:
+  - bundle exec rake dummy:prepare
+  - bundle exec rspec
+
+addons:
+  code_climate:
+    repo_token: fa6eecd14a238a6a4326b5b001bab6b0acf5170da237779800fa4935ad1c0026

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at aemelyanov@spbtv.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in activeadmin-audit.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 Alex Emelyanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,91 @@
+[![Gem Version](https://badge.fury.io/rb/activeadmin-audit.svg)](https://badge.fury.io/rb/activeadmin-audit)
+[![Build Status](https://travis-ci.org/holyketzer/activeadmin-audit.svg?branch=master)](https://travis-ci.org/holyketzer/activeadmin-audit)
+[![Code Climate](https://codeclimate.com/github/holyketzer/activeadmin-audit/badges/gpa.svg)](https://codeclimate.com/github/holyketzer/activeadmin-audit)
+[![Test Coverage](https://codeclimate.com/github/holyketzer/activeadmin-audit/badges/coverage.svg)](https://codeclimate.com/github/holyketzer/activeadmin-audit/coverage)
+
+# Activeadmin::Audit
+
+This gem allows you to track changes of records which done through ActiveAdmin panel. Also works with has_many relations
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'activeadmin-audit'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install activeadmin-audit
+
+## Usage
+
+Copy and apply migrations
+
+```bash
+rake active_admin_audit:install:migrations
+rake db:migrate
+```
+
+Include this line in your CSS code (active_admin.scss)
+
+```scss
+@import "activeadmin-audit";
+```
+
+Include this module in your `ApplicationController`
+
+```ruby
+class ApplicationController < ActionController::Base
+  include ActiveAdmin::Audit::ControllerHelper
+end
+```
+
+From model that you want to auditing call `has_versions` method 
+
+```ruby
+class Movie < ActiveRecord::Base
+  has_many :genres
+  has_many :images
+
+  has_versions skip: [:comment], also_include: {
+    genres: [:id],
+    images: [:url, :width, :height, :kind],
+  }
+```
+ 
+By default `has_versions` take care about all record attributes including belongs_to references. If you don't want to include some attribute you can pass it name to `skip` options. If you want to include has_many relation pass it's name with attributes to  `also_include` option.
+
+To display table with latest changes on the ActiveAdmin resource page use helper `latest_versions`:
+
+```ruby
+ActiveAdmin.register Movie do
+  # ...
+
+  show do |movie|
+    # ...
+    latest_versions(movie)
+  end
+end
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/[USERNAME]/activeadmin-audit. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).
+

data/Rakefile

@@ -0,0 +1,41 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require 'rdoc/task'
+
+RDoc::Task.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ActiveAdminAudit'
+  rdoc.options << '--line-numbers'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+
+load 'rails/tasks/engine.rake'
+load 'rails/tasks/statistics.rake'
+
+require 'bundler/gem_tasks'
+
+namespace :dummy do
+  desc 'Setup dummy app database'
+  task :prepare do
+    # File.expand_path is executed directory of generated Rails app
+    rakefile = File.expand_path('Rakefile', dummy_path)
+    command = "rake -f '%s' db:create db:schema:load RAILS_ENV=test" % rakefile
+    sh(command) unless ENV['DISABLE_CREATE']
+  end
+
+  def dummy_path
+    rel_path = ENV['DUMMY_APP_PATH'] || 'spec/dummy'
+    if @current_path.to_s.include?(rel_path)
+      @current_path
+    else
+      @current_path = File.expand_path(rel_path)
+    end
+  end
+end

data/activeadmin-audit.gemspec

@@ -0,0 +1,35 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'active_admin/audit/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'activeadmin-audit'
+  spec.version       = ActiveAdmin::Audit::VERSION
+  spec.authors       = ["Alex Emelyanov"]
+  spec.email         = ["aemelyanov@spbtv.com"]
+
+  spec.summary       = 'PaperTrail based audit for ActiveAdmin'
+  spec.description   = 'Allow to track changes of records which done through ActiveAdmin'
+  spec.homepage      = 'https://github.com/holyketzer/activeadmin-audit'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'activeadmin', '>= 1.0.0.pre1'
+  spec.add_dependency 'paper_trail', '~> 4.0.0'
+  spec.add_dependency 'rails', '>= 4.0.0'
+
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'codeclimate-test-reporter', '~> 0.4'
+  spec.add_development_dependency 'database_cleaner', '~> 1.5.0'
+  spec.add_development_dependency 'factory_girl_rails'
+  spec.add_development_dependency 'pg', '~> 0.18.1'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.3', '>= 3.3.0'
+  spec.add_development_dependency 'rspec-rails', '~> 3.3'
+  spec.add_development_dependency 'temping', '~> 3.7', '>= 3.3.0'
+end

data/app/admin/content_versions.rb

@@ -0,0 +1,56 @@
+ActiveAdmin.register ActiveAdmin::Audit::ContentVersion, as: 'ContentVersion' do
+  menu parent: 'System'
+
+  actions :index, :show
+
+  filter :item_type, input_html: { class: 'chosen' }, as: :select
+  filter :event, input_html: { class: 'chosen' }, as: :select
+  filter :whodunnit, input_html: { class: 'chosen' }, as: :select, collection: -> { AdminUser.all.map { |u| [u.email, u.id] } }
+  filter :created_at
+
+  index do
+    id_column
+    column :item
+    column :item_type
+    column :event
+    column :who
+    column :object_changes do |version|
+      version_attributes_diff(version.object_changes)
+    end
+    column :additional_objects_changes do |version|
+      version_attributes_diff(version.additional_objects_changes)
+    end
+    column :created_at
+    actions
+  end
+
+  show do |version|
+    panel version.item_type do
+      attributes_table_for version do
+        row :item
+        row :item_type
+        row :event
+        row :who
+        row :created_at
+      end
+    end
+
+    render partial: 'object_changes', locals: {
+      event: version.event,
+      object_changes: version.object_snapshot_changes,
+    }
+
+    render partial: 'additional_objects_changes', locals: {
+      event: version.event,
+      additional_objects_changes: version.additional_objects_snapshot_changes,
+    }
+
+    render partial: 'object_snapshot', locals: {
+      object_snapshot: version.object_snapshot,
+    }
+
+    render partial: 'additional_objects_snapshot', locals: {
+      additional_objects_snapshot: version.additional_objects_snapshot,
+    }
+  end
+end

data/app/assets/stylesheets/activeadmin-audit.css

@@ -0,0 +1,37 @@
+.diff {
+  background: #F4F4F4;
+  width: auto;
+
+  table, th, td {
+    border: 0.5px solid #aaa;
+  }
+
+  thead > tr > th {
+    background: #E4E4E4;
+    padding: 7px;
+    border-width: 0.5px 0.5px 2px;
+  }
+
+  .attr-name {
+    font-weight: bold;
+  }
+
+  .added {
+    background: #EEFFE7;
+    color: #3C763D;
+  }
+
+  .changed {
+    background: #FFFBE6;
+    color: #7D6C00;
+  }
+
+  .removed {
+    background: #FFF0F0;
+    color: #CD2929;
+  }
+
+  img {
+    width: 350px;
+  }
+}

data/app/models/active_admin/audit/content_version.rb

@@ -0,0 +1,48 @@
+module ActiveAdmin
+  module Audit
+    class ContentVersion < PaperTrail::Version
+      serialize :object, VersionSnapshot
+      serialize :object_changes, VersionSnapshot
+
+      serialize :additional_objects, VersionSnapshot
+      serialize :additional_objects_changes, VersionSnapshot
+
+      def object_changes
+       ignore = %w(id created_at updated_at)
+       super.reject { |k, _| ignore.include?(k) }
+      end
+
+      def object_snapshot
+        object.materialize(item_class)
+      end
+
+      def additional_objects_snapshot
+        additional_objects.materialize(item_class)
+      end
+
+      def object_snapshot_changes
+        object_changes.materialize(item_class)
+      end
+
+      def additional_objects_snapshot_changes
+        additional_objects_changes.materialize(item_class)
+      end
+
+      def who
+        AdminUser.find_by(id: whodunnit)
+      end
+
+      def item_class
+        item_type.constantize
+      rescue NameError
+        ActiveRecord::Base
+      end
+
+      def item
+        super
+      rescue NameError
+        nil
+      end
+    end
+  end
+end

data/app/views/admin/content_versions/_additional_objects_changes.html.slim

@@ -0,0 +1,26 @@
+- if additional_objects_changes.any?
+  h3 Related object changes
+  table.diff
+    thead: tr
+      th Attribute
+      th Removed
+      th Added
+    tbody
+      - additional_objects_changes.each do |attr, changes|
+        - added = changes['+']
+        - removed = changes['-']
+
+        - old_class, new_class = versions_diff_classes(removed, added)
+
+        tr
+          td.attr-name = attr.humanize
+          td class=old_class
+            - if removed
+              ul
+                - removed.each do |removed_item|
+                  li = pretty_version_attribute_value(attr, removed_item)
+          td class=new_class
+            - if added
+              ul
+                - added.each do |added_item|
+                  li = pretty_version_attribute_value(attr, added_item)

data/app/views/admin/content_versions/_additional_objects_snapshot.html.slim

@@ -0,0 +1,13 @@
+- if additional_objects_snapshot.any?
+  h3 Related objects snapshot
+  table.diff
+    thead: tr
+      th Attribute
+      th Value
+    tbody
+      - additional_objects_snapshot.each do |attr, values|
+        tr
+          td.attr-name = attr.humanize
+          td: ul
+            - values.each do |value|
+              li = pretty_version_attribute_value(attr, value)

data/app/views/admin/content_versions/_object_changes.html.slim

@@ -0,0 +1,16 @@
+- if object_changes.any?
+  h3 Object changes
+  table.diff
+    thead: tr
+      th Attribute
+      th Old value
+      th New value
+    tbody
+      - object_changes.each do |attr, diff|
+        - old_value, new_value = diff
+        - old_class, new_class = versions_diff_classes(old_value, new_value)
+
+        tr
+          td.attr-name = attr.humanize
+          td class=old_class = pretty_version_attribute_value(attr, old_value)
+          td class=new_class = pretty_version_attribute_value(attr, new_value)

data/app/views/admin/content_versions/_object_snapshot.html.slim

@@ -0,0 +1,11 @@
+- if object_snapshot.any?
+  h3 Object snapshot
+  table.diff
+    thead: tr
+      th = 'Attribute'
+      th = 'Value'
+    tbody
+      - object_snapshot.each do |attr, value|
+        tr
+          td.attr-name = attr.humanize
+          td = pretty_version_attribute_value(attr, value)

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "activeadmin/audit"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/rails

@@ -0,0 +1,13 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails gems
+# installed from the root of your application.
+
+ENGINE_ROOT = File.expand_path('../..', __FILE__)
+ENGINE_PATH = File.expand_path('../../lib/active_admin/audit/engine', __FILE__)
+
+# Set up gems listed in the Gemfile.
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../../Gemfile', __FILE__)
+require 'bundler/setup' if File.exist?(ENV['BUNDLE_GEMFILE'])
+
+require 'rails/all'
+require 'rails/engine/commands'

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/db/migrate/20141219113159_create_versions.rb

@@ -0,0 +1,16 @@
+class CreateVersions < ActiveRecord::Migration
+  def change
+    create_table :versions do |t|
+      t.string   :item_type, :null => false
+      t.integer  :item_id,   :null => false
+      t.string   :event,     :null => false
+      t.string   :whodunnit
+      t.text     :object
+      t.text     :object_changes
+      t.text     :additional_objects
+      t.text     :additional_objects_changes
+      t.datetime :created_at
+    end
+    add_index :versions, [:item_type, :item_id]
+  end
+end

data/lib/active_admin/audit.rb

@@ -0,0 +1,13 @@
+require 'active_admin'
+require 'active_admin/audit/version'
+require 'active_admin/audit/engine'
+require 'active_admin/audit/controller_helper'
+require 'active_admin/audit/has_versions'
+require 'active_admin/audit/version_snapshot'
+require 'active_admin/views/latest_versions'
+require 'active_admin/versions_helper'
+
+module ActiveAdmin
+  module Audit
+  end
+end

data/lib/active_admin/audit/controller_helper.rb

@@ -0,0 +1,13 @@
+module ActiveAdmin
+  module Audit
+    module ControllerHelper
+      def user_for_paper_trail
+        current_admin_user
+      end
+
+      def paper_trail_enabled_for_controller
+        request.fullpath.start_with?('/admin')
+      end
+    end
+  end
+end

data/lib/active_admin/audit/engine.rb

@@ -0,0 +1,26 @@
+require 'rails/engine'
+
+module ActiveAdmin
+  module Audit
+    class Engine < Rails::Engine
+      isolate_namespace ActiveAdmin::Audit
+
+      initializer 'load_config_initializers' do |app|
+        PaperTrail.serializer = PaperTrail::Serializers::JSON
+
+        app_path = File.expand_path('../../../../app/admin', __FILE__)
+        ActiveAdmin.application.load_paths.unshift(app_path)
+
+        module ActiveAdmin::ViewHelpers
+          include ActiveAdmin::VersionsHelper
+        end
+      end
+
+      initializer 'active_record.set_configs' do
+        ActiveSupport.on_load(:active_record) do
+          include ActiveAdmin::Audit::HasVersions
+        end
+      end
+    end
+  end
+end

data/lib/active_admin/audit/has_versions.rb

@@ -0,0 +1,133 @@
+require 'paper_trail'
+
+module ActiveAdmin
+  module Audit
+    module HasVersions
+      extend ActiveSupport::Concern
+
+      module ClassMethods
+        def has_versions(options = {})
+          options[:also_include] ||= {}
+          options[:skip] ||= []
+          options[:skip] += options[:also_include].keys
+          if respond_to?(:translated_attrs)
+            options[:skip] += translated_attrs.map { |attr| "#{attr}_translations" }
+          end
+
+          has_paper_trail options.merge(on: [:nothing], class_name: 'ActiveAdmin::Audit::ContentVersion', meta: {
+            additional_objects: ->(record) { record.additional_objects_snapshot.to_json },
+            additional_objects_changes: ->(record) { record.additional_objects_snapshot_changes.to_json },
+          })
+
+          class_eval do
+            define_method(:additional_objects_snapshot) do
+              options[:also_include].each_with_object(VersionSnapshot.new) do |(attr, scheme), snapshot|
+                snapshot[attr] =
+                  if scheme.is_a? Symbol
+                    send(scheme)
+                  elsif scheme.empty?
+                    send(attr)
+                  else
+                    Array(send(attr)).map do |item|
+                      scheme.each_with_object({}) do |item_attr, item_snapshot|
+                        item_snapshot[item_attr] = item.send(item_attr)
+                      end
+                    end
+                  end
+              end
+            end
+
+            # Will save new version of the object
+            after_commit do
+              if paper_trail_switched_on?
+                if @event_for_paper_trail
+                  generate_version!
+                end
+              end
+            end
+
+            options_on = Array(options.fetch(:on, [:create, :update, :destroy]))
+
+            if options_on.include?(:create)
+              after_create do
+                if paper_trail_switched_on?
+                  @event_for_paper_trail = 'create'
+                end
+              end
+            end
+
+            if options_on.include?(:update)
+              # Cache object changes to access it from after_commit
+              after_update do
+                if paper_trail_switched_on?
+                  @event_for_paper_trail = 'update'
+                  cache_version_object_changes
+                end
+              end
+            end
+
+            if options_on.include?(:destroy)
+              # Cache all details to access it from after_commit
+              before_destroy do
+                if paper_trail_switched_on?
+                  @event_for_paper_trail = 'destroy'
+                  cache_version_object
+                  cache_version_object_changes
+                  cache_version_additional_objects_and_changes
+                end
+              end
+            end
+          end
+        end
+      end
+
+      def latest_versions(count = 5)
+        versions.reorder(created_at: :desc).limit(count).rewhere(item_type: self.class.name)
+      end
+
+      def additional_objects_snapshot_changes
+        prev_version = versions.last
+
+        old_snapshot = prev_version.try(:additional_objects) || VersionSnapshot.new
+        new_snapshot = additional_objects_snapshot
+
+        old_snapshot.diff(new_snapshot)
+      end
+
+      private
+
+      def cache_version_object
+        @version_object_cache ||= object_attrs_for_paper_trail(self.attributes)
+      end
+
+      def cache_version_object_changes
+        @version_object_changes_cache ||= changes_for_paper_trail
+      end
+
+      def cache_version_additional_objects_and_changes
+        @version_additional_objects_and_changes_cache ||= merge_metadata({})
+      end
+
+      def clear_version_cache
+        @version_object_cache = nil
+        @version_object_changes_cache = nil
+        @version_additional_objects_and_changes_cache = nil
+      end
+
+      def generate_version!
+        data = {
+          event: @event_for_paper_trail,
+          object: cache_version_object.to_json,
+          object_changes: cache_version_object_changes.to_json,
+          whodunnit: PaperTrail.whodunnit.try(:id),
+          item_type: self.class.name,
+          item_id: id,
+        }
+
+        PaperTrail::Version.create! data.merge!(cache_version_additional_objects_and_changes)
+
+        clear_version_cache
+      end
+    end
+  end
+end

data/lib/active_admin/audit/version.rb

@@ -0,0 +1,5 @@
+module ActiveAdmin
+  module Audit
+    VERSION = '0.1.0'
+  end
+end

data/lib/active_admin/audit/version_snapshot.rb

@@ -0,0 +1,80 @@
+module ActiveAdmin
+  module Audit
+    class VersionSnapshot < HashWithIndifferentAccess
+      def self.dump(snapshot)
+        snapshot.to_json
+      end
+
+      def self.load(string)
+        self[JSON.parse(string || '{}')]
+      end
+
+      def diff(other_snapshot)
+        keys = (self.keys + other_snapshot.keys).uniq
+
+        keys.each_with_object({}) do |key, diff|
+          old_value = self[key]
+          new_value = other_snapshot[key]
+
+          if old_value.class == new_value.class
+            item_diff = {}
+
+            added = new_value - old_value
+            item_diff[:+] = added unless added.empty?
+
+            removed = old_value - new_value
+            item_diff[:-] = removed unless removed.empty?
+
+            diff[key] = item_diff unless item_diff.empty?
+          end
+        end
+      end
+
+      def materialize(klass)
+        each do |attr, values|
+          self[attr] =
+            if values.is_a? Array
+              # array of any values
+              values.map { |value| materialize_item(klass, attr, value) }
+            elsif values.is_a? Hash
+              # hash with diff in '+'/'-'
+              values.each do |k, items|
+                values[k] = items.map { |value| materialize_item(klass, attr, value) }
+              end
+            else
+              # any values
+              materialize_item(klass, attr, values)
+            end
+        end
+      end
+
+      private
+
+      def materialize_item(klass, attr, value)
+        if (association = klass.reflect_on_all_associations.find { |a| [a.foreign_key, a.plural_name, a.name.to_s].include?(attr) })
+          # attr is association in klass
+          if value.is_a?(Hash)
+            if value.size == 1 && value.keys.first.to_s == association.klass.primary_key.to_s
+              # has_many/has_one
+              materialize_record_value(association.klass, value.values.first)
+            else
+              # nested item
+              value.each do |key, v|
+                value[key] = materialize_item(association.klass, key, v)
+              end
+            end
+          elsif value.is_a?(Integer) || value =~ /\d+/
+            # belongs_to
+            materialize_record_value(association.klass, value)
+          end
+        else
+          value
+        end
+      end
+
+      def materialize_record_value(klass, value)
+        klass.find_by(id: value) || "#{klass} ##{value} was removed"
+      end
+    end
+  end
+end

data/lib/active_admin/versions_helper.rb

@@ -0,0 +1,55 @@
+module ActiveAdmin
+  module VersionsHelper
+    BOOLEAN_VALUES = [true, false].freeze
+
+    def pretty_version_attribute_value(attr, value)
+      case value
+      when Array
+        Arbre::Context.new(context: self) do
+          text_node attr.humanize.singularize
+          ul do
+            value.each do |v|
+              li { context.pretty_version_attribute_value(attr, v).html_safe }
+            end
+          end
+        end.to_s
+      when Hash
+        Arbre::Context.new(context: self) do
+          text_node attr.humanize.singularize
+          ul do
+            value.each do |k, v|
+              li { "#{k.humanize}: #{context.pretty_version_attribute_value(k, v)}".html_safe }
+            end
+          end
+        end.to_s
+      when /\.(jpg|png|gif)\z/i
+        image_tag value
+      when ActiveRecord::Base
+        pretty_format(value)
+      else
+        value
+      end
+    end
+
+    def version_attributes_diff(changes)
+      Arbre::Context.new do
+        ul do
+          changes.keys.sort.each { |attr| li(attr.humanize) }
+        end
+      end.to_s
+    end
+
+    def versions_diff_classes(removed, added)
+      if (added.present? && removed.present?) || (BOOLEAN_VALUES.include?(added) && BOOLEAN_VALUES.include?(removed))
+        old_class = 'changed'
+        new_class = old_class
+      elsif added.present? || BOOLEAN_VALUES.include?(added)
+        new_class = 'added'
+      elsif removed.present? || BOOLEAN_VALUES.include?(removed)
+        old_class = 'removed'
+      end
+
+      [old_class, new_class]
+    end
+  end
+end

data/lib/active_admin/views/latest_versions.rb

@@ -0,0 +1,34 @@
+module ActiveAdmin
+  module Views
+    class LatestVersions < ActiveAdmin::Component
+      builder_method :latest_versions
+
+      def build(resource, _attributes = {})
+        panel 'Latest versions' do
+          table_for resource.latest_versions do
+            column :id
+            column :event
+            column :who
+            column :object_changes do |version|
+              version_attributes_diff(version.object_changes)
+            end
+            column :additional_objects_changes do |version|
+              version_attributes_diff(version.additional_objects_changes)
+            end
+            column :created_at
+            column :actions do |version|
+              link_to 'View', admin_content_version_path(version)
+            end
+          end
+
+          div do
+            link_to 'View all versions', admin_content_versions_path({
+              'q[item_type_eq]' => resource.class.name,
+              'q[item_id_eq]' => resource.id,
+            })
+          end
+        end
+      end
+    end
+  end
+end

data/lib/activeadmin/audit.rb

@@ -0,0 +1 @@
+require 'active_admin/audit'

metadata

@@ -0,0 +1,253 @@
+--- !ruby/object:Gem::Specification
+name: activeadmin-audit
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Alex Emelyanov
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2016-09-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activeadmin
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0.pre1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.0.0.pre1
+- !ruby/object:Gem::Dependency
+  name: paper_trail
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 4.0.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: codeclimate-test-reporter
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.4'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.5.0
+- !ruby/object:Gem::Dependency
+  name: factory_girl_rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pg
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: temping
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.3.0
+description: Allow to track changes of records which done through ActiveAdmin
+email:
+- aemelyanov@spbtv.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CODE_OF_CONDUCT.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- activeadmin-audit.gemspec
+- app/admin/content_versions.rb
+- app/assets/stylesheets/activeadmin-audit.css
+- app/models/active_admin/audit/content_version.rb
+- app/views/admin/content_versions/_additional_objects_changes.html.slim
+- app/views/admin/content_versions/_additional_objects_snapshot.html.slim
+- app/views/admin/content_versions/_object_changes.html.slim
+- app/views/admin/content_versions/_object_snapshot.html.slim
+- bin/console
+- bin/rails
+- bin/setup
+- db/migrate/20141219113159_create_versions.rb
+- lib/active_admin/audit.rb
+- lib/active_admin/audit/controller_helper.rb
+- lib/active_admin/audit/engine.rb
+- lib/active_admin/audit/has_versions.rb
+- lib/active_admin/audit/version.rb
+- lib/active_admin/audit/version_snapshot.rb
+- lib/active_admin/versions_helper.rb
+- lib/active_admin/views/latest_versions.rb
+- lib/activeadmin/audit.rb
+homepage: https://github.com/holyketzer/activeadmin-audit
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: PaperTrail based audit for ActiveAdmin
+test_files: []