305-frameworks-spring-boot-modulith

Spring Boot - Spring Modulith

Spring Boot のモジュラーモノリスに Spring Modulith のガイドラインを適用します。

このスキルで扱う内容

• Spring Modulith の BOM とスターター依存関係の選択
• アプリケーションモジュール向けのビジネス機能別パッケージ構成
• ApplicationModules の検証とアーキテクチャテスト
• 名前付きインターフェースと明示的に許可する依存関係
• モジュール間の疎結合を実現するドメインイベント
• @ApplicationModuleTest とシナリオベースのモジュール統合テスト
• 生成されるモジュールドキュメント、Actuator による公開、可観測性
• 信頼性の高いドメインイベントのためのイベント公開レジストリの選択

適用範囲： 参照ルール、公式の Spring Modulith ドキュメント、および適切な例・不適切な例に基づいて推奨事項を適用します。

制約事項

Spring Modulith の変更を適用する前に、プロジェクトがコンパイルできることを確認してください。改善後は、モジュール構造テストを含む完全な検証を実行してください。

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行してください
• 前提条件：プロジェクトが Spring Boot アプリケーションである必要があります。Boot を使用しない Java のモジュール化には、アーキテクチャまたは設計のスキルを使用してください
• ベースライン：Spring Boot 4.0.x および Spring Modulith の互換性マトリックスに合わせて依存関係を選択してください
• 安全性：コンパイルに失敗した場合は、直ちに作業を中止してください
• 検証：改善を適用した後、./mvnw clean verify または mvn clean verify を実行してください
• 適用前：詳細なルール、適切なパターン・不適切なパターン、公式ドキュメントへのリンクについて、参照資料を読んでください

このスキルを使用する場面

• Spring Boot アプリケーションに Spring Modulith を追加する
• Spring Modulith のモジュール境界をレビューする
• Spring Boot のモジュラーモノリスアーキテクチャを改善する
• @ApplicationModuleTest テストを追加する
• Spring Modulith のドキュメントを生成する
• Spring Modulith を使用して Spring Boot のモジュールをリファクタリングする

ワークフロー

1. 参照資料を読み、プロジェクト構造を調査する

references/305-frameworks-spring-boot-modulith.md を読み、Spring Boot のバージョン、Maven の依存関係、メインアプリケーションのパッケージ、現在のパッケージとモジュールの境界を調査します。

2. アプリケーションモジュールをモデル化する

ビジネス機能別のモジュール、パブリック API、内部パッケージ、名前付きインターフェース、意図的に許可する依存関係を特定します。

3. フレームワークに沿った変更を適用する

参照資料のパターンに従って、Spring Modulith の依存関係、パッケージアノテーション、アーキテクチャ検証テスト、ドメインイベント、モジュールテストを追加または改善します。

4. 検証を実行し、結果を報告する

適切なビルドとテストを実行します。特に ApplicationModules.verify() と @ApplicationModuleTest のカバレッジを確認したうえで、変更内容、リスク、今後必要なモジュール設計作業を要約します。

参照資料

詳細なガイダンス、例、制約については、references/305-frameworks-spring-boot-modulith.md を参照してください。