Railsでクリーンアーキテクチャを考えてきた

複雑なシステムの設計と開発におけるクリーンアーキテクチャ、レイヤードアーキテクチャ、ドメインモデリング、モジュラーモノリスの活用について詳細に解説します。
具体例として輸送管理システムCREWExpressを紹介し、
依存関係のルールや抽象度の高い設計をRailsに適用する方法を共有します。
特にMVCにユースケース層を追加し、システムの柔軟性を保つ工夫について詳述します。また、Railsの一般的な開発手法であるRailsWayだけでは対応しきれない複雑さに対して、どのようにクリーンアーキテクチャの考え方を取り入れているのかを実例を交えて説明します。
クリーンアーキテクチャの基本概念や依存性逆転の原則をRails環境でどのように実現しているかについても触れています。

Transcript

1. Railsでクリーンアーキテクチャ を考えてきた 設計ナイト2024 鈴木まー
2. © 2024 • Azit Inc. Railsを使用しながらシステムの 複雑性をさげるために レイヤードアーキテクチャ、 ドメインモデリング(戦略的DDD), モジュラーモノリス を使った設計を工夫して 複雑なシステムに対応をしている 自己紹介 鈴木まー Object-Oriented Conference の動画編集者 Object-Oriented Conference の動画編集者
3. © 2024 • Azit Inc. 話すこと
4. © 2024 • Azit Inc. 複雑なシステムを開発するために クリーンアーキテクチャ的な設計の アイディア取り入れてシステム開発 をしてきた開発の話をします
5. © 2024 • Azit Inc. 話の前提認識を持ってもらう もらうために 開発しているシステムの CREWExpressの少しだけ紹介
6. © 2024 • Azit Inc. マーケットプレイス Wolt社などの複数のデリバリー会社と 連携をし配送をしてもらう 輸送管理システム(TMS) クライアントの会社の社員・アルバイトの人の配送 を効率的に配送計画を立てる コアドメイン
7. © 2024 • Azit Inc. エンタプライズに特化したSaaS とくに大企業に対して 配送のDX化をコンサルから おこなう ターゲットとしている層
8. © 2024 • Azit Inc. 大企業の配送DX化のコンサルは その会社にあった 個別開発が求められるため システムの柔軟性が求められる
9. © 2024 • Azit Inc. 配送に関するドメイン知識は エンジニアはもっていない 複数のデリバリーサービスと連携したり、 配送計画などの機能面でも複雑 個別開発はクライアントと具体的な話をするまで はなにをするかがわからない 複雑さが高い
10. © 2024 • Azit Inc. Railsを使って開発をしているが Railsの一般的な開発手法である RailsWayだけでは不十分 複雑さへの対応
11. © 2024 • Azit Inc. 複雑さへの対応 クリーンアーキテクチャな どの設計手法を取り入れる ことが必須
12. © 2024 • Azit Inc. ここで話すクリーンアーキテクチャ Railsではインターフェースが存在しないので クリーンアーキテクチャの設計デザインを そのまま採用することはできないけど クリーンアーキテクチャの 考えは参考になるはず
13. © 2024 • Azit Inc. ここで話すクリーンアーキテクチャ クリーンアーキテクチャの書籍で 著者アンクルボブはの “クリーンアーキテクチャ 4つの円だけ？” というところで次のことを言っている
14. © 2024 • Azit Inc. ここで話すクリーンアーキテクチャ 依存性のルールは常に適用されます。 ソースコードの依存性は、常に内側に向けるべきです。 内側に近づくほど、抽象度と方針のレベルは高まります。 外側には具体的な詳細が存在し、 内側にはソフトウェアの抽象化された 高位レベルの方針がカプセル化されます。 最も内側は、最も一般的で高位レベルのものになります。
15. © 2024 • Azit Inc. ここで話すクリーンアーキテクチャ 依存性を常に意識する ソースコードの依存性は、 内側に近づくほど、 抽象度が高くなる
16. © 2024 • Azit Inc. ここで話すクリーンアーキテクチャ 内側に近づくほど、 抽象度を高くする 不必要な依存性を生まないこと これならRailsでもできそう
17. © 2024 • Azit Inc. ここで話すクリーンアーキテクチャ ただ、 開発した当時はRubyでインターフェー スを実装する手段がなかったので依存 性を正確に逆転はできない
18. © 2024 • Azit Inc. ここで話すクリーンアーキテクチャ 言語やフレームワークの仕組み上 できないのは あきらめる
19. © 2024 • Azit Inc. そのまま実装できなくても システムの複雑さを下げる ことができるのであれば、積極的に 取り入れる ここで話すクリーンアーキテクチャ
20. © 2024 • Azit Inc. チームで話し合って 自分たちのシステムにあった クリーンアーキテクチャを設計した 依存性を常に適用する 内側が一番抽象度が高い 自分たちのクリーンアーキテクチャ
21. © 2024 • Azit Inc. MVCにユースケース層を追加した DDDのアプリケーションサービスに似ている ユースケース層はユースケース記述をコードに 落とし込む ユースケース層は抽象度が一番高くする 自分たちのクリーンアーキテクチャ
22. © 2024 • Azit Inc. ユースケース記述のサンプル システムはユーザーが選択した支払い方法を取得する。 システムは支払い情報（クレジットカード情報、住所情報など）を取得する。 システム支払処理をする 支払いが成功した場合: 　　　システムは在庫を更新する。 　　　システムはユーザーの購入履歴を更新する。 支払いが失敗した場合: 　　　システムはユーザーにエラーメッセージを送信する 自分たちのクリーンアーキテクチャ
23. © 2024 • Azit Inc. public void processPurchase() { retrievePaymentMethod(); retrievePaymentInformation(); if (processPayment()) { updateInventory(); updatePurchaseHistory(); } else { sendErrorMessage(); } さっきのユースケース 記述をユースケースクラス にしたもの
24. © 2024 • Azit Inc. モデルはユースケースからしか呼ばれない コントローラーはユースケースのクラスを実行 するだけ ビューはユースケースからコントローラーに渡 されたデータを受け取りそれをJSONにする 自分たちのクリーンアーキテクチャ
25. © 2024 • Azit Inc. U M C V 自分たちのクリーンアーキテクチャ
26. © 2024 • Azit Inc. ユースケース層があることで 密結合MVCがそれぞれ独立している ほかの層はユースケース層に依存をしていて ユースケース層に対してだけやりとりをする 自分たちのクリーンアーキテクチャ
27. © 2024 • Azit Inc. 最近までRubyにはインターフェースは存 在しないので依存関係逆転はできていな いけどそこは諦めていた 自分たちのクリーンアーキテクチャ
28. © 2024 • Azit Inc. 最近チームでRubyで型を記述でき インターフェースも定義 できるRBSを導入していて 依存関係逆転をできるように挑戦している 自分たちのクリーンアーキテクチャ
29. © 2024 • Azit Inc. 複雑性が高いシステムを開発している場合 はクリーンアーキテクチャに限らず チームで話し合いながらシステムの複雑さ を下げることができる考えを取り入れる ドメインモデリングなど まとめ
30. © 2024 • Azit Inc. 複雑性が高い配送のDX化コンサルを大企業に大して支援をお こない社会的意義のある開発をしています Railsを使って設計原則を適応していき 複雑なシステムを開発したいエンジニアを絶賛募集中 “Azit 採用”で検索!! we are hiring
31. © 2024 • Azit Inc. Object-Oriented Conference からの告知
32. © 2024 • Azit Inc. Object-Oriented Conferenceの アーカイブ動画を来週から 平日の毎日投稿をします すべての登壇が非常に勉強になるので設計につ いて勉強ができます 告知
33. © 2024 • Azit Inc. 告知
34. © 2024 • Azit Inc. 終わり ご清聴ありがとう ございました