콘텐츠로 이동
서울연구원 매뉴얼북

검색시스템 설계 문서

SI-DATA 문서

SI-DATA 통합검색 시스템 관련 문서입니다.

문서 목록

섹션 제목: “문서 목록”
#문서설명
1SLLM 검색시스템 계획서검색시스템 설계 및 계획
2SLLM 로컬환경 설치가이드로컬 개발 환경 설정
3작업보고서 2026-01-14작업 진행 보고

시스템 개요

섹션 제목: “시스템 개요”
  • 검색엔진: Elasticsearch 7.17.14 (Nori 형태소 분석기)
  • 검색 API: /si/combined/search (SearchController)
  • 주요 기능: 전문 검색, 패싯 필터, AI 인사이트, PDF/HTML 인덱싱

통합검색 아키텍처

섹션 제목: “통합검색 아키텍처”
[브라우저] → /si/search (Vue.js 2 SPA)
    │
    ├── /si/combined/search (SearchController::combinedSearch)
    │   ├── ES: elasticsearch_index_{db}_si (노드 검색)
    │   ├── ES: elasticsearch_index_{db}_static_html (Quarto 문서)
    │   └── ES: elasticsearch_index_{db}_documents (PDF 문서)
    │
    └── /api/llm-proxy/* (LlmProxyController → FastAPI)
        ├── /api/insight/generate (AI 인사이트)
        └── /api/keywords/expand (키워드 확장)
섹션 제목: “검색 패싯 (Faceted Search)”

5개 패싯 그룹 구현 완료 (2026-03-05):

#패싯 (UI)ES 필드택소노미구현 방식
1ITEM 타입field_serviceitem_service (depth 0, 9개)부모 TID → 자식 TID 확장 (getChildTidsForParent)
2간행물service_title.keyword— (원문 텍스트)ES aggregation 직접 사용
3주제분류field_category_datacategory_data (17개)resolveTaxonomyFacet() — 전체 표시
4시기분류field_seriescategory_period (4개)resolveTaxonomyFacet() — 전체 표시
5형태분류field_formatcategory_format (4개)resolveTaxonomyFacet() — 전체 표시

핵심 구현 패턴

섹션 제목: “핵심 구현 패턴”
  • resolveTaxonomyFacet(): 택소노미 전체 용어를 로드하고 ES 집계 결과와 병합하는 범용 헬퍼
  • count=0 항목도 표시 (.facet-item-disabled 스타일 적용, 클릭 불가)
  • 동적 ES 인덱스명: ElasticsearchIndexResolver 서비스 사용

ES 인덱스 현재 매핑 (elasticsearch_index_{db}_si)

섹션 제목: “ES 인덱스 현재 매핑 (elasticsearch_index_{db}_si)”
_language, body, created, field_category_data, field_data_year,
field_es, field_service, nid, service_title, status, title, type

미인덱싱 필드 (향후 추가 예정): field_item_type, field_series, field_format, field_chapter, field_keyword

관련 파일

섹션 제목: “관련 파일”
파일설명
web/modules/custom/si_data/src/Controller/SearchController.php통합검색 컨트롤러
web/modules/custom/si_data/js/si-combine-search.js검색 프론트엔드 (Vue.js 2)
web/modules/custom/si_data/templates/si-search.html.twig검색 UI 템플릿
web/modules/custom/si_data/src/Service/ElasticsearchIndexResolver.phpES 인덱스명 동적 해석
web/themes/custom/datasi/css/custom.css패싯 스타일 (facet-item-disabled 등)

관련 링크

섹션 제목: “관련 링크”