Resource 기준
resource 이름, method 의미, 요청 DTO가 같은 언어로 맞물려야 합니다.
RESTful API 설계 원칙과 구현 인터페이스 계약
REST API는 URL, method, status code가 함께 계약을 만듭니다. Nest controller에서 그 약속을 흔들리지 않게 고정합니다.
Controller 기준
path, param, query, body를 분리해 읽고 응답 status code를 명시합니다.
Service 기준
비즈니스 규칙은 service로 내려 REST 표현과 도메인 판단을 분리합니다.
201, 204, 400, 404 같은 결과를 성공과 실패 시나리오에 맞춰 둡니다.
Swagger 문서와 validation pipe가 같은 DTO를 바라보게 합니다.
멱등 요청과 재시도 가능 요청을 HTTP method 수준에서 구분합니다.