Spring Data JPA와 QueryDsl을 함께 쓰는 검색 API 설계

문제 정의

검색 조건이 늘어날수록 Controller와 Service가 동시에 복잡해지는 문제가 있었습니다.

구현 경계

동적 조건 조립은 Repository 구현체에 두고, Service는 사용자의 의도를 명확한 query object로 넘깁니다.

• 조건 생성은 한 곳에 모읍니다.
• 응답 DTO 변환은 application 경계에서 처리합니다.

검증 기준

검색 조건이 비어 있을 때와 여러 조건이 조합될 때 같은 목록 contract를 유지해야 합니다.

tstype SearchQuery = {
  keyword?: string;
  tag?: string;
};