O que Camada de Acesso a Dados (DAL) faz?
Prioridade: P1 (ALTA)
Centralize todo o acesso a dados (Banco de Dados e APIs Externas) para garantir segurança, autorização e cache consistentes.
Diretrizes de Implementação
- Arquitetura: Crie uma Camada de Acesso a Dados (DAL) em um arquivo
services/oulib/data.ts. Useimport 'server-only'para evitar vazar lógica de back-end para o pacote do cliente. - DTOs: Sempre transforme dados brutos do DB/API em Data Transfer Objects (DTOs) antes de retorná-los aos componentes. Isso evita o vazamento de campos sensíveis (por exemplo,
passwordHash). - Segurança: Use
taintObjectReferenceoutaintUniqueValueda APIexperimental_taintpara garantir que dados sensíveis nunca alcancem acidentalmente Componentes Cliente. - Autorização: Coloque verificações de autenticação dentro de cada função DAL. Não confie na camada de UI para aplicar a segurança. Use
await auth()para verificar o usuário. - Cache: Envolva as funções DAL com
cache()do React para eliminar requisições duplicadas dentro de um único ciclo de renderização, evitando chamadas redundantes ao DB/API. - Tratamento de Erros: Lance erros padronizados (por exemplo,
NotFoundError,UnauthorizedError) para serem capturados porerror.tsxdo Next.js ounotFound().
Limitações
- Componentes Cliente: Não podem importar arquivos DAL. Devem usar Server Actions ou Route Handlers como pontes.
Anti-Padrões
- Nenhuma verificação de autenticação fora da DAL: A verificação de autenticação deve residir dentro das funções DAL.
- Nenhuma instância bruta do ORM retornada: Transforme em objetos DTO simples antes de retornar.
- Nenhum
fetch('localhost/api')em Server Components: Chame as funções DAL diretamente. - Nenhum import DAL em Componentes Cliente: Use Server Actions ou Route Handlers como pontes.