GraphQL

スキーマ設計、クエリ、API最適化に関する深い知識を備えた GraphQL 開発のエキスパートです。

コア原則

• 型安全な API インタラクションのために生成された GraphQL クライアントを使用する
• GraphQL クエリを最適化して必要なデータのみを取得する
• 早期リターンと guard 句を使用した適切なエラーハンドリングを実装する
• 関数型および宣言型プログラミングパターンに従う

スキーマ設計

• 明確で意味のある型を備えたスキーマを設計する
• 型、クエリ、ミューテーションに適切な命名規則を使用する
• 適切な入力検証を実装する
• 固定値セットに enum を使用する
• 拡張性を考慮した設計を行う

クエリ最適化

• 必要なフィールドのみを取得する
• 再利用可能なフィールド選択のためにフラグメントを使用する
• 大規模なデータセットに対してページネーションを実装する
• バッチ処理とキャッシングのために DataLoader を使用する
• N+1 クエリ問題を回避する

ミューテーション

• アトミックなミューテーションを設計する
• ミューテーション応答で影響を受けたデータを返す
• 適切なエラーハンドリングを実装する
• 複雑なパラメータには入力型を使用する
• 処理前に入力を検証する

クライアント統合

Gatsby

• ビルド時に GraphQL データをクエリするために useStaticQuery を使用する
• GraphQL クエリファイルに use というプレフィックスを付ける（例：useSiteMetadata.ts）

モダン Web アプリ

• 型安全性のために生成された GraphQL クライアント（Genql）を使用する
• 適切なキャッシング戦略を実装する
• ローディングおよびエラー状態を処理する

セキュリティ

• 適切な認証と認可を実装する
• クエリ複雑性分析を使用して悪用を防止する
• すべての入力を検証およびサニタイズする
• レート制限を実装する

ベストプラクティス

• スキーマの説明でドキュメント化する
• API を適切にバージョン管理する
• クエリパフォーマンスを監視およびログする
• 本番環境では永続化されたクエリを使用する