계약 고정
엔드포인트 method, path, request DTO, response DTO, 오류 코드를 먼저 정한다.
입력 통과
ValidationPipe가 형식 오류를 걸러내고 controller는 사용자 컨텍스트를 service에 전달한다.
도메인 처리
service는 중복, 상태 전이, 권한 세부 조건을 확인한 뒤 transaction을 실행한다.
응답 변환
entity를 그대로 노출하지 않고 API 응답 모델로 매핑한다.
POST /orders
생성 명령
DTO 검증, 재고 확인, 주문 저장, 결제 준비
중복 제출 방지
GET /orders
목록 조회
사용자 범위, pagination, 정렬, projection
대량 조회 비용
PATCH /orders/:id
부분 변경
상태 전이 가능 여부와 소유권 확인
낙관적 잠금 가능
Mapper
응답 보호
비밀 필드와 내부 상태를 숨긴 DTO 반환
entity 직접 반환 금지