[BE] 리스트 검색 keyword 파라미터 추가

[bottlenote-app]

배경

시음회/큐레이션 리스트 검색 구현 검토 중, 현재 API 응답/요청 흐름에는 리스트 검색용 keyword 파라미터가 없는 것으로 확인되었습니다.

현 시점에서는 FE에서 받은 목록을 기준으로 임시 필터링하는 방향으로 진행하되, 서버 사이드 검색/페이지네이션 정합성을 위해 Product API에 keyword 검색 파라미터 추가가 필요합니다.

요청 사항

• Product 리스트 조회 API에 keyword 검색 파라미터를 추가합니다.
• keyword 입력 시 목록에서 노출되는 주요 텍스트 기준으로 검색 가능하도록 범위를 정의합니다.
  • 예: 제목/이름/설명 등 실제 FE 검색 UX에서 필요한 필드
• 검색 결과와 기존 필터/정렬/페이지네이션 조합이 함께 동작하도록 처리합니다.
• FE 임시 필터링을 API 검색으로 대체할 수 있도록 요청/응답 계약을 문서화합니다.

완료 기준

• FE가 리스트 조회 시 keyword 파라미터를 전달할 수 있습니다.
• keyword가 없을 때 기존 리스트 조회 동작은 유지됩니다.
• keyword가 있을 때 서버 사이드 검색 결과가 페이지네이션 기준과 일관되게 반환됩니다.
• 관련 API 문서/테스트가 갱신됩니다.

메모

• 현재 FE 작업은 우선 클라이언트 사이드 필터링으로 진행 예정입니다.
• 서버 사이드 검색이 없으면 페이지 단위 응답 이후 FE 필터링이 되어 전체 검색/무한스크롤 정합성이 깨질 수 있어 후속 백엔드 작업으로 분리합니다.
• 유사 이슈 검색 기준, 동일한 리뷰/리스트 keyword 파라미터 추가 이슈는 확인되지 않았습니다.

구현 PR

• feat: add curation feed search filters bottle-note-api-server#656

[bottlenote-app]

PR 연결 완료: bottle-note/bottle-note-api-server#656\n\n반영 범위: Product 큐레이션 feed API의 keyword 검색 파라미터 및 code 스펙 필터 추가, 문서/테스트 반영. PR은 이미 merge된 상태입니다.

[bottlenote-app]

@HyeJungPark 개발 서버 배포 및 Product 큐레이션 feed API 동작 확인했습니다.

• 개발 배포: main / 1acb357
• API 문서: https://bottle-note.github.io/bottle-note-api-server/bottle-note/product-api/product-api.html#_spec_기반_큐레이션_v2_피드_조회
• 개발 서버 API: https://api.development.bottle-note.com/api/v2/curations/feed
• 검증 예시: https://api.development.bottle-note.com/api/v2/curations/feed?code=WHISKY_TASTING_EVENT&size=10

검증 요약:

• code=WHISKY_TASTING_EVENT 기준 코드별 피드 조회 및 cursor 페이지 동작 확인
• keyword 단독, keyword+code 조합, 알 수 없는 code, 공백 조건 처리 확인
• feed payload는 x-feed.enabled=true 대상 필드만 포함되는 것으로 확인

[bottlenote-app]

SSoT 동기화: bottle-note-api-server PR #656 병합 및 development image tag(1acb357) 반영/개발 서버 검증 댓글을 확인해 상태를 개발배포로 갱신했습니다.