Data Access Layer (DAL)
Priorität: P1 (HOCH)
Zentralisieren Sie den gesamten Datenzugriff (Datenbank und externe APIs), um konsistente Sicherheit, Autorisierung und Caching zu gewährleisten.
Implementierungsrichtlinien
- Architektur: Erstellen Sie einen Data Access Layer (DAL) in einer
services/- oderlib/data.ts-Datei. Verwenden Sieimport 'server-only', um zu verhindern, dass Backend-Logik in das Client-Bundle gelangt. - DTOs: Wandeln Sie rohe DB-/API-Daten immer in Data Transfer Objects (DTOs) um, bevor Sie sie an Komponenten zurückgeben. Dadurch wird verhindert, dass sensitive Felder (z. B.
passwordHash) preisgegeben werden. - Sicherheit: Verwenden Sie
taintObjectReferenceodertaintUniqueValueaus derexperimental_taint-API, um sicherzustellen, dass sensitive Daten niemals versehentlich Client-Komponenten erreichen. - Autorisierung: Führen Sie Autorisierungsprüfungen innerhalb jeder DAL-Funktion durch. Verlassen Sie sich nicht auf die UI-Schicht, um die Sicherheit zu gewährleisten. Verwenden Sie
await auth(), um den Benutzer zu verifizieren. - Caching: Umschließen Sie DAL-Funktionen mit
cache()aus React, um Anfragen innerhalb eines einzelnen Renderzyklus zu deduplizieren und redundante DB-/API-Aufrufe zu vermeiden. - Fehlerbehandlung: Werfen Sie standardisierte Fehler (z. B.
NotFoundError,UnauthorizedError), die von Next.jserror.tsxodernotFound()abgefangen werden.
Einschränkungen
- Client-Komponenten: Können DAL-Dateien nicht importieren. Sie müssen Server Actions oder Route Handlers als Brücken verwenden.
Anti-Patterns
- Keine Auth-Prüfungen außerhalb des DAL: Die Autorisierungsüberprüfung muss innerhalb der DAL-Funktionen erfolgen.
- Keine rohen ORM-Instanzen zurückgeben: Wandeln Sie diese in einfache DTO-Objekte um, bevor Sie sie zurückgeben.
- Kein
fetch('localhost/api')in Server-Komponenten: Rufen Sie DAL-Funktionen direkt auf. - Keine DAL-Importe in Client-Komponenten: Verwenden Sie Server Actions oder Route Handlers als Brücken.