| Screen ID |
Screen Title |
진입 조건 |
| SRCH-RES-01 |
검색 결과 (SH_122_Searched) |
검색 오버레이에서 검색 실행(Enter/연관검색어 클릭/검색 버튼 클릭) |
검색 실행 후 진입하는 결과 화면. 상품 탭·피드 탭으로 구성되며, 검색 키워드가 브랜드와 매칭될 경우 브랜드 정보 영역이 조건부로 노출된다. 검색 진입 전 화면은 search-overlay.md 참고.
원본: 검색 마스터.md(SH_122_Searched) + 검색 정책.md(검색결과화면 섹션) 병합.
| 항목 |
기준 |
| 검색어 유지 |
검색 실행 후 입력한 검색어 그대로 표시 |
| 수정 가능 |
부분 수정 가능 |
| X 아이콘 |
텍스트 삭제 (페이지는 유지) |
| 실시간 제안 |
입력 시 검색 중 화면과 동일한 자동완성 드롭다운 표시 |
| 항목 |
기준 |
| 탭 구성 |
상품(N) · 피드(N) |
| 결과 없음 |
(0) 표시 |
| 기본 선택 탭 |
“상품” 탭 |
| 탭 전환 시 |
검색어 유지 + 스크롤 위치 초기화 + 탭별 레이아웃 유지 |
| 항목 |
기준 |
| 노출 조건 |
검색 키워드가 특정 브랜드와 매칭될 때만 표시 |
| 표시 정보 |
브랜드 이미지 · 영문 브랜드명 · 한글 브랜드명 · 관심 브랜드 토글 · 신상품 인디케이터(빨간 점) · 포커스 브랜드 (N)명 · 브랜드 보기 링크 |
| 포커스 브랜드 토글 |
클릭 시 상태 전환 |
| 브랜드 보기 |
브랜드 필터 적용 페이지로 이동 |
| 항목 |
기준 |
| 레이아웃 |
상품 목록 페이지(plp-main.md)와 동일 |
| 상품 카드 |
상품 카드 컴포넌트 스펙 규칙을 그대로 따름 |
| 정렬 옵션 |
신상품순, 인기순, 가격 높은순, 가격 낮은순 |
| 필터 기능 |
필터 버튼으로 검색 결과를 더 구체화 가능. 쇼핑 필터와 달리 현재 검색 결과 내에서만 필터가 적용됨. 기본 구성 및 추가 필터 옵션 모두 노출 |
| 상품 클릭 |
점수 증가 API 호출 + 상품 상세 이동 |
| 결과 없음 메시지 |
검색하신 결과가 없습니다. 문의 사항은 웍스아웃 웹/앱 우측하단으로 부탁드립니다 (정책 문구, 최신) |
| 결과 없음 시 추천 |
많이 본 상품(인기 상품·조회수 기준) + 최근 본 상품 |
| 항목 |
기준 |
| 레이아웃 |
피드 페이지와 동일 |
| 노출 조건 |
타이틀명 또는 컨텐츠 내 상품의 타이틀이 검색 키워드를 포함하는 컨텐츠 |
| 콘텐츠 클릭 |
각 콘텐츠 타입 상세 페이지로 이동 |
| 결과 없음 메시지 |
검색하신 결과가 없습니다. 문의 사항은 웍스아웃 웹/앱 우측하단으로 부탁드립니다 |
| 결과 없음 시 추천 |
없음 |
콘텐츠 타입별 점수 증가
| 콘텐츠 타입 |
scoreUp 호출 |
targetType |
| 에디토리얼 |
O |
CONTENT |
| 웨어 스타일 |
O |
PRODUCT (상품 ID 기준) |
| 숏폼 |
X |
HBLAB 조회수 시스템 별도 집계 |
- 브랜드명과 일치하거나 포함된 브랜드 리스트가 표시된다.
- 검색 전 화면(브랜드 추천)과 동일한 표시 요소를 사용한다: 브랜드 로고, 포커스 브랜드 설정/해제 버튼, 브랜드명, 신상품 뱃지, 브랜드 한글명, 포커스 브랜드 설정 회원 수, “브랜드 보러가기” 버튼.
- 브랜드 화면 내 검색 기능을 사용하면 자동 연관검색어로 브랜드만 노출된다.
- 검색 결과가 없을 경우 상품 탭에서는 하단에 많이 본 상품과 최근 본 상품이 노출된다. 피드 탭은 추천 영역이 없다.
- 상품 검색 결과는 상품 카드 컴포넌트 스펙을 그대로 따른다.
| 기능 |
API |
| 브랜드 정보 |
GET /v1/search?searchkeyword={keyword} |
| 상품 검색 |
GET /v1/products/newFilter?searchkeyword={keyword} |
| 피드 검색 |
구현 스펙 별도 확인 필요 |
운영 메모: 브랜드 정보 조회(GET /v1/search)와 상품 검색(GET /v1/products/newFilter)은 별도 API로 분리되어 있다.
| 기능 |
API |
| 상태 확인 |
GET /v1/bookmarks |
| 토글 |
POST /v1/bookmarks (targetId: 브랜드ID, targetType: "BRAND") |
| 호출 시점 |
scoreType |
targetType |
| 상품 클릭 |
SEARCH |
PRODUCT |
| 에디토리얼 콘텐츠 클릭 |
SEARCH |
CONTENT |
| 웨어 스타일 클릭 |
SEARCH |
PRODUCT (상품 ID) |
| 숏폼 클릭 |
— |
HBLAB 자체 집계 (scoreUp 미호출) |
| 확인 항목 |
확인 방법 |
정상 기준 |
| 상품 탭 결과 미노출 |
GET /v1/products/newFilter?searchkeyword= 응답 |
결과 수와 카드 수 일치 |
| 브랜드 영역 미노출 |
GET /v1/search?searchkeyword= 응답 |
브랜드 매칭 객체 존재 |
| 피드 탭 결과 미노출 |
피드 검색 API 응답 확인 |
결과 수와 탭 숫자 일치 |
| 관심 브랜드 토글 미반영 |
GET /v1/bookmarks 응답 |
targetType BRAND + 상태 갱신 |
| 숏폼 조회수 미반영 |
HBLAB 로그/집계 확인 |
HBLAB 자체 집계 정상 여부 |
| 상품 없음 시 추천 미노출 |
결과 없음 상태 판단 로직 확인 |
상품 탭 0건일 때만 추천 노출 |
| 증상 |
예상 원인 |
1차 조치 |
| 상품 탭 결과 미노출 |
상품 검색 API 실패 |
GET /v1/products/newFilter 확인 |
| 브랜드 정보 영역 미노출 |
브랜드 매칭 API 실패 |
GET /v1/search 응답 확인 |
| 피드 탭 결과 이상 |
피드 검색 API 응답 구조 변경 |
피드 응답 필드 확인 |
| 숏폼 조회수 미반영 |
HBLAB 집계 이슈 |
HBLAB 로그/집계 확인 |
| 항목 |
내용 |
| 검색 결과 없음 메시지 문구 |
검색 마스터.md는 검색 결과가 없습니다.(짧은 버전, 상품/피드 탭 공통), 검색 정책.md는 검색하신 결과가 없습니다. 문의 사항은 웍스아웃 웹/앱 우측하단으로 부탁드립니다(긴 버전). 본 문서는 최신 정책 문서 문구를 채택했으나 최종 확정 필요 |
| 피드 검색 API 스펙 |
마스터 원문에도 “구현 스펙 별도 확인 필요”로 명시 — 개발팀 확인 필요 |
| 버전 |
날짜 |
변경 내용 |
| v1.0 |
2026-07-30 |
최초 작성 — 검색 마스터.md(SH_122_Searched) + 검색 정책.md(검색결과화면 섹션) 병합 |