oto/agent-ui/definition/views/overview/index.md

4.3 KiB

ui_doc_type view_id status frame source_evidence regions
view overview 구현됨 null
type path notes
code packages/flutter/oto_console/lib/src/oto_console_overview.dart OtoConsoleOverview 구현
type path notes
code apps/client/lib/src/app/oto_client_app.dart host app에서 overview surface mount
type path notes
docs agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md auth token reference는 표시 가능한 reference만 노출
type path notes
user null agent-ui 생성 요청
overview.header
overview.endpoints
overview.connection-status
overview.authentication
overview.actions

Overview

View ID: overview

Frame:

  • 없음

Status: 구현됨

Source Evidence

Type Path Notes
code packages/flutter/oto_console/lib/src/oto_console_overview.dart OtoConsoleOverview 구현
code apps/client/lib/src/app/oto_client_app.dart host app에서 overview surface mount
docs agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md auth token reference 표시 기준
user 없음 agent-ui 생성 요청

Purpose

Control Plane의 API endpoint, Core 연결 상태, authentication reference를 운영자가 한 화면에서 확인하게 한다.

Primary Users

  • operator/admin
  • local developer

Primary Tasks

  • HTTP/Wire endpoint 확인
  • health/readiness 연결 상태 확인
  • 표시 가능한 auth token reference 확인
  • Core status refresh 실행

Information Priority

  1. Core online/degraded/offline 상태
  2. HTTP/Wire endpoint와 browser API policy
  3. auth token reference와 refresh action

Jenkins Reference Alignment

  • Jenkins Dashboard와 administrative monitor의 역할을 OTO Core status summary로 축약한다.
  • Jenkins 2.516+ header/breadcrumb/action 모델은 overview.header의 제목, 상태 badge, refresh action 배치 참조로 둔다.
  • Jenkins controller URL, system health, security notice에 해당하는 정보는 OTO의 HTTP/Wire endpoint, health/readiness, auth token reference로 대응한다.
  • 이번 단계에서는 global search, breadcrumb overflow, theme picker 같은 Jenkins shell 기능은 scope에서 제외한다.

Target Layout Delta

  • page header는 Jenkins refreshed header처럼 제목, connection status, primary refresh action을 한 줄 우선순위로 정렬한다.
  • content는 controller monitor summary, endpoint detail, authentication/policy detail 순서의 운영 dashboard layout으로 재정렬한다.
  • endpoint tile과 connection grid는 유지하되, Jenkins dashboard처럼 status first scan이 가능하도록 상단 density를 높인다.
  • 현재 코드는 Jenkins-style header/status layout 반영이 완료되어 구현됨 상태다.

Regions

Region ID Purpose Component Priority Notes
overview.header 화면 제목과 연결 상태 badge status-badge high Build Operations Overview와 connection label
overview.endpoints HTTP/Wire endpoint와 policy 표시 endpoint-tile high config와 connection policy note 기준
overview.connection-status health/readiness 상태 grid connection-status-grid high checking/online/degraded/offline
overview.authentication active auth token reference 표시 auth-token-reference medium token 원문이 아니라 reference만 표시
overview.actions refresh action 없음 medium onRefresh가 있을 때만 표시

Actions

Action ID Trigger Result Guard
overview.refresh Refresh button Core connection snapshot reload onRefresh != null

States

  • loading: connection state가 checking일 때 status badge와 endpoint tiles에 checking 상태를 표시한다.
  • empty: endpoint 설정은 있으나 Core 응답 데이터가 없으면 degraded/offline 상태로 표현한다.
  • error: health/readiness error message를 connection status tile에 표시한다.
  • permission-denied: 현재 구현에는 별도 denied state가 없으며 SDD의 권한 실패 UX 확장 후보로 둔다.

Open Questions

  • 없음

Decision History

  • 2026-06-24: 구현 코드와 SDD 기준으로 overview region을 정의했다.