How collectiveidea/audited works
Audited is a Rails ActiveRecord extension that records model changes as audit rows, with optional user attribution, comments, associated records, and revision reconstruction. The principal workflow is a model lifecycle event triggering audit creation, persistence, and later inspection or undo. The README also documents install/upgrade migrations and RSpec matchers; these are represented as product-facing branches. Source excerpts show callback and revision behavior, but request attribution wiring is only documented, so that relationship is marked unverified.
Main entry points: auditor.rb Auditor callbacks · audit.rb Audit record · audited.rb Request context · railtie.rb Rails railtie
Components 13
Audit capture
- Audited model
- Auditor callbacks
lib/audited/auditor.rb
Audit history
- Audit record
lib/audited/audit.rb - Audits table
- Revision APIs
lib/audited/auditor.rb
Rails integration
- Request context
lib/audited.rb - Audit sweeper
lib/audited/sweeper.rb - Rails railtie
lib/audited/railtie.rb
Schema setup
- Install generator
lib/generators/audited/install_generator.rb - Upgrade generator
lib/generators/audited/upgrade_generator.rb
RSpec matchers
- Audit matchers
lib/audited/rspec_matchers.rb
Other components
- Rails application
- Request user
Connections 9
- Audited model → Auditor callbacks: triggers callbacks
lib/audited/auditor.rb - Auditor callbacks → Audit record: creates audit
lib/audited/auditor.rb - Audit record → Audits table: persists rows
README.md - Revision APIs → Audit record: reads history
lib/audited/auditor.rb - Rails application → Install generator: generates schema
README.md - Rails application → Upgrade generator: generates migrations
README.md - Rails application → Rails railtie: loads integration
- Request user → Request context: supplies identity
- Request context → Auditor callbacks: attributes changes