Skip to content

RagService 관리자 포탈 시각 검증 ​

검증 일시: 2026-08-25 GMT+9

로컬 FastAPI 관리자 포탈을 임시 HTTPS 주소로 열어 desktop viewport에서 확인했다. portal-foundation의 dark token 계열을 반영한 좌측 rail, 독립 운영 현황 카드, RLS security invariant panel, ingestion/hybrid search/local model/lifecycle 정책 form이 정상 렌더링됐다.

검증 항목결과
한국어 제목·설명 렌더링통과
좌측 rail 및 5개 섹션 anchor통과
운영 현황 카드와 security invariant통과
chunking·재시도·worker·model·mecab-ko·lifecycle 설정 field통과
RRF k·안전 컨텍스트 수 control통과 — legacy vector/keyword 가중치 field가 제거되고 fn_hybrid_search_rrf 계약과 일치함
PDF 표 병합·HWPX native·격리 HWP adapter 안내통과 — 구조 parser의 온프레미스/라이선스 경계가 ingestion panel에 표시됨
Directory 관리자 토큰 입력현재 브라우저 세션 메모리에서만 입력되며 저장하지 않음
관리자 API 데이터 load격리 개발 토큰으로 /api/v1/admin/overview와 /api/v1/admin/settings를 성공적으로 별도 검증함

최신 화면은 Python 3.11 기반 RagService API image에서 http://127.0.0.1:8080/으로 재검증했다. 임시 preview에는 실제 DB를 연결하지 않았으므로 overview API의 데이터 값은 검증 범위에서 제외하고 static layout·설정 field·보안 안내만 확인했다.

정식 PortalConsole OIDC/session gateway 연동 전까지는 UI의 token 입력은 개발·검증 용도이다. 운영에서는 reverse proxy 또는 PortalConsole session exchange로 Authorization header를 주입하고 브라우저가 token 원문을 입력하지 않게 구성한다.

2026-08-25 — 고급 운영·평가 화면 ​

ragcenter-api:admin-ops-preview image를 host network 임시 container로 기동한 뒤 http://127.0.0.1:8080/#advanced-ops를 Chromium으로 확인했다. Navigation에 보안·자동화·평가 항목이 표시됐고, lifecycle form 뒤에 고급 운영 panel이 full width로 배치됐다. panel은 PDF Layout·private vision, PII·immutable audit, logical CDC, isolated Ragas tuning의 경계와 tuning candidate 영역을 명확히 구분했다.

토큰 없이 열린 preview에서는 API 기반 status card와 candidate list가 조회 대기 상태로 남는 것이 의도된 동작이다. 화면에는 source DB URL, token, raw RLS principal, raw query, raw context가 표시되지 않았다. 실제 Directory admin token과 fresh schema가 있는 환경에서는 /api/v1/admin/operations 및 /api/v1/admin/tuning/recommendations가 status/candidate를 채우며, reindex가 필요하지 않은 CANDIDATE만 user-click confirmation 뒤 승인할 수 있다.