Whodunit

gem 'whodunit'

class AddStampsToUsers < ActiveRecord::Migration[7.0]
  def change
    add_whodunit_stamps :users  # Adds creator_id, updater_id columns
  end
end

class AddStampsToDocuments < ActiveRecord::Migration[7.0]
  def change
    add_whodunit_stamps :documents  # Adds creator_id, updater_id, deleter_id (if soft-delete detected)
  end
end

class User < ApplicationRecord
  include Whodunit::Stampable
end

class Document < ApplicationRecord
  include Discard::Model  # or acts_as_paranoid, etc.
  include Whodunit::Stampable  # Automatically detects soft-delete!
end

class ApplicationController < ActionController::Base
  # Whodunit::ControllerMethods is automatically included via Railtie
  # It will automatically set the current user for stamping
end

# Creating records
user = User.create!(name: "Ken")
# => Sets user.creator_id to current_user.id

# Updating records
user.update!(name: "Sophia")
# => Sets user.updater_id to current_user.id

# Soft deleting (if soft-delete gem is detected)
document.discard
# => Sets document.deleter_id to current_user.id

user.creator   # => User who created this record
user.updater   # => User who last updated this record
user.deleter   # => User who deleted this record (if soft-delete enabled)

# Most common soft-delete column (default)
config.soft_delete_column = :deleted_at

# For Discard gem users
config.soft_delete_column = :discarded_at

# For custom implementations
config.soft_delete_column = :archived_at

# Disable soft-delete support
config.soft_delete_column = nil

# config/initializers/whodunit.rb
Whodunit.configure do |config|
  config.user_class = 'Account'             # Default: 'User'
  config.creator_column = :created_by_id    # Default: :creator_id
  config.updater_column = :updated_by_id    # Default: :updater_id
  config.deleter_column = :deleted_by_id    # Default: :deleter_id
  config.soft_delete_column = :discarded_at # Default: nil
  config.auto_inject_whodunit_stamps = false # Default: true

  # Column data type configuration
  config.column_data_type = :integer       # Default: :bigint (applies to all columns)
  config.creator_column_type = :string     # Default: nil (uses column_data_type)
  config.updater_column_type = :uuid       # Default: nil (uses column_data_type)
  config.deleter_column_type = :integer    # Default: nil (uses column_data_type)
end

# Automatic injection is enabled by default!
# Your migrations automatically get whodunit stamps:
class CreatePosts < ActiveRecord::Migration[8.0]
  def change
    create_table :posts do |t|
      t.string :title
      t.text :body
      t.timestamps
      # t.whodunit_stamps automatically added after t.timestamps!
    end
  end
end

# Disable automatic injection globally:
Whodunit.configure do |config|
  config.auto_inject_whodunit_stamps = false
end

# Skip auto-injection for specific tables:
create_table :system_logs do |t|
  t.string :message
  t.timestamps skip_whodunit_stamps: true
end

# Or add manually if you want specific options:
create_table :posts do |t|
  t.string :title
  t.whodunit_stamps include_deleter: true  # Manual override
  t.timestamps
  # No auto-injection since already added manually
end

# Temporarily set user
Whodunit::Current.user = User.find(123)
MyModel.create!(name: "test")  # Will be stamped with user 123

# Within a block
controller.with_whodunit_user(admin_user) do
  Document.create!(title: "Admin Document")
end

# Disable stamping temporarily
controller.without_whodunit_user do
  Document.create!(title: "System Document")  # No stamps
end

# Basic usage (uses configured data types)
class CreatePosts < ActiveRecord::Migration[7.0]
  def change
    create_table :posts do |t|
      t.string :title
      t.whodunit_stamps  # Adds creator_id, updater_id with configured types
      t.timestamps
    end
  end
end

# Custom data types per migration
class CreateUsers < ActiveRecord::Migration[7.0]
  def change
    create_table :users do |t|
      t.string :email
      t.whodunit_stamps include_deleter: true,
                        creator_type: :uuid,
                        updater_type: :string,
                        deleter_type: :integer
      t.timestamps
    end
  end
end

# Add to existing table with custom types
class AddStampsToExistingTable < ActiveRecord::Migration[7.0]
  def change
    add_whodunit_stamps :existing_table,
                        include_deleter: :auto,
                        creator_type: :string,
                        updater_type: :uuid
  end
end

# Mixed approach - some custom, some default
class CreateDocuments < ActiveRecord::Migration[7.0]
  def change
    create_table :documents do |t|
      t.string :title
      t.whodunit_stamps creator_type: :uuid  # Only override creator, others use defaults
      t.timestamps
    end
  end
end

class ApiController < ApplicationController
  skip_whodunit_for :index, :show
end

class ReadOnlyController < ApplicationController
  whodunit_only_for :create, :update, :destroy
end

# Each thread maintains its own user context
Thread.new { Whodunit::Current.user = user1; create_records }
Thread.new { Whodunit::Current.user = user2; create_records }

# RSpec
before do
  Whodunit::Current.user = create(:user)
end

# Or within specific tests
it "tracks creator" do
  user = create(:user)
  Whodunit::Current.user = user

  post = create(:post)
  expect(post.creator).to eq(user)
end