paper-trail-gem/paper_trail

Features

• Record State Versioning - Implements record-level value versioning to allow developers to compare differences and revert to previous data states.
• Audit User Attribution - Links database modifications to specific user identities or processes to maintain a comprehensive accountability trail.
• Data Recovery - Provides a framework for restoring records previously marked as deleted by reifying their last version.
• Database Change Tracking - Provides a system for recording before-and-after attribute values of database models during lifecycle events.
• Model State Reification - Reconstructs a model instance as it existed at a specific point in time or before a particular change.
• Object State Reification - Provides a utility for reconstructing a Ruby on Rails model instance exactly as it existed at a specific point in time.
• Serialized State Snapshots - Persists full object states as serialized JSON or YAML strings in a dedicated versions table.
• Record Recovery - Allows for the reconstruction and reinstatement of deleted database records by reifying their last known version.
• Database Audit Trails - Implements a database-specific audit trail that documents every modification with before-and-after values.
• Change Data Capture - Captures row-level snapshots of model states during create, update, and delete events.
• Historical State Hydration - Reconstructs model instances as they existed at specific points in time using historical snapshots.
• Model - Implements automatic state capture by hooking into ActiveRecord model lifecycle events.
• State Change Attribution - Links every database modification to the specific user or process responsible for the change.
• Rails Audit Libraries - Provides comprehensive audit logging and change tracking specifically designed for Ruby on Rails ActiveRecord models.
• State Attribute Filters - Provides mechanisms to exclude specific attributes from being versioned to optimize storage.
• Audit Change Metadata - Records additional context for modifications, such as the specific command executed or source location.
• Historical Data Querying Interfaces - Provides query interfaces to search through past table states and change logs based on attribute values.
• Polymorphic Associations - Uses polymorphic associations to link a single versions table to multiple different model types.
• Associated Record Auditing - Tracks changes to associated models to maintain a complete audit trail of related data.
• Version Audit Metadata - Attaches arbitrary model or request data, such as IP addresses or user agents, to version records.
• Versioned Storage - Maintains historical snapshots of database records as serialized JSON to allow for auditing and time-travel.
• Entity Audit Logs - Records historical changes to database entities and associated request metadata for compliance and debugging.
• Attribute Changeset Differencing - Calculates and stores precise attribute differences between adjacent versions for audit analysis.
• Record Version Querying - Allows searching for historical records based on the values of the object or specific modifications made over time.
• Version Retention Policies - Implements limits on the number of stored versions or deletes old records based on timestamps to prevent database bloat.
• State Version Diffing - Retrieves a changeset of differences between adjacent versions to identify modified attributes.
• Object Timeline Navigation - Enables sequential movement through an object's modification history using previous and next version pointers.
• Request-Scoped State - Uses request-scoped state to attribute database changes to the specific user making the request.

Star history