データアクセス層(DAL)
優先度:P1(高)
すべてのデータアクセス(データベースおよび外部API)を一元化し、一貫したセキュリティ、認可、キャッシュを確保します。
実装ガイドライン
- アーキテクチャ:
services/またはlib/data.tsファイルに データアクセス層(DAL) を作成します。import 'server-only'を使用して、バックエンドロジックがクライアントバンドルに漏洩するのを防ぎます。 - DTO: コンポーネントに返す前に、生のDB/APIデータを常に データ転送オブジェクト(DTO) に変換します。これにより、機密フィールド(例:
passwordHash)の漏洩を防ぎます。 - セキュリティ:
experimental_taintAPI のtaintObjectReferenceまたはtaintUniqueValueを使用して、機密データが誤ってクライアントコンポーネントに到達するのを確実に防ぎます。 - 認可: 認可チェックをすべてのDAL関数内に配置します。UI層に安全性を依存させないでください。
await auth()を使用してユーザーを確認します。 - キャッシュ: DAL関数をReactの
cache()でラップすると、単一のレンダリングサイクル内でのリクエストを重複排除し、冗長なDB/API呼び出しを防ぎます。 - エラーハンドリング: 標準化されたエラー(例:
NotFoundError、UnauthorizedError)をスローし、Next.jsのerror.tsxまたはnotFound()でキャッチできるようにします。
制限事項
- クライアントコンポーネント: DALファイルをインポートできません。ブリッジとしてサーバーアクションまたはルートハンドラーを使用する必要があります。
アンチパターン
- DAL外での認可チェックなし: 認証チェックはDAL関数内に存在しなければなりません。
- 生のORMインスタンスを返さない: 返す前にプレーンなDTOオブジェクトに変換します。
- サーバーコンポーネントでの
fetch('localhost/api')の使用禁止: DAL関数を直接呼び出します。 - クライアントコンポーネントでのDALインポート禁止: ブリッジとしてサーバーアクションまたはルートハンドラーを使用します。