ClinPeer Railsプロジェクトの技術選定（2025年版）

こんにちは。サーバーサイドエンジニアの三村（@t_mimura39）です。

こちらでご案内した通り、弊社で新しくリリースした「ClinPeer」の裏側をご紹介します。 tech.medpeer.co.jp

今回はClinPeerのバックエンドについての簡単なシステム概要と選定技術の紹介編です。
2024-2025年にrails newをした新鮮なRailsプロジェクトの様子をお楽しみください。

システム概要
- rails stats
- Gemfile
技術選定
- Ruby
- Ruby on Rails
- Puma
- ActionPack::CloudfrontViewerAddress
- Trilogy
- SolidQueue
- SolidCache
- Kaminari
- Async::HTTP
- Ueki
- Jb
- Nokogiri
- Blazer
- ActiveHash
- Flipper
- Lograge
- MaintenanceTasks
- ReciteCSV
- UserAgent
- AnnotateRb
- RBS系各種
- Prosopite
- Traceroute
- RuboCop
- CiLogger
- Committee / Committee::Rails
- RSpec::Snapshot
- SuperDiff
その他
おわり

システム概要

細かな選定技術の紹介の前に簡単なシステム概要をご紹介します。
弊社は主にRuby on Railsを採用しており、今回も特別な技術的な要件がなかったためRuby on Railsを採用しました。
また、社内標準的にクラウドはAWS環境が採用されています。

「Amazon CloudFront -> ALB -> AWS Fargate（puma -> Rails）」で構成されるごく一般的なWebシステムです。

rails stats

次にRailsシステムの規模感のご紹介です。

定量的な指標としてrails statsを記載します。

bin/rails stats
+----------------------+--------+--------+---------+---------+-----+-------+
| Name                 |  Lines |    LOC | Classes | Methods | M/C | LOC/M |
+----------------------+--------+--------+---------+---------+-----+-------+
| Controllers          |   2982 |   2207 |     106 |     296 |   2 |     5 |
| Helpers              |      4 |      2 |       0 |       0 |   0 |     0 |
| Jobs                 |    239 |    162 |      16 |      20 |   1 |     6 |
| Models               |  10463 |   6557 |     230 |     714 |   3 |     7 |
| Mailers              |    685 |    611 |       9 |      17 |   1 |    33 |
| Views                |   3904 |   3662 |       0 |       0 |   0 |     0 |
| Libraries            |    634 |    451 |       5 |      33 |   6 |    11 |
| Config specs         |     49 |     39 |       0 |       0 |   0 |     0 |
| Controller specs     |     17 |     13 |       0 |       0 |   0 |     0 |
| Form_builder specs   |   1059 |    855 |       0 |      24 |   0 |    33 |
| Job specs            |    577 |    439 |       0 |       0 |   0 |     0 |
| Lib specs            |    404 |    350 |       0 |       1 |   0 |   348 |
| Mailer specs         |    608 |    500 |       0 |       1 |   0 |   498 |
| Model specs          |  15063 |  12527 |       2 |      14 |   7 |   892 |
| Request specs        |   5319 |   4560 |       0 |      45 |   0 |    99 |
| System specs         |   3339 |   2588 |       0 |       3 |   0 |   860 |
| Task specs           |    165 |    132 |       0 |       0 |   0 |     0 |
| Validator specs      |    278 |    214 |       0 |       0 |   0 |     0 |
+----------------------+--------+--------+---------+---------+-----+-------+
| Total                |  45789 |  35869 |     368 |    1168 |   3 |    28 |
+----------------------+--------+--------+---------+---------+-----+-------+
  Code LOC: 13652     Test LOC: 22217     Code to Test Ratio: 1:1.6

statsの結果から分かる通りまだまだ規模が小さいシステムですね。
Modelsが230とありますが、この内ActiveRecordなクラス（= テーブル数）は87個とこれまた両手に収まる程度の規模感です。

RSpecを採用している点以外はRails標準のディレクトリ構成となっています。

Gemfile

「技術選定」と称していますが、特殊な技術を採用しているわけではないため実質利用しているGemのご紹介となります。

熟練のRubyistはGemfileを見るだけでそのRailsシステムの全容が分かると聞いたことがある（要出典）のでそのまま公開します。

gem "rails"

# Rack
gem "puma"

gem "actionpack-cloudfront_viewer_address"

# DB
gem "trilogy"

# Authn / Authz
gem "bcrypt"
gem "jwt"

# Job
gem "mission_control-jobs"
gem "solid_queue"

# Cache
gem "solid_cache"

# ActiveRecord / ActiveModel Extension
gem "kaminari"

# Frontend
gem "propshaft"
gem "vite_rails"

# Network
gem "async-http-faraday"
gem "faraday"
gem "ueki"

# View Templating Engine / Serializer
gem "jb"

# SDK
gem "aws-sdk-cloudfront"
gem "aws-sdk-s3"
gem "datadog"
gem "googleauth"
gem "rollbar"
gem "sendgrid-ruby"
gem "zendesk_api"

# XML
gem "nokogiri"

# bi
gem "blazer"

# Other
gem "active_hash"
gem "bootsnap", require: false
gem "flipper"
gem "flipper-active_record"
gem "flipper-ui"
gem "fugit"
gem "lograge"
gem "maintenance_tasks"
gem "recite_csv"
gem "repl_type_completor", require: false
gem "rqrcode"
gem "useragent"
gem "validate_url"
gem "warning"

group :development, :test do
  gem "annotaterb"
  gem "debug", require: "debug/prelude"
  gem "factory_bot_rails"

  gem "rbs_rails", require: false, github: "pocke/rbs_rails", branch: "master"

  gem "prosopite"
  gem "steep", require: false

  gem "traceroute"
end

group :ruby_lint do
  gem "brakeman", require: false
  gem "erb_lint", require: false
  gem "rubocop", require: false
  gem "rubocop-capybara", require: false
  gem "rubocop-factory_bot", require: false
  gem "rubocop-performance", require: false
  gem "rubocop-rails", require: false
  gem "rubocop-rspec", require: false
  gem "rubocop-rspec_rails", require: false
  gem "rubocop-thread_safety", require: false
end

group :test do
  gem "capybara"
  gem "capybara-playwright-driver"
  gem "ci_logger"
  gem "committee-rails"
  gem "database_rewinder"
  gem "rspec-rails"
  gem "rspec-snapshot"
  gem "simplecov", require: false
  gem "super_diff"
  gem "test-prof"
  gem "webmock", require: false
end

group :development do
  gem "letter_opener_web"
  gem "web-console"

  gem "ruby-lsp", require: false
  gem "ruby-lsp-rails", require: false
  gem "ruby-lsp-rspec", require: false
end

少しだけ社内用Gemを取り除いていますが、それ以外は実際のGemfileの内容と同等です。
特別な技術は利用しておらず、素直なrailsシステムであることが分かるかと思います。

それではこれらから抜粋して、もう少し深掘って紹介させてください。

技術選定

Ruby

もちろん最新です。

$ cat .ruby-version
3.4.2

ちなみに、最近話題のdevin.aiにv3.4.2にアップデートしてもらいました。

最近のRubyは破壊的なアップデートがほとんどないため、積極的に安心してバージョンアップすることができて素晴らしいですね。

Ruby on Rails

こちらも最新の「v8.0.1」です。

2024年7月に以下のコマンドでrails newを実行しました。この時点でrails v8のリリースが予想できていたため最初からbeta版を採用していました。

rails _7.2.0.beta3_ new ./ --name=clinpeer --database=trilogy --skip-action-mailbox --skip-action-text --skip-active-storage --skip-action-cable --skip-asset-pipeline --skip-javascript --skip-hotwire --skip-jbuilder --skip-test --skip-system-test --devcontainer

ClinPeerでは最新のrailsに追従できるように Rails Edge（mainブランチ）をCIで回しています。そのおかげでrailsの最新バージョンがリリースされたら数日後にはすぐに更新対応できるような体制が築けています。

Rails EdgeをCIで回す方法はタイミーさんのブログが参考になるかと思います。 tech.timee.co.jp

システム概要

rails stats

Gemfile

技術選定

Ruby

Ruby on Rails

Puma

ActionPack::CloudfrontViewerAddress

Trilogy

SolidQueue

SolidCache

Kaminari

Async::HTTP

Ueki

Jb

Nokogiri

Blazer

ActiveHash

Flipper

Lograge

MaintenanceTasks

ReciteCSV

UserAgent

AnnotateRb

RBS系各種

Prosopite

Traceroute

RuboCop

CiLogger

Committee / Committee::Rails

RSpec::Snapshot

SuperDiff

その他

認証系Gem

Ridgepole

設定値管理（Rails.application.config_for）

ファイル管理（ActiveStorage）

HTMLテンプレートエンジン（ERB）

ヘルスチェック（Rails標準Health）

おわり