Upgrade to Pro — share decks privately, control downloads, hide ads and more …

"当たり前"を疑いましょ ~フレームワークからドメインを守るDrupalアーキテクチャ~

"当たり前"を疑いましょ ~フレームワークからドメインを守るDrupalアーキテクチャ~

Kazuya Umeki

November 18, 2025

Transcript

71 slides
  1. 01 Beginning... 02 Question 03 TDD Anti-Pattern 04 Isolating the

    domain Agenda 当たり前を疑う重要性 “分類要件でのTaxonomy選定ˮは当たり前なのか? TaxonomyDrivenDevelopmentにおけるアンチパターン 「ドメインの隔離」 フレームワークとの向き合い方、一例を紹介
  2. 当たり前を疑う重要性 01. Beginning... 「分類要件だ!よし Taxonomyを使おう!」 このような ˮ当たり前 ˮ や ˮベストプラクティス

    ˮ 。 あなたのチームで出来上がってませんか?無批判に受け入れていませんか? “実現したいこと ˮ・ˮ本来果たすべき使命 ˮ と向き合わずに "技術選定"に走っちゃってるケース、よくあるんじゃないでしょうか。
  3. 当たり前を疑う重要性 01. Beginning... ベストプラクティス 考え方が固定化される バイアス 「ベストプラクティス」という言葉を無批判に受け入れることで、 トレンド的なバイアスと思考的なバイアスがかかった状態。 無意識のうちに思考の柔軟性を失うリスクが出ます。 という言葉がもたらす副作用

    コミュニケーションの阻害 慣習や伝統を大事にする業界? 「ベストプラクティス」という言葉が持つ絶対的な響きは、チーム内で 私達が携わる IT業界・ソフトウェア業界 って、 の議論を抑制する原因にもなります。 「トレンドや新しい挑戦を蔑ろにしてまで、慣習や伝統を大事にしたい」 傾向はありませんよね。
  4. 分類要件での Taxonomy選定という選択は当たり前なのか? 02. Question 中~大規模システム Drupalの特徴や良さが活きる、比較的規模の大きい案件で利用さ れるケースが多い。 Drupalを選定したシステムにおける プロジェクトの特徴 モジュラーモノリス

    クラウドリソースが単一で済むことがまずないです。最低でも、アプ リサーバー・Databaseサーバーが必須。 要件に応じて検索エンジ ン、ファイルサーバー等も。 ブログシステムの案件はない ブログがメインのシステム構築の案件はほぼないんじゃないんで しょうか。
  5. 分類要件での Taxonomy選定という選択は当たり前なのか? 02. Question “Drupal選定ˮの背景には 「ブログシステム」の開発 ではなく、 “中~大規模 ˮ で

    ˮ高機能(複雑な)なシステムや業務用アプリケーション ˮ を構築したい といった背景があるのではないでしょうか。
  6. 分類要件での Taxonomy選定という選択は当たり前なのか? 02. Question 公式サイトを読んできました。 以下のようなユースケースが推奨されているみたい。 調査メモ • タクソノミーはコンテンツを分類するために使用されます •

    一般的な例: ブログウェブサイトの投稿を分類またはカテゴリー分け するために使用されるタグが挙げられます • フィールダブル • 他のエンティティから参照することが出来る 印象 • Drupal自体ブログサイトが起源となっている • ブログにおけるカテゴリングで活躍するモジュール https://www.drupal.org/docs/user_guide/en/structure-taxonomy.html
  7. 分類要件での Taxonomy選定という選択は当たり前なのか? 02. Question Taxonomyの強み Entityである CRUD、一覧、画面が搭載されている キャッシュ ... フリータギング

    公式ドキュメントにもちょっと強めに書いてありました。 ウェイトを保持できる 管理画面から並び替えを行うことができます。 階層構造 (親子構造 )を表現できる 先程の並び替えに通ずるんですが、階層構造の表現ができます。 GUIも Workflowが使える Workflowのシステムに対応しています。(D10.3 から) 提供されています。
  8. 分類要件での Taxonomy選定という選択は当たり前なのか? 02. Question Taxonomyの強みを評価 Entityである 強みというか、普通のことですよね。Drupal で Entity じゃないデータを扱

    うのはデメリットでしかない。 (逆にエンティティ化しなくていい、と思う部分もありますが) フリータギング Taxonomy Term じゃなくてもサポートされています。 Taxonomy Term 独自のものじゃないです。 ウェイトを保持できる これは一見強みなんですが、弱みでもあります。 例: 「Views:1ではこの並びをしたい」「Views:2ではこの並びをしたい」と いう要件が満たせません。 階層構造 (親子構造 )を表現できる これも上記と同様。条件に依る対応ができないです。 Workflowが使える タグへのWorkflow??いつ使うの?
  9. 分類要件での Taxonomy選定という選択は当たり前なのか? 02. Question • • • 並び替えをしたいためだけの TaxonomyTerm選定 ならその決断は悪手

    フリータギングをしたいためだけの TaxonomyTerm選定 ならその決断は悪手 「タグづけしたいため、カテゴライズしたいため」だけの TaxonomyTerm選定 ならその決断は悪手
  10. 分類要件での Taxonomy選定という選択は当たり前なのか? 02. Question 以下のフィールド勝手についてきますよね。 もうちょっと言うと ... • Author •

    投稿日時 • 更新日時 • ウェイト 要件上、本当に必要な項目でしょうか? いらないデータは極力排他すべきです。
  11. Taxonomy Driven Developmentにおけるアンチパターン 03. TDD Anti-Pattern 運用に沿った管理画面が作れてない 「商品カテゴリ」を編集しようとしたら、Termの編集画面に「著者」「更新日時」「ウェイト」な ど、ビジネス上無関係な項目が多すぎて混乱。 ドメインルールへの対応力低下

    ビジネスへの副作用 e.g. タグ名は絵文字を除去したい。 e.g. タグの補足文章はMarkdown入力を許可してシステムでバリデーションをかけてほし い。 パフォーマンス低下 フィールドの過剰な多用、履歴の過剰なカスタマイズ、を意識せずやっちゃってませんか? Viewsで一覧画面作っただけでも膨大なSQLクエリが発行されますよ。
  12. Taxonomy Driven Developmentにおけるアンチパターン 03. TDD Anti-Pattern SIP単一責任 )の崩壊 DrupalにおけるEntityって「永続化」が主とする責務だと理解しています。画面描画、ビジ ネスロジック、永続化、スキーマ管理、API、...

    ちょっとやりすぎですよね。 フレームワークへの過剰な依存 コードベースへの副作用 ビジネスロジックをHOOKやEventSubscriber、バンドルクラスに実装していませんか? ビジネスロジックがフレームワークの都合に縛られ、再利用性や移植性を損ないます。 テスタビリティの欠落 ビジネスロジックがフレームワークへ過度な依存がある場合、テストを書くコストが非常に高 くなり、結果的にテストが書かれなくなります。品質の低いコードが放置されるとバグの温 床となりますよね。
  13. Taxonomy Driven Developmentにおけるアンチパターン 03. TDD Anti-Pattern エンティティの使命 • 管理画面を提供する •

    ビジネスルール Drupalにおける当たり前 である • レンダリングロジック ˮエンティティ ˮ を疑ったアイデアを紹介します。 • API • ストレージ • スキーマ管理 • ...
  14. 04. ドメインの隔離 Laravel界隈 だと...。 「Laravel を綺麗に書きたいならまず Eloquent にビジネスロジックを書くな」 各フレームワークの界隈で有名な言葉 React界隈

    だと...。 「Next.js・VueのAPIに依存させるのはよくない。」 Go界隈 だと...。 「Gin使わずに net/httpでAPI作れよ。」
  15. 提示した例はあくまでも一例 凝集度を考えましょう フレームワークと向き合う上で、どのように設計を敷いていくかにつ ドメインが振る舞いやビジネスロジックに凝集できず、他の関心事と いては議論がつきません。 混ざり合っている状態はシステムとして健全ではありません。 あくまで一例として提示させていただきました。 予期しない副作用の温床となってしまいます。 フレームワークへの依存をやめよう 当たり前を疑うこと

    関心を分離してビジネスの革新に集中出来る状態を作った後に、フ 「もともと備わっているAPIを利用すること」も1つの正解です。 レームワークに組み込みを行いましょう。 ただ、複雑なシステムを開発する上で、そのˮ当たり前ˮには限界が (あくまでも一例ですが) あるのでは?という視点が重要です。 04. まとめ

More Decks by Kazuya Umeki

Other Decks in Technology