Capa de Acceso a Datos (DAL)
Prioridad: P1 (ALTA)
Centraliza todo el acceso a datos (Base de Datos y APIs Externas) para garantizar una seguridad, autorización y almacenamiento en caché consistentes.
Directrices de implementación
- Arquitectura: Crea una Capa de Acceso a Datos (DAL) en un archivo
services/olib/data.ts. Usaimport 'server-only'para evitar que la lógica del backend se filtre al bundle del cliente. - DTOs: Siempre transforma los datos sin procesar de la DB/API en Objetos de Transferencia de Datos (DTOs) antes de devolverlos a los componentes. Esto evita la filtración de campos sensibles (por ejemplo,
passwordHash). - Seguridad: Usa
taintObjectReferenceotaintUniqueValuede la APIexperimental_taintpara asegurarte de que los datos sensibles nunca lleguen accidentalmente a los Componentes Cliente. - Autorización: Coloca las comprobaciones de autenticación dentro de cada función DAL. No confíes en la capa de UI para imponer la seguridad. Usa
await auth()para verificar al usuario. - Caché: Envuelve las funciones DAL en
cache()de React para deduplicar solicitudes dentro de un solo ciclo de renderizado, evitando llamadas redundantes a la DB/API. - Manejo de errores: Lanza errores estandarizados (por ejemplo,
NotFoundError,UnauthorizedError) para ser capturados porerror.tsxde Next.js onotFound().
Limitaciones
- Componentes Cliente: No pueden importar archivos DAL. Deben usar Acciones del Servidor o Manejadores de Ruta como puentes.
Anti-Patrones
- Sin comprobaciones de auth fuera de DAL: Las comprobaciones de autenticación deben vivir dentro de las funciones DAL.
- No devolver instancias ORM sin procesar: Transforma a objetos DTO simples antes de devolverlos.
- No usar
fetch('localhost/api')en Componentes Servidor: Llama a las funciones DAL directamente. - Sin importaciones DAL en Componentes Cliente: Usa Acciones del Servidor o Manejadores de Ruta como puentes.