rails-service-patterns

📁 ag0os/rails-dev-plugin 📅 Jan 27, 2026

总安装量

周安装量

#51609

全站排名

安装命令

npx skills add https://github.com/ag0os/rails-dev-plugin --skill rails-service-patterns

Agent 安装分布

cursor 3

windsurf 2

mcpjam 1

claude-code 1

replit 1

zencoder 1

Skill 文档

Rails Service Object Patterns

Patterns for extracting and organizing business logic in Rails applications.

When This Skill Applies

Extracting complex logic from controllers/models into service objects
Implementing command/query separation patterns
Handling multi-step business processes
Designing result objects and error handling
Organizing the app/services directory

Core Principles

Single Responsibility

Each service should do one thing well:

Name services with verb + noun: CreateOrder, SendEmail, ProcessPayment
Keep services focused and composable
One public method (typically call or perform)

Dependency Injection

Make services testable and flexible:

class NotificationService
  def initialize(mailer: UserMailer, sms_client: TwilioClient.new)
    @mailer = mailer
    @sms_client = sms_client
  end
end

Service Patterns

See patterns.md for detailed implementations of:

Basic Service Pattern
Result Object Pattern
Form Objects
Query Objects
Policy Objects

Quick Reference

Pattern	When to Use
Basic Service	Simple operations with transaction handling
Result Object	When callers need success/failure + data/error
Form Object	Complex forms spanning multiple models
Query Object	Complex ActiveRecord queries
Policy Object	Authorization logic (Pundit-style)

Testing Services

RSpec.describe CreateOrder do
  let(:user) { create(:user) }
  let(:service) { described_class.new(user, cart_items) }

  describe '#call' do
    it 'creates an order' do
      expect { service.call }.to change { Order.count }.by(1)
    end

    context 'when payment fails' do
      before { allow(PaymentProcessor).to receive(:charge).and_raise(PaymentError) }

      it 'rolls back the transaction' do
        expect { service.call }.not_to change { Order.count }
      end
    end
  end
end