skill-rails-api

/skill-rails-api

Padrões DARE para APIs em Ruby on Rails 8 — API mode, ActiveRecord, Solid Queue, Solid Cable, Action Cable, strong params, Services, serializers (Blueprinter/Alba), Devise/JWT, rack-attack, rswag.

Como usar

/skill-rails-api                          # audita projeto Rails
/skill-rails-api scaffold users           # gera controller + service + blueprint + tests
/skill-rails-api migrate-controllers      # extrai lógica de controllers para services

Stack canônica

• Ruby 3.3+
• Rails 8.x (rails new --api)
• PostgreSQL 16
• Solid Queue (jobs) + Solid Cable (websockets) — built-in Rails 8
• Devise + devise-jwt (ou JWT puro)
• Pundit ou CanCanCan (autorização)
• Blueprinter ou Alba (serializers)
• rack-attack (rate limit)
• rswag (OpenAPI)
• RSpec + FactoryBot + Faker
• Rubocop rails-omakase
• bundler-audit (CVEs)

Layered Design

Camada	Pasta Rails
Handler	app/controllers/api/v1/
Service	app/services/
Repository	app/repositories/ (opcional)
Model	app/models/
Presenter	app/blueprints/ ou app/serializers/

Controllers

module Api::V1
  class UsersController < ApplicationController
    before_action :authenticate_user!

    def create
      result = RegisterUser.new(user_params).call
      if result.success?
        render json: UserBlueprint.render(result.user), status: :created
      else
        render json: { error: result.error_code }, status: :conflict
      end
    end

    private

    def user_params
      params.require(:user).permit(:email, :name, :password)
    end
  end
end

Service Object

class RegisterUser
  Result = Struct.new(:success?, :user, :error_code)

  def initialize(params)
    @params = params
  end

  def call
    return Result.new(false, nil, 'USER_EXISTS') if User.exists?(email: @params[:email])
    user = User.create!(@params)
    Result.new(true, user, nil)
  end
end

Model

class User < ApplicationRecord
  has_secure_password
  validates :email, presence: true, uniqueness: true, format: URI::MailTo::EMAIL_REGEXP
  validates :name, presence: true
  validates :password, length: { minimum: 12 }, if: :password_required?
end