Couche d'accès aux données (DAL)
Priorité : P1 (HAUTE)
Centralisez tous les accès aux données (Base de données et API externes) pour garantir une sécurité, une autorisation et une mise en cache cohérentes.
Directives d'implémentation
- Architecture : Créez une couche d'accès aux données (DAL) dans un fichier
services/oulib/data.ts. Utilisezimport 'server-only'pour empêcher les fuites de logique backend vers le bundle client. - DTOs : Transformez toujours les données brutes (DB/API) en Data Transfer Objects (DTOs) avant de les renvoyer aux composants. Cela empêche la fuite de champs sensibles (ex :
passwordHash). - Sécurité : Utilisez
taintObjectReferenceoutaintUniqueValuede l'APIexperimental_taintpour garantir que les données sensibles n'atteignent jamais accidentellement les composants client. - Autorisation : Colocalisez les vérifications d'autorisation dans chaque fonction DAL. Ne comptez pas sur la couche UI pour assurer la sécurité. Utilisez
await auth()pour vérifier l'utilisateur. - Mise en cache : Enveloppez les fonctions DAL dans
cache()de React pour dédupliquer les requêtes au sein d'un même cycle de rendu, évitant ainsi les appels redondants à la base de données ou aux API. - Gestion des erreurs : Levez des erreurs standardisées (ex :
NotFoundError,UnauthorizedError) pour être capturées parerror.tsxde Next.js ounotFound().
Limitations
- Composants Client : Ne peuvent pas importer les fichiers DAL. Utilisez des Server Actions ou des Route Handlers comme passerelles.
Anti-patrons
- Pas de vérifications d'autorisation en dehors de DAL : Les vérifications d'autorisation doivent résider dans les fonctions DAL.
- Pas d'instances ORM brutes retournées : Transformez en objets DTO simples avant de retourner.
- Pas de
fetch('localhost/api')dans les composants serveur : Appelez les fonctions DAL directement. - Pas d'imports DAL dans les composants client : Utilisez des Server Actions ou des Route Handlers comme passerelles.