audit_log_rails 0.1.0

data/lib/generators/audit_logger/install_generator.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+require "rails/generators/active_record"
+
+module AuditLogger
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      include ActiveRecord::Generators::Migration
+
+      source_root File.expand_path("templates", __dir__)
+      desc "Cria a migration inicial e o initializer base do AuditLogger."
+
+      def copy_migration
+        migration_template "create_audit_logs.rb.tt", "db/migrate/create_audit_logs.rb"
+      end
+
+      def copy_initializer
+        template "audit_logger_initializer.rb.tt", "config/initializers/audit_logger.rb"
+      end
+
+      private
+
+      def migration_version
+        "[#{ActiveRecord::VERSION::STRING.to_f}]"
+      end
+
+      def self.next_migration_number(path)
+        ActiveRecord::Generators::Base.next_migration_number(path)
+      end
+    end
+  end
+end

data/lib/generators/audit_logger/templates/audit_logger_initializer.rb.tt

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+# Configuracao base da gem de auditoria.
+# Ajuste os resolvers conforme o contexto do projeto cliente.
+AuditLogger.configure do |config|
+  # Resolve o identificador principal do ator que executou a acao.
+  # Descomente e ajuste conforme o projeto.
+  # Exemplo:
+  # config.changed_by_id_resolver = -> { Current.user&.id }
+
+  # Resolve o tipo, perfil ou classe do ator que executou a acao.
+  # Descomente e ajuste conforme o projeto.
+  # Exemplo:
+  # config.changed_by_type_resolver = -> { Current.user&.class&.name }
+
+  # Armazena metadados extras do ator e da requisicao em JSON.
+  # Descomente e ajuste conforme o projeto.
+  # Exemplo:
+  # config.changed_by_other_resolver = lambda do
+  #   {
+  #     name: Current.user&.name,
+  #     email: Current.user&.email
+  #   }.compact
+  # end
+
+  # Permite correlacionar eventos da mesma sessao ou fluxo.
+  # Se nada for configurado aqui, a gem gera um UUID automaticamente.
+  # Exemplo:
+  # config.uuid_resolver = -> { Current.audit_uuid }
+
+  # Mantem o IP em coluna propria para facilitar consulta.
+  # Descomente e ajuste conforme o projeto.
+  # Exemplo:
+  # config.ip_resolver = -> { Current.request&.remote_ip }
+
+  # Habilita a humanizacao por padrao.
+  config.humanize_by_default = true
+
+  # Escopos padrao usados para localizar traducoes via I18n.
+  config.i18n_scopes = ["activerecord.attributes", "attributes"]
+
+  # Campos que normalmente nao agregam valor na auditoria.
+  config.ignored_attributes = [:created_at, :updated_at, :lock_version]
+
+  # Humanizer opcional.
+  # Se retornar nil, a gem usa o fallback padrao baseado em I18n.
+  config.humanizer = ->(_model_klass, _attribute, _old_value, _new_value) { nil }
+end

data/lib/generators/audit_logger/templates/create_audit_logs.rb.tt

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+class CreateAuditLogs < ActiveRecord::Migration<%= migration_version %>
+  def up
+    unless table_exists?(:audit_logs)
+      create_table :audit_logs do |t|
+        t.string :model_class_name, null: false
+        t.string :id_object, null: false
+        t.string :action, null: false
+        t.string :uuid, null: false
+        t.bigint :changed_by_id
+        t.string :changed_by_type
+        t.jsonb :changed_by_other, null: false, default: {}
+        t.jsonb :audited_changes, null: false, default: {}
+        t.jsonb :audited_changes_humanize, null: false, default: {}
+        t.string :ip_remote
+        t.datetime :deleted_at
+        t.timestamps
+      end
+      add_index :audit_logs, :uuid
+      add_index :audit_logs, [:model_class_name, :id_object]
+      add_index :audit_logs, :action
+      add_index :audit_logs, [:changed_by_type, :changed_by_id]
+      add_index :audit_logs, :created_at
+      add_index :audit_logs, :deleted_at
+    end
+  end
+
+  def down
+    drop_table :audit_logs if table_exists?(:audit_logs)
+  end
+end

data/sig/audit_logger.rbs

@@ -0,0 +1,4 @@
+module AuditLogger
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,107 @@
+--- !ruby/object:Gem::Specification
+name: audit_log_rails
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- DHC soluções
+bindir: exe
+cert_chain: []
+date: 2026-05-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+description: AuditLogger registra eventos de create, update e destroy em tabela propria,
+  com payload bruto, payload humanizado e configuracao flexivel por initializer.
+email:
+- dhcsolucoesinformatica@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/audit_logger.rb
+- lib/audit_logger/actor_context_resolver.rb
+- lib/audit_logger/audit_log.rb
+- lib/audit_logger/auditable.rb
+- lib/audit_logger/change_extractor.rb
+- lib/audit_logger/config_validator.rb
+- lib/audit_logger/configuration.rb
+- lib/audit_logger/humanizer.rb
+- lib/audit_logger/model_config.rb
+- lib/audit_logger/railtie.rb
+- lib/audit_logger/record_audit_entry.rb
+- lib/audit_logger/version.rb
+- lib/generators/audit_logger/install_generator.rb
+- lib/generators/audit_logger/templates/audit_logger_initializer.rb.tt
+- lib/generators/audit_logger/templates/create_audit_logs.rb.tt
+- sig/audit_logger.rbs
+homepage: https://github.com/hcortezia/audit_log_rails
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/hcortezia/audit_log_rails
+  source_code_uri: https://github.com/hcortezia/audit_log_rails
+  changelog_uri: https://github.com/hcortezia/audit_log_rails/blob/main/CHANGELOG.md
+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.2
+specification_version: 4
+summary: Gem Rails para auditoria de models ActiveRecord
+test_files: []