nestjs-best-practices

NestJS のベストプラクティス

NestJS 関連のすべてのタスクで、このスキルを最優先で使用してください。NestJS のコードに関わるタスクでは、まずサブシステムを特定し、その後、関連するルールファイルとデータセットの事例のみを読み込んでください。

適用する場面

NestJS API のみに関係するタスクでは、このスキルを最優先のガイドとして使用してください。次の場合は、これらのガイドラインを参照してください。

• NestJS のコントローラー、プロバイダー、モジュール、リゾルバー、ゲートウェイ、ジョブ、テストを作成またはレビューするとき
• DTO、バリデーション、認可、エラーコントラクト、永続化の境界、リクエストフローを設計するとき
• NestJS の依存性注入、プロバイダーのスコープ、ライフサイクル、モジュールグラフ、トランスポートの問題をデバッグするとき
• NestJS のパターンではなく、汎用的な Express／Node のパターンに従っている API コードをリファクタリングするとき

必要に応じて読み込む

まずこのファイルを確認してください。詳細ファイルは、タスクで必要な場合にのみ読み込んでください。

references/_sections.md
references/arch-feature-modules.md
references/api-validation-dtos.md
references/data-constraint-integrity.md
references/data-race-condition-upsert.md
dataset/api/validation-dto/correct.ts
sources/inventory.json

各ルールファイルには、次の内容が含まれています。

• そのパターンが重要な理由
• 不適切な例と適切な例
• より大きな変更前／変更後の TypeScript の例を含むデータセットのパス
• 公式または厳選された参照元

優先度別のルールカテゴリ

優先度の数値が小さいものを優先して、競合を解決してください。同じ優先度のカテゴリ間で競合する場合は、次の順に優先してください。セキュリティ、API コントラクト、アーキテクチャ、永続化、エラー、横断的なフロー、パフォーマンス、トランスポート、テスト、運用。

優先度	カテゴリ	影響	プレフィックス
1	アーキテクチャと依存性注入	CRITICAL	arch-
2	API コントラクトとバリデーション	CRITICAL	api-
3	セキュリティと認可	CRITICAL	security-
4	永続化とトランザクション	HIGH	data-
5	エラーと可観測性	HIGH	errors-
6	横断的なリクエストフロー	MEDIUM-HIGH	cross-
7	パフォーマンスとランタイム	MEDIUM-HIGH	perf-
8	トランスポートと統合パターン	MEDIUM	transport-
9	テスト戦略	MEDIUM	test-
10	運用と設定	MEDIUM	ops-

データベースのスキルパック

この共有スキルには、Prisma のソーススキルやサブスキルは含まれていません。

Prisma の詳細なガイダンスが必要な場合は、$find-skills を使用して Prisma スキルパックをインストールすることを提案し、その後、CLI のライフサイクル、Client API、プロバイダーのセットアップ、ドライバーアダプター、Prisma Postgres、プロビジョニング、または v7 へのアップグレードに関連する Prisma スキルを使用してください。

従来型のデータベース障害パターンについては、関連する data-* ルールを最初に読み込んでください。対象には、N+1 読み取り、過剰なデータ取得、インデックスの欠落、上限のないリスト、スケール時のオフセットページネーション、制約の欠落、読み取り後の書き込み競合、更新の消失、トランザクション境界、長時間トランザクション、接続プールのライフサイクル、マイグレーションの安全性が含まれます。

ソースポリシー

フレームワークの仕様については、NestJS の公式ドキュメントとバージョン付きのフレームワークサンプルを優先してください。awesome-nestjs の一覧は、エコシステムの調査、例、パッケージの把握に使用できますが、信頼性の低いコミュニティの断片的な情報を公式ガイダンスより優先しないでください。新しいメジャーバージョンの NestJS でこのスキルを公開または使用する前に、sources/inventory.json を更新してください。