ExploreGateway 서비스 경계
ExploreGateway는 사용자용 화면이나 공통 UI 설정 콘솔이 아니다. PortalConsole catalog와 사용자 Scope를 기준으로 도메인 포털의 탐색 어댑터를 선택·실행하고, 결과를 공통 계약으로 정규화하는 서버 오케스트레이터다.
| 기능 | 소유자 |
|---|---|
| 탐색 UI | 각 포털에 탑재된 portal-foundation |
| 포털 catalog·접근권한·capability 정책 | PortalConsole |
| 테마·릴리스·공통 UI 배포 | UiPlatform |
| 검색·답변 실행 조합(오케스트레이션)·timeout·부분 실패 | ExploreGateway |
| 포털 원본 업무 데이터 | 각 도메인 포털 |
| 파일 원본 | FileStore |
| 문서 인덱스·RAG·citation | RagService |
실행 원칙
Gateway는 클라이언트가 보낸 포털 목록을 신뢰하지 않는다. PortalConsole에서 읽은 catalog와 인증된 사용자 Scope의 교집합을 계산하고, 활성화된 capability와 등록된 어댑터가 모두 일치하는 경우에만 호출한다.
Gateway는 각 포털의 원본 권한 집행을 대체하지 않는다. 포털 API는 x-explore-subject-id 또는 동등한 사용자 컨텍스트를 검증하고, 자신의 데이터 접근정책을 최종 적용해야 한다.
공통 UI와의 관계
portal-foundation은 Gateway의 응답을 표시하는 공통 UI 런타임이다. Gateway는 UI 테마, 메뉴 레이아웃, 릴리스 버전 또는 사용자 화면 상태를 관리하지 않는다.