512-frameworks-micronaut-data

Micronaut Data ガイドライン

リレーショナルリポジトリと安全な SQL に Micronaut Data のパターンを適用します。

このスキルで扱う内容

• カラムマッピングのための @MappedEntity、@Id、@GeneratedValue、@MappedProperty
• CrudRepository / PageableRepository を拡張する @Repository インターフェース
• 派生ファインダーメソッドと名前付きパラメーターを使った @Query
• @Singleton サービスでの @Transactional（適切な場合は readOnly）
• リストエンドポイントでの Page と Pageable
• 読み取り中心のクエリ向けの DTO／インターフェースプロジェクション
• 楽観的ロックのための @Version
• 統合テスト：@MicronautTest + TestPropertyProvider + Testcontainers

適用範囲： 参照ルールと適切／不適切なコード例に基づいて推奨事項を適用します。

制約事項

永続化に関する変更の前にコンパイルし、変更後にビルド全体を検証してください。

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行してください
• 安全性：コンパイルに失敗した場合は、直ちに停止してください
• 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行してください
• 適用前：詳細なルールと例について、参照資料を読んでください
• エッジケース：ユーザーの目的が曖昧な場合は、ファイルを編集したりプロジェクト全体に関わるコマンドを実行したりする前に、停止して確認の質問をしてください
• エッジケース：必要なコンテキスト、ファイル、認証情報、またはツールが不足している場合は、障害要因を明示して報告し、セットアップを進めるか代替案内を行うか確認してください
• エッジケース：依頼された変更がプロジェクトの制約または安全上の境界に抵触する場合は、抵触内容を説明し、望ましい折衷案についてユーザーに確認してください

このスキルを使う場面

• Micronaut Data のリポジトリやエンティティをレビューまたは実装するとき
• Micronaut の永続化レイヤーにトランザクション、ページネーション、またはプロジェクションを追加するとき
• Micronaut Data のエンティティとリポジトリをモデル化するとき
• Micronaut Data のトランザクションとページングクエリをレビューするとき
• Micronaut Data でプロジェクションまたは楽観的ロックを改善するとき

ワークフロー

1. 参照資料を読み、プロジェクトのコンテキストを評価する

変更を提案する前に references/512-frameworks-micronaut-data.md を読み、現在のプロジェクト設定を調査します。

2. 対象範囲を把握し、改善対象を決定する

依頼された成果、制約、および適用する変更のうち安全上必要な最小限の範囲を特定します。

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

参照パターンとプロジェクトの規約に従って、設定やコードを実装またはリファクタリングします。

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

適切なビルドやテストを実行し、変更内容、検証内容、およびその後の対応事項をまとめます。

参照資料

詳細なガイダンス、例、制約事項については、references/512-frameworks-micronaut-data.md を参照してください。