맛집 검색 서비스 기능 명세서

기능 1. 맛집 검색

• [ ] 키워드와 지역 정보(카테고리)를 기반으로 맛집을 검색할 수 있다.
• [ ] 정렬 조건을 선택할 수 있다.
  • [ ] 리뷰 개수 순
  • [ ] 정확도 순
• [ ] 검색 결과는 페이지네이션 형태로 제공된다.
• [ ] 검색은 네이버 지역검색 API를 기본으로 사용하며, 추후 카카오 로컬 API를 추가할 수 있도록 확장 가능한 구조로 작성한다.
• [ ] 외부 API 장애 발생 시, 자동으로 대체 API로 전환되어 서비스가 중단되지 않도록 한다.

기능 2. 인기 키워드 조회

• [ ] 사용자들이 많이 검색한 키워드를 최대 10개까지 제공한다.
• [ ] 각 키워드별 검색 횟수도 함께 응답에 포함된다.
• [ ] 실시간 누적 구조(예: Redis Sorted Set)를 기반으로 집계하며, 정확한 통계를 위해 주기적 정산이나 보정 로직을 고려할 수 있다.
• [ ] 빠른 응답을 위해 캐싱 또는 CQRS 방식 적용.

기능 3. 지역 기반 인기 키워드 조회

• [ ] 지역별로 인기 키워드를 제공한다. 예: 성수, 홍대, 강남, 정자 등
• [ ] 키워드 저장 구조는 지역 단위로 분리되어 있으며, 성능을 위해 Redis 키 설계 또는 색인 기반 접근이 적용된다.
• [ ] 정확도를 보장하기 위한 주기적 집계 전략이 함께 고려된다.

기능 4. 키워드 검색 기록 저장