[FEAT] 브랜드 검색 api 개발 #333
Description
개요
브랜드 검색 엔드포인트(/api/v1/brands/search) 구현
목표
- 사용자가 브랜드명을 입력하면 관련 브랜드를 빠르게 조회할 수 있다.
- 카테고리/태그 등 조건으로 결과를 좁힐 수 있다.
- 무한스크롤/페이지네이션에 적합한 형태로 응답한다.
작업 내용
- API 스펙 정의 (endpoint / query params / response)
- Repository 쿼리 구현 (키워드 LIKE, 조건부 where, 정렬)
- Service 로직 구현 (입력값 검증, 기본 정렬/기본 페이지 처리)
- Controller 추가 및 Swagger 문서화
- 테스트 코드 작성 (검색어 O/X, 필터 조합, 페이지/정렬)성능 고려: 인덱스 검토(brand_name 등), 과도한 N+1 방지(fetch 전략)
제안 API 스펙(안)
- GET /api/v1/brands/search
- Query Params
- keyword(optional): 브랜드명/소개 검색
- category(optional, multi): 스킨케어/메이크업/의류
- tag(optional, multi): 브랜드 태그(저자극 등)
- sort(optional): LATEST | MATCHING | POPULAR
- page / size
응답(예시)
result: 브랜드 카드 리스트 (brandId, brandName, logoUrl, simpleIntro, matchingRate, isLiked …)
pageInfo: totalElements, totalPages, currentPage, size, hasNext
추가 정보
- 키워드 미입력 시: 전체 리스트 반환 or 400 처리(팀 정책에 맞게)
- 빈 결과는 200 + 빈 배열로 반환
- sort 기본값: MATCHING(또는 LATEST)
추가 정보
기능 요청에 대한 추가적인 맥락이나 스크린샷이 있다면 첨부해주세요.