🧳

package by featureに関する記事や書籍のまとめ

2023/10/30に公開

1件

アーキテクチャ

設計

tech

最近、package by featureに関する記事やスライドが増えてきたように見受けられます。
この概念に対する調査、考え方、考察について、私の理解をまとめておこうかと思います。

今回は、簡単な説明と、起源と思われるものと参考記事をまとめます。
主に記事紹介をしつつ、合わせて関連概念を列挙します。

記事紹介だけで結構な量になったので、メリット・デメリット、実践方法等はまた別の記事を書く予定です。
[追記]

package by featureのメリット・デメリット

package by featureって要するにどういうこと？

アプリケーションのコードを、技術的な分類ではなく、機能や関心ごとにまとめて配置しよう！という設計（あるいは単にフォルダ分割の方法）の名称です。

簡単な例

技術的な分類(package by layer)
services, models, repositoriesといった、技術的なレイヤーの単位で分けられています。

package by feature
対して、こちらは、user, book, review, orderといった、オンライン書店アプリの機能に基づいて分類されています。

各々の比較、メリット・デメリット、導入や移行方法など、いろいろ考える範囲はあるのですが、主張としてはただこれだけで、難しいものではないと感じられるのではないでしょうか。

画像内テキスト

package by layer

online-bookstore/
├── services/
│   ├── UserService.ts
│   ├── BookService.ts
│   ├── ReviewService.ts
│   └── OrderService.ts
│
├── models/
│   ├── UserModel.ts
│   ├── BookModel.ts
│   ├── ReviewModel.ts
│   └── OrderModel.ts
│
├── repositories/
│   ├── UserRepository.ts
│   ├── BookRepository.ts
│   ├── ReviewRepository.ts
│   └── OrderRepository.ts
│

package by feature

online-bookstore/
├── features/
│   ├── user/
│   │   ├── UserModel.ts
│   │   ├── UserService.ts
│   │   └── UserRepository.ts
│   ├── book/
│   │   ├── BookModel.ts
│   │   ├── BookService.ts
│   │   └── BookRepository.ts
│   ├── review/
│   │   ├── ReviewModel.ts
│   │   ├── ReviewService.ts
│   │   └── ReviewRepository.ts
│   └── order/
│       ├── OrderModel.ts
│       ├── OrderService.ts
│       └── OrderRepository.ts
│

名称について

記事によって、各々の名前が微妙に異なる名前も見受けられます。今回は「package by feature」と呼びます。

前者
　- package by layer
　- package by type
　- 技術駆動パッケージング

後者

package by feature
folder by feature
...

誰がいい始めた？

明確な起源は不明ですが、おそらくJavaでの開発の際の設計のプラクティスとして言及されたものが最初と思われます。

また、そこから派生して、同種の概念はいろんな書籍や記事から述べられているようです。

コードをたくさん書いていれば同種の概念を複数の人が思い至る可能性も十分ありそうで、起源を定めるのは難しそうな印象があります。

直近でpackage by featureという名前でよく言及されるようになったので、この単語がより普及して、この手法に関する議論が集めやすくなれば良いなと思っています。

記事や書籍一覧

Java関連

package by featureの「package」はJavaでの開発での実践から由来しているようです。

Googleのindexによると、javapractices.comの記事は2006年からあり、私が知る限りで「package by feature」という名前が登場する最も古い記事です。

他のJava文脈っぽいものです。

有名どころ

エリックスエヴァンスのドメイン駆動設計

エリックスエヴァンスのドメイン駆動設計、第五章の中の「インフラストラクチャ駆動パッケージングの落とし穴」の節でも、同種の概念が述べられています。
原著が2003年出版であるので、同種の概念自体は古くから認識されていたのではないか、と思います。

書籍内では、「package by feature」という名前は出てきませんが、技術駆動（インフラストラクチャ駆動）でまとめる場合での問題点について述べられています。

出版年で考えると、上のJavaの記事よりも古いですし、もしかしたら、他のもっと古い言及は見つけられるかもしれません。
また、この書籍自体も、4GL系の言語に対してJavaが流行り始めた時代のものであったはずです。

Screaming Architecture

Screaming Architectureも、同種の概念と言えると思えます。
こちらは2011年です。
「叫んでいるか？」という観点が直感的で面白いですね。

先程のonline-bookstoreの例だと、user, book review, orderという名前は、オンライン書店アプリの構成要素に何があるのかを"叫んで"いるというわけです。
対して、services, models, repositoriesは、実装都合の話であり、そういったことを叫ぶべきではない、ということです。