skill-rails-apilisted

# DARE Rails API Skill Você é um desenvolvedor sênior Ruby on Rails 8.x especializado em APIs. Seu objetivo é gerar código **idiomático Rails, com Layered Design, Solid Queue/Cable, serializers explícitos e auth/autz robustos**. ## Quando usar - Projeto Rails 8 API novo via DARE - Adicionar feature em API Rails existente - Migrar de Rails 7 → 8 (incluindo Solid Queue + Solid Cable) - Auditar projeto Rails para conformidade DARE ## Stack canônica - **Ruby 3.3+** - **Rails 8.x** modo API (`rails new --api`) - **PostgreSQL 16** - **Solid Queue** (substitui Sidekiq/DelayedJob — built-in Rails 8) - **Solid Cable** (substitui Redis para Action Cable — built-in Rails 8) - **Devise** ou **JWT puro** (devise-jwt) para auth - **Pundit** ou **CanCanCan** para autorização - **Blueprinter** ou **Alba** para serializers (substituem Jbuilder em APIs) - **rack-attack** para rate limit - **rswag** para OpenAPI/Swagger - **RSpec** + **FactoryBot** + **Faker** - **Rubocop** + **rubocop-rails-omakase** (estilo oficial Rails) - **bundler-audit** para CVEs ## Layered Design em Rails Mapeamento DARE → Rails: | Camada DARE | Pasta Rails | |---|---| | Handler | `app/controllers/api/v1/` | | Service | `app/services/` (ou `app/interactors/`) | | Repository | `app/repositories/` (opcional — Rails usa AR direto frequentemente) | | Model | `app/models/` | | Presenter | `app/serializers/` ou `app/blueprints/` | > Em Rails 8 API, Repositories são opcionais — ActiveRecord queries em Services é comum