데이터 접근 계층 (DAL)
우선순위: P1 (높음)
일관된 보안, 권한 부여, 캐싱을 보장하기 위해 모든 데이터 접근(데이터베이스 및 외부 API)을 중앙 집중화합니다.
구현 가이드라인
- 아키텍처:
services/또는lib/data.ts파일에 **데이터 접근 계층(DAL)**을 생성합니다. **import 'server-only'**를 사용하여 백엔드 로직이 클라이언트 번들로 누출되는 것을 방지합니다. - DTO: 원시 DB/API 데이터를 컴포넌트에 반환하기 전에 항상 **데이터 전송 객체 (DTO)**로 변환합니다. 이는
passwordHash와 같은 민감한 필드의 누출을 방지합니다. - 보안:
experimental_taintAPI의taintObjectReference또는 **taintUniqueValue**를 사용하여 민감한 데이터가 실수로 클라이언트 컴포넌트에 도달하지 않도록 합니다. - 권한 부여: 모든 DAL 함수 내에 권한 부여 검사를 공동 배치합니다. UI 계층이 안전을 강제하도록 의존하지 마십시오. **
await auth()**를 사용하여 사용자를 확인합니다. - 캐싱: React의 **
cache()**로 DAL 함수를 감싸서 단일 렌더링 주기 내에서 요청을 중복 제거하고, 중복된 DB/API 호출을 방지합니다. - 오류 처리: Next.js
error.tsx또는 **notFound()**에서 포착할 수 있도록 표준화된 오류(예:NotFoundError,UnauthorizedError)를 발생시킵니다.
제한 사항
- 클라이언트 컴포넌트: DAL 파일을 가져올 수 없습니다. 서버 액션 또는 라우트 핸들러를 브리지로 사용해야 합니다.
안티 패턴
- DAL 외부에서의 권한 부여 검사 없음: 권한 부여 검증은 DAL 함수 내에 있어야 합니다.
- 원시 ORM 인스턴스를 반환하지 않음: 반환하기 전에 일반 DTO 객체로 변환합니다.
- 서버 컴포넌트에서
fetch('localhost/api')사용 금지: DAL 함수를 직접 호출합니다. - 클라이언트 컴포넌트에서 DAL 가져오기 금지: 서버 액션이나 라우트 핸들러를 브리지로 사용합니다.