[Feat] 조회 및 검색 API 구현

[Uzrt]

#️⃣ 요청 유형

해당되는 항목을 선택해주세요.

• 새로운 기능 추가
• 기존 기능 개선
• 성능 개선

#️⃣ 기능 개요 (Summary)

기능에 대한 설명 : 무엇을, 왜 만드나요?

• 기능(What): 축제 추천/검색 및 상세 정보(타임테이블 포함) 조회 API 구현
• 이유(Why): 사용자가 날짜와 조건에 맞는 축제를 효율적으로 탐색하고, 특정 축제의 세부 일정을 확인하여 방문 계획을 수립할 수 있도록 하기 위함입니다. 특히 대규모 축제 데이터 조회 시 발생할 수 있는 시스템 부하를 방지하기 위해 고성능 페이징 처리를 도입합니다.

#️⃣ 기술적 설계

핵심 로직이나 DB 변경이 있는 경우에만 작성해주세요 (필요하다면 생략 가능)

• 대상 API:
  • GET /festivals/recommendations
  • GET /festivals
  • GET /festivals/{festivalId}
  • GET /festivals/{festivalId}/timetables
• 핵심 로직 (Key Logic):
  • Cursor-based Paging: OFFSET 기반 페이징의 성능 저하를 방지하기 위해 마지막 조회된 festivalId를 커서로 사용하여 조회 성능 최적화.
  • Join 전 필터링 (Inline View): 축제 목록 조회 시, 대량의 데이터 Join 전 인라인 뷰(서브쿼리)를 통해 조건에 맞는 ID를 우선 추출하여 메모리 부하 최소화.
  • 동적 필터링: 날짜별 추천 및 키워드 검색 시 서브쿼리를 활용한 동적 WHERE 절 구성.

#️⃣ 작업 상세 내용 (To-Do)

• GET /festivals/recommendations: 조건/날짜별 추천 축제 5개 조회 로직 구현
• GET /festivals: 커서 페이징이 적용된 축제 통합 검색 API 구현
• GET /festivals/{festivalId}: 축제 상세 정보 조회 API 구현
• GET /festivals/{festivalId}/timetables: 축제별 타임테이블(일정) 조회 기능 구현

📎 참고할만한 자료 (Optional)

스크린샷, 관련 문서, 코드 예시 등