PortalConsole(포털 콘솔) 서비스 경계

명칭(2026-09-13): 제품·저장소 이름은 PortalConsole(포털 콘솔)이다. 이전 표기는 외부 제품명 Portal Control Center, 내부 식별자 DirectoryService다. API 경로 …/directory/…, DB directory_service, 환경변수 접두 DIRECTORY_*, 코드 모듈명은 배포·계약 호환을 위해 유지한다. 전체 규칙은 UiPlatform/docs/PLATFORM_NAMING.md.

정식 책임

Portal Control Center는 사용자·조직·인증·포털 등록·포털 접근권한·capability·endpoint·운영 상태를 관리한다. ExploreGateway가 어떤 포털을 호출할 수 있는지 판단할 수 있도록 Control Plane catalog를 제공한다.

기능	Portal Control Center의 역할
사용자·조직	원본 디렉터리와 조직 관계 관리
인증·권한	중앙 인증, 포털 접근 Scope와 정책 제공
포털 catalog	포털 ID, 표시명, URL, 활성 상태, capability 관리
탐색 정책	검색·답변 capability, endpoint, timeout 정책 관리
공통 UI	UiCenter의 운영 상태·권한 연동을 위한 API 제공

소유하지 않는 기능

공통 UI 테마·릴리스의 작성과 배포 workflow는 UiCenter가 소유한다. 포털 업무 데이터와 검색은 각 도메인 포털이 소유하고, 다중 포털 조합은 ExploreGateway가 담당한다. 파일 본문과 파일 단위 권한은 FileStore가 소유하며, 문서 인덱싱·RAG·citation은 RAGCenter가 소유한다.

API 경계

/api/directory/v1/control-plane/catalog는 서버 간 호출을 위한 읽기 계약이다. 이 API는 업무 데이터를 반환하지 않으며, 등록된 포털의 실행 메타데이터만 반환한다. 실제 포털 API는 사용자 Scope와 포털 자체 권한을 다시 검증해야 한다.

기존 /api/directory/v1/ui-center/* API는 UiCenter의 릴리스·구독·배포 workflow를 위한 호환 계층으로 유지한다. 이 계층이 Portal Control Center가 공통 UI 운영 데이터를 소유한다는 의미는 아니다.