oto/agent-ui/definition/components/index.md

4.7 KiB

ui_doc_type components
components-index
console-shell
console-rail
section-surface
state-panel
status-badge
endpoint-tile
connection-status-grid
auth-token-reference
record-list
action-feedback
runner-self-update-form
job-create-form
execution-action-toolbar
authorization-state
audit-action-summary
log-preview
artifact-list
agent-chat-panel

Component Definitions

Component List

Component ID Status Evidence Description
console-shell 구현됨 oto_console_shell.dart + Jenkins reference baseline overall console scaffold with rail and selected section content. Jenkins-style header/action layout 반영
console-rail 구현됨 oto_console_shell.dart + Jenkins reference baseline section navigation rail. Jenkins navigation grouping 반영
section-surface 구현됨 oto_console_shell.dart + Jenkins reference baseline generic titled empty/detail section shell. Manage Jenkins-style fallback grouping 반영
state-panel 구현됨 surface files + Jenkins reference baseline loading, empty, error state blocks. Jenkins monitor/banner-style state 반영
status-badge 구현됨 overview/runners/jobs/executions surface files + Jenkins reference baseline compact status label badge. Jenkins result/severity vocabulary 정렬 반영
endpoint-tile 구현됨 oto_console_overview.dart endpoint or config value tile
connection-status-grid 구현됨 oto_console_overview.dart health/readiness status grid
auth-token-reference 구현됨 oto_console_overview.dart display-only auth token reference
record-list 구현됨 runners/jobs/executions/artifacts surface files + Jenkins reference baseline repeated entity list rows. Jenkins job/build/node row density 정렬 반영
action-feedback 구현됨 runners/jobs/executions surface files + Jenkins reference baseline success/deferred/failed action message. Jenkins action outcome 정렬 반영
runner-self-update-form 구현됨 oto_runners_surface.dart + Jenkins reference baseline runner self-update draft form. Jenkins update action density 정렬 반영
job-create-form 구현됨 oto_jobs_surface.dart + Jenkins reference baseline job create draft form. Jenkins New Item flow 정렬 반영
execution-action-toolbar 구현됨 oto_executions_surface.dart + Jenkins reference baseline cancel/report/log/artifact execution actions. Jenkins run action area 정렬 반영
authorization-state 계획 security/audit SDD operator/admin allow/deny, disabled, and error state rules for write actions
audit-action-summary 계획 security/audit SDD display-safe action metadata summary for audit-oriented UI exposure
log-preview 구현됨 oto_executions_surface.dart + Jenkins reference baseline bounded execution log preview. Jenkins Console Output/live log pane 정렬 반영
artifact-list 구현됨 oto_artifacts_surface.dart, oto_executions_surface.dart + Jenkins reference baseline artifact records in tab and execution detail. Jenkins artifact browser 정렬 반영
agent-chat-panel 구현됨 oto_agent_panel.dart agent-shell backed OTO assistant panel

Rules

  • component 정의는 구현 API가 아니라 UI 사용 규칙을 다룬다.
  • view별 변형이 필요하면 <component-id>/<variant>.md 또는 하위 디렉터리를 사용한다.
  • 실제 구현체 이름과 다를 수 있지만, view 정의서에서 참조하는 component id는 이 목록에 있어야 한다.

Jenkins Reference Patterns

Pattern OTO Components Notes
Navigation and app context console-shell, console-rail, section-surface Jenkins 2.516+ header/breadcrumb/action과 classic side task list를 러프 참조로 삼되, 현재 구현의 rail shell은 유지한다.
Entity status scanning record-list, status-badge, state-panel Jenkins dashboard job rows, build history, node status, administrative monitors처럼 상태와 primary id를 빠르게 읽게 한다.
Write action outcome action-feedback, authorization-state, audit-action-summary Jenkins build/abort/config action 이후 결과와 권한 실패를 display-safe message로 표현한다.
Pipeline/run detail execution-action-toolbar, log-preview, artifact-list Pipeline Graph View의 graph/stage/log 통합 흐름을 후속 조정 기준으로 삼는다.
Creation/config forms job-create-form, runner-self-update-form, endpoint-tile, auth-token-reference Jenkins New Item/Manage Jenkins류 form density를 참고하되 OTO runtime 계약에 맞춘다.