awesome-copilot/instructions/oqtane.instructions_ja.md

description	applyTo
Oqtaneモジュールパターン	**/*.razor, **/*.razor.cs, **/*.razor.css

Blazorコードスタイルと構造

• イディオマティックで効率的なBlazorとC#コードを書く。
• .NETとBlazor規約に従う。
• コンポーネントベースUI開発にはRazorコンポーネントを適切に使用する。
• コンポーネントベースUI開発にはBlazorコンポーネントを適切に使用する。
• 小さなコンポーネントにはインライン関数を優先するが、複雑なロジックはコードビハインドまたはサービスクラスに分離する。
• Async/awaitは該当する箇所でノンブロッキングUI操作を確保するために使用すべき。

命名規則

• コンポーネント名、メソッド名、パブリックメンバーにはPascalCaseに従う。
• プライベートフィールドとローカル変数にはcamelCaseを使用する。
• インターフェース名には「I」を接頭辞にする（例：IUserService）。

Blazorおよび.NET固有ガイドライン

• コンポーネントライフサイクルのBlazor組み込み機能を活用する（例：OnInitializedAsync、OnParametersSetAsync）。
• @bindでデータバインディングを効果的に使用する。
• BlazorでサービスのDependency Injectionを活用する。
• 関心の分離に従ってBlazorコンポーネントとサービスを構造化する。
• 常に最新版のC#を使用し、現在はrecord型、パターンマッチング、global usingsなどのC# 13機能を使用する。

Oqtane固有ガイドライン

• メインOqtaneリポジトリのベースクラスとパターンを参照。
• モジュール開発にはクライアントサーバーパターンに従う。
• Clientプロジェクトにはmodulesフォルダーに様々なモジュールがある。
• クライアントモジュールの各アクションは、ModuleBaseから継承する個別のrazorファイルで、index.razorがデフォルトアクション。
• データ取得のような複雑なクライアント処理には、ServiceBaseから継承し、servicesフォルダーに存在するサービスクラスを作成する。各モジュールに1つのサービスクラス。
• クライアントサービスはServiceBaseメソッドを使用してサーバーエンドポイントを呼び出すべき。
• ServerプロジェクトにはMVCコントローラーが含まれ、クライアントサービス呼び出しに一致するモジュールごとに1つ。各コントローラーはDIで管理されるサーバーサイドサービスまたはリポジトリを呼び出す。
• Serverプロジェクトはモジュールにリポジトリパターンを使用し、コントローラーに一致するモジュールごとに1つのリポジトリクラス。

エラーハンドリングと検証

• BlazorページとAPI呼び出しに適切なエラーハンドリングを実装する。
• ベースクラスからの組み込みOqtaneログ記録メソッドを使用する。
• バックエンドでエラー追跡にログ記録を使用し、ErrorBoundaryなどのツールでBlazorのUI レベルエラーキャプチャを検討する。
• フォームでFluentValidationまたはDataAnnotationsを使用して検証を実装する。

Blazor APIとパフォーマンス最適化

• プロジェクト要件に基づいてBlazorサーバーサイドまたはWebAssemblyを最適に活用する。
• メインスレッドをブロックする可能性があるAPI呼び出しやUIアクションには非同期メソッド（async/await）を使用する。
• 不要なレンダリングを削減し、StateHasChanged()を効率的に使用してRazorコンポーネントを最適化する。
• 必要でない限り再レンダリングを避け、適切な場所でShouldRender()を使用してコンポーネントレンダーツリーを最小化する。
• ユーザーインタラクションを効率的に処理するためにEventCallbacksを使用し、イベントトリガー時に最小限のデータのみを渡す。

キャッシュ戦略

• 特にBlazor Serverアプリで頻繁に使用されるデータにはインメモリキャッシュを実装する。軽量キャッシュソリューションにはIMemoryCacheを使用する。
• Blazor WebAssemblyでは、ユーザーセッション間でアプリケーション状態をキャッシュするためにlocalStorageまたはsessionStorageを活用する。
• 複数ユーザーまたはクライアント間で共有状態が必要な大規模アプリケーションには分散キャッシュ戦略（RedisまたはSQL Server Cacheなど）を検討する。
• データが変更される可能性が低い場合、冗長な呼び出しを避けるためにレスポンスを保存してAPI呼び出しをキャッシュし、ユーザーエクスペリエンスを向上させる。

状態管理ライブラリ

• コンポーネント間での基本的な状態共有にはBlazorの組み込みCascading ParametersとEventCallbacksを使用する。
• 適切な場合はPageStateやSiteStateなどのベースクラスに組み込まれたOqtane状態管理を使用する。
• アプリケーションが複雑になってもFluxorやBlazorStateのような追加依存関係の追加を避ける。
• Blazor WebAssemblyでのクライアントサイド状態永続化には、ページリロード間で状態を維持するためにBlazored.LocalStorageまたはBlazored.SessionStorageの使用を検討する。
• サーバーサイドBlazorでは、再レンダリングを最小化しながらユーザーセッション内で状態を管理するためにScoped ServicesとStateContainerパターンを使用する。

API設計と統合

• 外部APIまたはサーバープロジェクトバックエンドと通信するためにサービスベースメソッドを使用する。
• try-catchを使用してAPI呼び出しのエラーハンドリングを実装し、UIで適切なユーザーフィードバックを提供する。

Visual Studioでのテストとデバッグ

• すべての単体テストと統合テストはVisual Studio Enterpriseで行うべき。
• xUnit、NUnit、またはMSTestを使用してBlazorコンポーネントとサービスをテストする。
• テスト中の依存関係をモックするためにMoqまたはNSubstituteを使用する。
• ブラウザー開発者ツールとバックエンドおよびサーバーサイド問題にはVisual Studioのデバッグツールを使用してBlazor UI問題をデバッグする。
• パフォーマンスプロファイリングと最適化には、Visual Studioの診断ツールに依存する。

セキュリティと認証

• User.RolesなどのOqtaneベースクラスメンバーを使用して認証と認可を実装する。
• すべてのWeb通信にHTTPSを使用し、適切なCORSポリシーが実装されていることを確認する。