---
ui_doc_type: view
view_id: overview
status: 구현됨
frame: null
source_evidence:
  - type: code
    path: packages/flutter/oto_console/lib/src/oto_console_overview.dart
    notes: "OtoConsoleOverview 구현"
  - type: code
    path: apps/client/lib/src/app/oto_client_app.dart
    notes: "host app에서 overview surface mount"
  - type: docs
    path: agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md
    notes: "auth token reference는 표시 가능한 reference만 노출"
  - type: user
    path: null
    notes: "agent-ui 생성 요청"
regions:
  - 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을 정의했다.
