everything-claude-code/docs/ja-JP/rules/ruby/patterns.md

paths

paths
**/*.rb **/*.rake **/Gemfile **/app/**/*.erb **/config/routes.rb

Ruby パターン

このファイルは common/patterns.md を Ruby および Rails 固有のコンテンツで拡張します。

まず Rails Way

• 小規模および中規模の機能には、プレーンな Rails MVC と Active Record の規約から始める。
• モデル/コントローラの境界が複数の責務を担っている場合に、サービスオブジェクト、クエリオブジェクト、フォームオブジェクト、デコレータ、またはプレゼンターを導入する。
• 抽出したオブジェクトには Manager や Processor のような汎用的なレイヤー名ではなく、実行するビジネス操作にちなんだ名前を付ける。

永続化

• マルチホスト本番 Rails アプリでは、既存プラットフォームが MySQL や SQLite を使用する明確な理由がない限り PostgreSQL を優先する。
• Rails 8 の SQLite ベースのデフォルトは、シングルホストまたは小規模なデプロイメントに適しているが、共有マルチサービスシステムに自動的に適合するわけではない。
• 生の SQL はクエリオブジェクトまたはモデルスコープの背後に配置し、すべての動的値をパラメータ化する。

バックグラウンドジョブとランタイムサービス

• グリーンフィールドの Rails 8 アプリで、適度なスループットとシンプルなデプロイメントが必要な場合は Solid Queue を使用する。
• 成熟したオブザーバビリティ、高スループット、既存の Redis インフラストラクチャ、または Pro/Enterprise 機能が必要な場合は Sidekiq を使用する。
• Solid Cache と Solid Cable はそのデプロイメントモデルがアプリに適合する場合に使用する。共有クロスサービス動作、高ファンアウト、または高度なデータ構造が重要な場合は Redis を使用する。

フロントエンド

• サーバーレンダリングの Rails アプリには Turbo、Stimulus、Importmap、Propshaft を使用した Hotwire を優先する。
• インタラクションの複雑さ、既存のプロダクトアーキテクチャ、またはチームのオーナーシップが追加のクライアントサーフェスを正当化する場合は、React、Vue、Inertia.js、または個別の SPA を使用する。
• ビューコンポーネント、パーシャル、プレゼンターはレンダリングの判断に集中させる。永続化と認可をテンプレートに含めない。

認証

• シンプルなセッション認証とパスワードリセットのニーズには Rails 8 認証ジェネレータを使用する。
• OAuth、MFA、confirmable/lockable フロー、マルチモデル認証、または大規模な既存 Devise フットプリントが要件に含まれる場合は Devise または他の確立された認証システムを使用する。

参考

サービス境界とアダプターパターンについてはスキル: backend-patterns を参照。