How rolifycommunity/rolify works
Main components
• Railtie (lib/rolify/railtie.rb)
• Boots the gem in Rails, injects rolify and resourcify methods into models
• Generators (lib/generators/…)
• rolify_generator, active_record & mongoid generators create models, migrations, initializers
• Core Engine (lib/rolify/…)
• resource.rb (mixes in resource behaviour)
• role.rb (Role model logic)
• configure.rb (gem‐level configuration)
• dynamic.rb (dynamic method definitions)
• finders.rb (scoped queries: .with_role, .find_roles, etc.)
• matchers.rb (test matchers for RSpec)
• utils.rb (shared helper methods)
• version.rb
• Adapters (lib/rolify/adapters/…)
• ActiveRecord adapters: resource_adapter.rb, role_adapter.rb, scopes.rb
• Mongoid adapters: same structure under mongoid/
• Base adapter defines interface for persistence and query operations
• Database (Postgres/MySQL for AR or MongoDB for Mongoid)
Relationships and data flow
• Rails App ➔ Railtie
Rails initializes and loads the Railtie -> gem injects rolify into User and resourcify into resource classes
• App Models (User, Forum, etc.)
Calling rolify mixes in Core Engine + selects correct Adapter per ORM
Calling resourcify mixes in Resource behavior
• Core Engine ➔ Adapters ➔ Database
Role assignment (user.add_role) invokes Core Engine logic → Adapter writes to DB
Role queries (user.has_role?, Forum.with_role) invoke Finders → Adapter queries DB
• Generators ➔ App File System
Generates migration, model and initializer files before runtime
Architectural patterns & design principles
• Plug-in Architecture
• Uses Rails Railtie for automatic integration
• Exposes extension points via Generators
• Adapter Pattern
• Abstracts persistence behind a common interface for ActiveRecord vs. Mongoid
• Mixin/Module Composition
• Core behavior injected into host models via modules
• Dynamic Method Definition
• Uses dynamic.rb to define role methods on the fly
Detail level
• Configuration flow: “Application config ➔ configure.rb ➔ Core Engine”
• How the Rolify gem integrates into a Rails app
• The separation between its generation phase (Generators) and its runtime phase (Railtie → Core → Adapters)
• Its use of the Adapter pattern for multi-ORM support
• Data flows for role assignment and querying
• Extensibility points for future contributors or users