[BE] 어드민 spec 기반 큐레이션 목록 code 필터 추가

[bottlenote-app]

배경

어드민 spec 기반 큐레이션 목록에서 큐레이션 타입별 조회가 필요합니다.

현재 확인 시점 기준으로 code 기반 필터링은 지원되지 않는 것으로 파악됩니다.

@Whale0928 확인 부탁드립니다.

확인한 내용

• 대상 Admin API
  • GET /admin/api/v1/v2/curations
  • GET /admin/api/v1/v2/curations/feed
• Controller는 CurationSearchRequest를 @ModelAttribute로 받습니다.
• 현재 CurationSearchRequest 필드
  • keyword
  • isActive
  • page
  • size
• code 필드는 없습니다.
• Repository 검색 조건은 현재 curation.name LIKE :keyword, isActive 기준입니다.
• 응답에는 specCode가 포함되지만, 요청에서 code=WHISKY_TASTING_EVENT처럼 필터링하는 경로는 확인되지 않았습니다.

요청 사항

어드민 spec 기반 큐레이션 목록에서 spec.code 기준 필터링을 지원해주세요.

예상 요청 예시:

GET /admin/api/v1/v2/curations?code=WHISKY_TASTING_EVENT&page=0&size=20

필요 시 /v2/curations/feed도 동일 기준으로 지원 여부를 함께 검토해주세요.

구현 검토 항목

• CurationSearchRequest에 code 선택 파라미터 추가
• curation_spec.code 기준 필터링을 위해 curation/spec join 또는 specId 역조회 방식 적용
• 기존 keyword, isActive, page, size 동작 유지
• blank/null code는 미필터 처리
• RestDocs/request parameter 문서 반영
• 목록 응답의 기존 specCode 유지

완료 기준

• code 지정 시 해당 spec code의 큐레이션만 반환됨
• code 미지정 시 기존 목록 조회와 동일하게 동작함
• keyword/isActive와 조합해도 의도대로 필터링됨
• 관련 테스트 및 API 문서가 갱신됨

참고

• FE 확인 요청 맥락: 어드민 spec 기반 큐레이션 목록에 code 기반 필터링이 없는 것으로 보임
• 관련 코드 확인 파일
  • AdminSpecBasedCurationController.kt
  • CurationSearchRequest.java
  • AdminSpecBasedCurationService.java
  • CurationRepository.java
  • JpaCurationRepository.java

[bottlenote-app]

#298 개발 서버 배포 및 Admin API 동작 확인했습니다.

• 구현 PR: feat: add admin curation code filter bottle-note-api-server#658
• PR 상태: merge 완료
• CI: 전체 통과
• 개발 배포 workflow: 성공 확인

검증 요약:

• GET /admin/api/v2/curations?code=WHISKY_TASTING_EVENT 조회 시 해당 spec code 항목만 반환 확인
• 알 수 없는 code 입력 시 빈 결과 반환 확인
• GET /admin/api/v2/curations/feed?code=WHISKY_TASTING_EVENT도 동일 기준으로 필터 동작 확인
• 기존 Admin 인증 후 보호 API 접근 정상 확인

[bottlenote-app]

2026-07-06 상태 동기화: bottle-note-api-server PR #658 병합 및 development 배포/동작 확인 근거가 있어 이슈 상태를 개발배포로 갱신했습니다.