toki/oto

toki 4ad5a7340d feat(agent-ui): UI 정의서 및 템플릿 업데이트

- agent-ui 정의서 전체 구조 생성 (view/component/frame/wireframe)
- UI 관련 스킬 템플릿 및 규칙 문서 개선
- components: action-feedback, agent-chat-panel, artifact-list 등 20개 이상의 컴포넌트 정의서 추가
- views: agent, artifacts, executions, overview, pipelines, runners, settings 정의서 추가

2026-06-24 23:07:00 +09:00

3.2 KiB

Raw Blame History

ui_doc_type

view_id

status

frame

source_evidence

regions

view

overview

implemented

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: implemented

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

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을 정의했다.

3.2 KiB Raw Blame History