본문으로 건너뛰기
버전: v0.1.0

전역 검색 (Global Search)

전역 검색은 D.Hub 허브 전체를 가로지르는 단일 검색 명령 팔레트입니다. 컬렉션 경계를 넘는 데이터 자산, 온톨로지, 에이전트는 물론, 사이드바 메뉴와 페이지 자체까지 한 번의 검색으로 도달할 수 있습니다.

스크린샷 TODO

사이드바 최상단의 Search… 메뉴(돋보기 아이콘 + ⌘K / Ctrl+K 단축키 뱃지). 펼침 모드와 접힘 모드 양쪽을 비교 가능하면 좋습니다.

열기

  • 키보드 단축키: ⌘K (macOS) 또는 Ctrl+K (Windows)
  • 사이드바 첫 메뉴 — Search…: 모든 페이지에서 사이드바 1급 메뉴(Home 바로 아래)로 진입합니다. 접힘 모드에서도 동일한 아이콘으로 노출됩니다.
  • 홈 Hero 검색 트리거: 홈 화면의 Hero 영역에 노출되는 큰 검색 버튼. 사이드바 메뉴와 동일한 모달을 엽니다.

사이드바 메뉴의 라벨은 Search… / 검색… (말줄임표 )입니다. 클릭 즉시 페이지 이동이 아니라 다이얼로그가 열림을 의미하는 관습적 표기입니다.

이전 버전의 상단 중앙 검색 입력 막대는 제거되었습니다. 화면 상단의 페이지 타이틀·도구 영역이 더 넓게 보입니다.

검색 대상

섹션포함 유형
Jump to사이드바 메뉴 / 페이지 라우트 (예: Pipeline Builder, Graph Explorer, 설정·커넥터)
Catalog컬렉션, 데이터셋, 파이프라인, 코드, 지식, 대시보드
Ontology온톨로지 모델, 엔티티, 관계
Agents에이전트, 도구(Tool), 액터(Actor)

Jump to (페이지 바로가기)

자산 결과 위쪽에 표시되는 섹션으로, 사이드바 메뉴와 페이지로 즉시 이동할 수 있는 명령 팔레트입니다. Foundry "Quicksearch"의 JUMP TO 패턴을 참고했습니다.

스크린샷 TODO

검색어를 pipeline으로 입력했을 때 상단에 Jump to가 먼저 뜨고 그 아래 자산이 따라붙는 모습. 우측의 Page 뱃지가 보여야 합니다.

  • 노출 방식: 검색어가 사이드바 메뉴 또는 페이지 라벨·키워드·경로에 매칭되면 상위 5건이 표시됩니다.
  • 우측 뱃지: 모든 Jump 항목에는 Page 뱃지가 붙어 자산과 시각적으로 구분됩니다.
  • 즉시 노출: 자산 결과가 로딩 중이어도 Jump 섹션은 정적 데이터 기반이라 즉시 그려집니다.
  • 권한·기능 플래그: 관리자 전용 메뉴(/settings/users, /settings/groups)는 권한이 있을 때만, Labs Reports는 기능 플래그가 켜진 사용자에게만 노출됩니다.
  • 필터와 직교: 자산 유형 필터를 켜도 Jump 섹션은 영향받지 않습니다 — 메뉴는 항상 도달 가능해야 합니다.

매칭 우선순위는 정확 일치 → 접두 일치 → 단어 경계 일치 → 부분 일치 → 키워드 일치 → 경로 일치 순입니다. 한국어/영문 키워드 모두 검색 가능하도록 별칭이 등록되어 있습니다(예: "pipeline" ↔ "파이프라인", "graph" ↔ "그래프").

자산 결과: 필터 필 (Filter Pills)

검색 모달 상단에는 자산 유형별 필터 필이 섹션 그룹으로 배치됩니다. Jump to 섹션과 별개로 동작합니다.

  • All: 모든 유형

  • Catalog 섹션: 컬렉션 / 데이터셋 / 파이프라인 / 코드 / 지식 / 대시보드

  • Ontology 섹션: 온톨로지 모델 / 엔티티 / 관계

  • Agents 섹션: 에이전트 / 도구 / 액터

  • 각 필의 아이콘은 자산 유형 아이콘과 동일하여 결과 목록과 시각 일관성을 유지합니다.

  • 일부 필에는 힌트 문구가 함께 표시됩니다(예: 컬렉션, 엔티티).

  • 선택된 필은 primary 색상으로 강조됩니다.

자산 결과 구성

  • 그룹화: 자산 결과는 유형별 그룹으로 나뉩니다. 그룹 제목은 컬렉션, 데이터셋, 엔티티 등 한국어 라벨을 사용합니다.
  • 유형당 최대 노출: 유형별로 상위 5건이 노출됩니다. 더 많은 결과는 해당 섹션 필터를 선택해 확인합니다.
  • 온톨로지 딥 링크: 엔티티 결과를 클릭하면 해당 모델의 엔티티 편집 위치로 바로 이동합니다.
  • 공유 맥락: 결과에는 소유자와 소속 컬렉션이 함께 표시되어, 다른 팀의 자산도 맥락과 함께 즉시 식별할 수 있습니다.
  • 별칭 우선 표시: 자산에 별칭이 설정되어 있으면 별칭이 1차 라벨로, 시스템 이름은 보조 라벨로 표시됩니다.

키보드 네비게이션

  • / : Jump 섹션과 자산 섹션을 가로지르는 단일 통합 커서로 이동합니다.
  • Enter: 현재 선택된 항목으로 이동합니다.
  • Esc: 모달을 닫습니다.

최근 검색

최근 사용한 검색어는 모달 내부에 최대 5건 저장됩니다.

  • dhub2-recent-searches 키에 브라우저 로컬 스토리지로 보관됩니다.
  • 개별 항목을 삭제하거나, 한 번에 비울 수 있습니다.

홈 Recent Items 와의 관계

홈 화면의 Recent Items는 데이터 자산(컬렉션·데이터셋·코드·파이프라인·지식)만 표시하는 축약 뷰입니다. 온톨로지 엔티티와 에이전트를 포함한 전체 최근 항목은 최근 항목 페이지에서 확인할 수 있으며, 전역 검색의 자산 결과와 동일한 유형 그룹을 공유합니다.

  • 별칭과 이름 모두 검색: 별칭, 시스템 이름, 설명을 모두 대상으로 하며 가장 먼저 일치하는 필드 기준으로 정렬됩니다.
  • 권한 필터: 접근 권한이 없는 자산은 결과에 포함되지 않습니다.
  • 단축키 조합: ⌘K → 검색어 입력 → Enter로 첫 Jump 또는 첫 자산 결과로 즉시 이동.