H Point 프로젝트

배경

• 회의에서 API 호출 시 검색 상태(검색어, 필터링 등)를 출력으로 같이 넘겨야 한다는 요구가 공유됨.
• H Point 통합 검색 대상은 integrated-search-lambda의 get_items이며, 현재 성공 응답 body는 상품 배열만 반환함.
• 검색 상태 원천은 question, mode, sources, size/offset, queryOptions, excludeOptions, 개인화 식별자 등 요청 파라미터와 백엔드에서 실제 적용한 값에 있음.

작업 내용

• get_items 응답 계약을 기존 상품 배열 단독에서 items와 searchState를 포함하는 구조로 확장한다.
• searchState에는 최소한 검색어, 요청 mode, 실제 적용 mode, sources, size, offset, 정규화된 queryOptions, 정규화된 excludeOptions를 포함한다.
• 빈 검색어로 인해 mode가 lexical로 보정되는 경우 requestedMode와 appliedMode를 구분해 내려준다.
• 프론트 searchApi/types/App 호출부가 새 응답 구조를 처리하도록 반영한다.
• 마이그레이션 필요 시 기존 배열 응답도 프론트에서 방어적으로 처리한다.

제외/주의 사항

• Azure Search 내부 filter 문자열, indexName, 내부 필드명 등 구현 세부는 searchState에 그대로 노출하지 않는다.
• 입력 UI 상태를 서버 응답 searchState로 자동 덮어쓰지 않고, 표시/추적용 적용 상태와 입력 상태를 분리한다.
• 보조 API(facet/autocomplete) 지원 범위는 #819에서 별도 관리한다.
• 통합 테스트/배포 검증 항목은 #820과 연계한다.

완료 기준

• get_items 성공 응답이 items 배열과 searchState 객체를 함께 포함한다.
• searchState가 실제 적용된 검색어, 필터, sources, size/offset, requested/applied mode를 표현한다.
• raw filter_str 또는 indexName 같은 내부 구현 정보가 응답에 노출되지 않는다.
• 프론트 검색/더보기 흐름이 새 응답 구조에서도 정상 동작한다.
• integrated-search-lambda Python 테스트와 프론트 타입 빌드 또는 관련 검증이 통과한다.

관련 일감

• #819 통합 검색 프론트 보조 API 지원 여부 반영
• #820 통합 상품 검색 API 테스트 및 배포 검증