[Research] Clean Architecture とは？

[masayuki-0319]

Background

ActiveRecord のおかげで、Rails なら基本気にしない概念

しかし、長く運用すると Rails も大きくなるし、、 Backend と Frontend の分離も一般的になってるし、、 システムの設計において、どのような概念があるか気になった。 https://inside.estie.co.jp/entry/2021/04/07/090000

Goals

• Clean Architecture の基本とは
• Clean Architecture のディレクトリ分割する規約とは

TODO

• [x] 参考資料の収集
• [x] 情報選別
• [x] 結論

[masayuki-0319]

参考資料

Clean Architecture とは

• てっくらんち ~ クリーンアーキテクチャ入門 ~ - Leverages Tech Blog
• 実践！ Typescript で DDD - マイクロサービス設計のすすめ - Leverages Tech Blog
• 実装クリーンアーキテクチャ - Qiita

Sample Project

• Frontend
  • https://github.com/eduardomoroni/react-clean-architecture
  • Frontend を一つのディレクトリで管理 ( React, ReactNative )
  • https://github.com/rmanguinho/clean-react
  • https://github.com/falsy/react-with-clean-architecture
  • https://github.com/xurxodev/frontend-clean-architecture
  • https://github.com/bailabs/react_js_clean_architecture
  • https://github.com/Valbrand/counter-clean-architecture
  • https://github.com/RostislavDugin/clean-architecture-react-typescript
• Backend
  • Express
  • https://github.com/harvic3/nodetskeleton
  • https://github.com/otaviolemos/thewisedev-mailing
  • https://github.com/dannielhugo/typescript-clean-architecture
  • https://github.com/satishbabariya/nodejs-boilerplate
  • https://github.com/rmanguinho/advanced-node
  • https://github.com/luizomf/clean-architecture-api-boilerplate
  • https://github.com/williamkoller/clean-ts-api
  • Nest
  • https://github.com/pvarentsov/typescript-clean-architecture
  • https://github.com/damienbeaufils/nestjs-clean-architecture-demo
  • GraphQL
  • https://github.com/rmanguinho/clean-ranking-loader/blob/master/package.json
  • https://github.com/rmanguinho/clean-ts-api

[masayuki-0319]

批判

クリーンアーキテクチャなんてものはない(クリーンアーキテクチャーの読み方) - プログラマのはしくれダイアリー 実はDDDってしっくりこないんです - タオルケット体操

[masayuki-0319]

CleanArchitecture や DDD に頼りたくなる原因って、、 個人的には、自分のコード管理方法が不安に感じるだけなのかも。 実際、Rails 以外の Framework の学習を始めたとき、GitHub を見ると、個々人の自由なディレクトリ設計のもとで管理されていて混乱した( それがスタンダードなんだけど )。

ビジネス上では、多くの人が開発に携わるから、統一的な認識の下ででリポジトリを管理できたら理想。 しかし、それらのアーキテクチャの下で構成されたディレクトリを理解する学習コストと、特にこだわりの無いディレクトリを理解するコストを考えると、大した違いは無い気もする。 コード分割も多すぎると、多人数の時に綻びが出てくるし、少人数の時は DX の低下も発生するか？

そのため、絶対視すべきでは無い性質のもの。

[masayuki-0319]

もちろん根底にある思想は、持続的なソフトウェア開発において、必要な概念だから肝に銘じること。

本を読んで大事なところを自分なりに理解して行動してみよう(どの本でも大事) the クリーンアーキテクチャの一枚絵にこだわりすぎないようにしよう(ただの例として捉える) DIPをやろう 依存の方向は一方向にしよう

https://yyyank.blogspot.com/2021/06/there-is-no-clean-architecture.html

[masayuki-0319]

やはりどのプロジェクトでもある程度統一的なディレクトリである Rails は神