4.6 KiB
4.6 KiB
| ui_doc_type | view_id | status | frame | source_evidence | regions | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| view | runtime | 구현됨 | null |
|
|
Runtime
View ID: runtime
Frame:
- 없음
Status: 구현됨
Source Evidence
| Type | Path | Notes |
|---|---|---|
| code | apps/client/lib/widgets/runtime_panel.dart |
RuntimePanel이 Edge selector, health check, Node status, provider command와 최근 command 결과를 렌더링한다. |
| code | apps/client/lib/widgets/runtime_panel_sections.dart |
operation history의 loading, error, empty, record 상태를 렌더링한다. |
| code | apps/client/lib/client_home_page.dart |
shell runtime section에 RuntimePanel을 주입한다. |
| docs | README.md |
model/provider/device operation은 Edge가 소유하고 Control Plane이 제어 요청을 전달하는 구조다. |
| user | 없음 | 초기 agent-ui 생성을 요청했다. |
Purpose
운영자가 선택 Edge에 health check를 보내고, Node 상태를 조회하거나 허용된 provider command를 실행한 뒤 operation 이력을 확인한다.
Primary Users
- IOP operator
- Node/provider operation을 검증하는 engineer
Primary Tasks
- active Edge 선택
- health check 실행
- Node status 조회
- provider command 전송
- operation execution history 확인
Information Priority
- active Edge와 command action availability
- command result status
- operation execution history
Regions
| Region ID | Purpose | Component | Priority | Notes |
|---|---|---|---|---|
runtime.header |
title, active Edge selector, refresh 표시 | edge-selector |
high | narrow width에서는 header control이 줄바꿈된다. |
runtime.edge-selector |
active Edge 선택 | edge-selector |
high | command target Edge를 결정한다. |
runtime.command-actions |
system/Node/provider command 실행 버튼 표시 | command-action-bar |
high | health check, Node status, provider command를 포함한다. |
runtime.command-status |
최근 command 결과 표시 | status-badge |
high | success/failure alert로 표시된다. |
runtime.operation-history |
operation execution history 표시 | operation-history-list |
medium | command id, selector, summary, error, status를 포함한다. |
Actions
| Action ID | Trigger | Result | Guard |
|---|---|---|---|
runtime.select-edge |
Active Edge dropdown change | 선택 Edge operations를 fetch한다. | Edge 목록이 있어야 한다. |
runtime.refresh |
Refresh icon button | 선택 Edge operations를 다시 fetch한다. | 선택 Edge가 있어야 한다. |
runtime.health-check |
Health Check button | health.check Edge command를 보낸다. |
loading 중이 아니어야 한다. |
runtime.node-status |
Node Status dialog submit | node.status Edge command를 target selector와 함께 보낸다. |
selector가 비어 있지 않아야 한다. |
runtime.provider-command |
Provider Command dialog submit | provider.command Edge command를 selector와 allowlisted command parameter로 보낸다. |
selector와 command가 비어 있지 않아야 하고 ollama_api에는 method/path가 필요하다. |
States
- loading: operations fetch 또는 command send 중 spinner/disabled action을 표시한다.
- empty: Edge가 없거나 operation history가 없으면 empty message를 표시한다.
- error: operations fetch 또는 command send failure를 error text/status로 표시한다.
- permission-denied: 현재 구현 근거 없음
Open Questions
- 없음
Decision History
- 2026-06-25:
RuntimePanel구현을 기준으로 runtime view를 정의했다. - 2026-08-02: 제거된 domain-agent 영역과 명령을 삭제하고 현행
health.check,node.status,provider.commandoperation으로 동기화했다.