본문으로 건너뛰기

검색 화면 정책 문서

(2026년 3월 11일 updated)

1. 목적​

사용자가 도서명, 캐릭터명, 시리즈명, 테마 키워드로 콘텐츠를 빠르게 탐색할 수 있도록 검색 기능을 제공한다.

2. 진입 및 기본 구성​

  • 진입 방식: 상단 GNB의 검색 아이콘 클릭 시 진입
  • 검색 대상 필드:
    • 도서명
    • 캐릭터명
    • 시리즈명
    • 테마
  • 기본 레이아웃: 검색 전체 화면은 풀스크린 그리드 구조

2.1 검색 API​

항목내용
엔드포인트GET /api/books/search/
설명키워드 기반 도서 검색
Rate Limiting90회/분
인증선택 (비로그인 시에도 검색 가능)

3. 화면 상태별 정책​

3.1 검색 전 (기본 상태)​

  • 상단 검색 입력창 노출
  • 실시간 인기 도서 그리드 형태로 노출 (최대 50작품)
  • 정렬 기준: 기존 실시간 Top10 랭킹 점수 + 검색 클릭 기반 소폭 보정
  • 점수 기준: 최근 24시간 사용자 행동 데이터 기반 (1시간 단위 갱신)
  • 기준 시간대: UTC+9

점수 산정 방식 (최신 기준)​

사용자 행동점수
도서 페이지 뷰(PV) 1회+1점
관심 작품(찜하기) 추가+2점
스크롤 50% 이상 열람+2점
스크롤 90% 이상 열람+3점
같은 도서 하루 2회 이상 열람 시 추가 점수+1점
검색 결과에서 도서 클릭 진입 (1일 1회)+3점 (소폭 보정)

  • 검색을 통해 진입한 도서에 대해 +3점 보정

  • 동일 유저가 동일 도서에 여러 번 진입해도, 하루 1회까지만 적용

  • 키보드 기본 활성화 상태 유지

  • 인기 도서는 매시간 자동 갱신됨

3.2 검색 중 (입력 중)​

  • 실시간으로 키워드에 따라 결과 필터링
  • 검색어 일부만 입력해도 결과 노출 (ㄱㄴㄷ,abc)
  • 키보드 활성화 유지

3.3 검색 완료 (결과 있음)​

  • 키보드 비활성화
  • 관련 도서 목록 노출 (최대 2열 그리드, 무한 스크롤 가능)
  • 정렬 기준: 아래 검색 결과 노출 기준 참조

3.4 검색 결과 없음​

  • 안내 문구:

    "찾고 계신 작품이 없어요." "다른 도서, 시리즈, 캐릭터 또는 테마를 검색해 보세요."

  • 키보드 비활성화
  • 입력창 유지 → 즉시 재검색 가능

4. 검색 결과 노출 기준​

4.1 그룹 우선순위​

검색어가 여러 메타데이터에 중복 매칭될 경우, 아래 우선순위대로 그룹을 나눠 노출

  1. 도서명
  2. 시리즈명
  3. 캐릭터명
  4. 테마 키워드

4.2 각 그룹 내 정렬 기준​

1) 검색 정확도순

  • 검색어가 문자열 앞부분에 가까울수록 우선 노출 예: "겨울왕국" > "겨울이야기" > "신나는 겨울방학"

2) 사용자 행동 기반 점수순

  • 동일 그룹 내에서 아래 기준으로 인기 콘텐츠 우선 정렬
사용자 행동점수
도서 페이지 뷰(PV) 1회+1점
관심 작품(찜하기) 추가+2점
스크롤 50% 이상 열람+2점
스크롤 90% 이상 열람+3점
같은 도서 하루 2회 이상 열람 시 추가 점수+1점

※ 검색 클릭 진입 점수는 '검색 전 인기 도서 정렬'에만 반영됨 ※ 이 점수는 최근 24시간 내 행동을 기준으로 하며, 1시간 단위로 갱신됨 (UTC+9 기준)