Skip to content

UiPlatform(UI플랫폼) 서비스 경계 ​

명칭(2026-09-13): 제품·저장소 이름은 UiPlatform이다(이전 UiCenter). 본문에 남은 UiCenter 표기는 코드 심볼·토큰 audience(ui-center)·포털 ID와 함께 유지되는 호환 표기다. 규칙과 유지 목록은 PLATFORM_NAMING.md.

정식 책임 ​

UiPlatform은 portal-foundation의 공통 UI 운영 콘솔이다. 테마·릴리스의 작성, 검증, 승인, 포털별 구독, 배포 요청과 적용 상태를 사용자에게 제공한다.

portal-foundation은 실행 가능한 공통 UI 런타임 패키지이고, UiPlatform은 그 패키지의 릴리스 생명주기를 관리한다.

외부 서비스 경계 ​

기능소유자
테마·릴리스 workflowUiCenter
포털별 UI 구독·배포 대상UiCenter
조직·사용자·인증·포털 접근권한Portal Control Center
포털 catalog·capability·endpoint 정책Portal Control Center
다중 포털 탐색 실행 조합(포털 어댑터 오케스트레이션)ExploreGateway
문서 인덱스·RAG·citationRAGCenter
포털 메뉴 구조(트리·퀵링크·그룹 접근)각 포털 (2026-09-13 결정)
모델·키·비용·감사(LLM 완성)ModelGateway(모델 게이트웨이)
AI 기능 등록·허용·쿼터·적용 현황(운영 표면)Portal Control Center(2026-09-14)
AI 기능 구현 Asset(계약·유틸·패턴)portal-foundation(@hohyun94/portal-ai)
플랫폼 문서 라이브러리(생성 문서 축적·조회)보관 = 오브젝트 스토리지(R2 platform-docs/) · 조회 표면 = Portal Control Center(2026-09-14) · 색인·질의 = RagService(후속)
온톨로지(개념·관계·용어 = 플랫폼 지식망)스키마·용어팩 = portal-foundation Asset(@hohyun94/portal-ai 하위) · 원장·조회·등록·승인 표면 = OntologyService(2026-10-16 개정) · 실데이터 = 각 소유자(ProcessCenter 프로세스 정의 · FileStore 문서) · 추출·색인 = ModelGateway · RagService/ExploreGateway · 등록·레일 하단 런처 = PortalConsole · 번역 실행(번역 팩 소비) = PortalConsole(2026-10-11 유지)
업무 데이터각 도메인 포털
포털별 비정형 파일 저장 라우팅(저장 백엔드·보존·허용 형식·RAG 발행 허용)FileStore(2026-09-15) · 운영 표면 = FileStore 자체 /admin + 콘솔 셸 레일 하단 런처(2026-10-16 개정 · FILE_STORE_SCOPE.md)

DirectoryService 호환 계층 ​

현재 배포 호환성을 위해 UiCenter의 서버 모듈은 Portal Control Center의 ui-center REST API를 호출한다. 이 호출은 위임된 관리 작업과 상태 조회를 위한 transitional adapter이며, UiCenter의 사용자용 관리 화면과 workflow 소유권을 Portal Control Center로 이전한다는 의미가 아니다.

향후 테마·릴리스 저장소를 UiCenter 자체 데이터 경계로 이전할 수 있다. 그때에도 Portal Control Center는 포털 접근정책과 포털 catalog를 계속 소유하고, UiCenter는 공통 UI 운영 데이터를 소유한다.

금지되는 의존성 ​

UiCenter는 포털 업무 데이터, 사용자별 업무 권한의 최종 판정, ExploreGateway의 탐색 실행 조합, RAGCenter의 문서 인덱스·RAG·citation, FileStore의 파일 본문, ModelGateway의 모델 접근·키·쿼터·비용·감사를 소유하지 않는다. OntologyService(온톨로지·용어 원장)는 포털 업무 데이터·문서 본문·모델 호출·색인 실행을 소유하지 않으며, PortalConsole 은 지식 서비스의 승인 용어를 읽기 소비(번역 팩)만 하고 표기·정의를 복제하지 않는다(2026-10-16).

AI 운영 표면(2026-09-14): AI를 사용하는 공통기능은 열린 기능(purpose) 레지스트리로 관리하며, 실행은 각 플랫폼 서비스(ModelGateway·ExploreGateway·RagService)가 소유하고 목록·정책·사용량 표면은 Portal Control Center(제어평면 콘솔)가 소유한다. 콘솔 서버가 서버 간 토큰으로 각 서비스를 호출하고, 브라우저는 서비스에 직접 붙지 않는다. Portal Control Center는 모델·키·색인·검색 실행을 소유하지 않는다(표시·정책·프록시만). 규격은 MODEL_GATEWAY_SCOPE.md §9 · AI_FEATURE_REGISTRY.md.

포털 메뉴 구조(메뉴 트리·퀵링크·그룹 접근 규칙)도 각 포털이 소유한다. UI플랫폼은 메뉴 데이터를 저장·배포하지 않으며, 공통 메뉴 UX 규칙과 컴포넌트만 제공한다(2026-09-13 결정).

저장 라우팅(2026-09-15): 포털별 비정형 파일을 어느 저장소(백엔드)에 어떤 정책으로 둘지는 FileStore가 소유하고, 목록·등록·진단 표면은 Portal Control Center 관리자 메뉴가 갖는다(브라우저는 FileStore에 직접 붙지 않고 서버 간 호출로만 접근). 콘솔은 파일 본문·저장 자격증명·버킷을 소유하지 않으며 화면에는 secretRef 이름만 표시한다. FileStore의 권한 게이트 작업(계정·권한·cleanup)은 FileStore 자신의 /admin 화면이 계속 담당한다. 규격은 FILE_STORE_SCOPE.md.

개정 (2026-10-16) — 운영 표면은 FileStore 자체 /admin + 콘솔 레일 하단 런처. 소유(FileStore)는 그대로이고 표면만 바꿨다. 콘솔 관리자 메뉴의 파일 보관 탭은 없애고, 등록된 file-store 포털 주소를 셸 레일 하단에서 새 창으로 연다(DECISION_LOG.md 2026-10-16 "파일 보관 표면 전환"). 콘솔의 서버 간 프록시 경로(FILE_STORE_*)는 유지 여부를 별도로 결정한다.

온톨로지 소유 이관(2026-10-16): 온톨로지·용어사전의 원장(표·감사·팩 발행·REST/tRPC)은 OntologyService 가 소유하고, PortalConsole 은 포털 등록(PLATFORM_SERVICE)과 셸 레일 하단 런처만 갖는다. 경로·응답 스키마·scope 이름(glossary:read·glossary:write)은 유지해 소비자 3곳(ProcessCenter·DocumentLibrary·GuideCenter)이 주소만 바꾼다. 번역 실행은 콘솔이 계속 소유하고(2026-10-11) 지식 서비스의 승인 용어를 서버 간 호출로 읽는다. 규격은 ONTOLOGY_SCOPE.md, 이관 절차·검증은 PortalConsole docs/ontology-ownership-move-plan.md.