| 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
- Core online/degraded/offline 상태
- HTTP/Wire endpoint와 browser API policy
- 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를 높인다.
- 현재 코드의 단순 centered list layout은 목표 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을 정의했다.
