API 경계
API 서버는 요청과 응답 경계에 타입을 세운다
NestJS 서버 계약은 DTO, 서비스, 응답 모델, 예외 흐름이 같은 요청/응답 규칙을 바라보게 만드는 것이 핵심입니다.
dto
요청 DTO
body, params, query 값을 검증 가능한 타입으로 받고 변환 규칙을 둡니다.
service
서비스 로직
컨트롤러 밖에서 비즈니스 규칙과 저장소 접근을 한곳에 모읍니다.
response
응답 모델
클라이언트가 기대하는 필드만 반환하고 내부 엔터티를 그대로 노출하지 않습니다.
error
예외 흐름
인증 실패, 유효성 오류, 서버 오류를 상태 코드와 메시지로 구분합니다.
입구
DTO와 validation pipe가 잘못된 값을 서비스로 넘기지 않게
막습니다.
중앙
서비스는 타입이 보장된 값으로 DB와 외부 의존성을 호출합니다.
출구
응답 타입과 에러 형식을 고정해 클라이언트 코드가 예측 가능하게
만듭니다.