---
ui_doc_type: components-index
components:
  - 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 IA shell/jobs gate | overall console scaffold with integrated header, breadcrumb, action slot, left menu, and selected section content. |
| `console-rail` | 계획 | `oto_console_shell.dart` + Jenkins IA gate | section navigation rail. `New Item`/`Build History`와 job context menu는 구현됨. `Nodes`, `Manage OTO`, run context menu는 03 후속 구현 대기. |
| `section-surface` | 구현됨 | `oto_console_shell.dart` + Jenkins IA executions/ops gate | generic titled empty/detail section shell. `Manage OTO` 관리 category grouping과 `System`/`Security`/`Browser policy` primitive가 widget 테스트로 확인됨. |
| `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` | 구현됨 | jobs/runners/executions/artifacts surface files + Jenkins IA shell/jobs/executions/ops gate | repeated entity list rows. Pipelines job table, Build History run detail, Nodes/Agents runner row density가 widget 테스트로 확인됨. |
| `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 IA executions/ops gate | cancel/report/log/artifact execution actions. run detail의 `Pipeline Overview`/`Stage Graph`, `Console Output`, `Artifacts` 연결 primitive가 widget 테스트로 확인됨. |
| `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 IA Required Primitives

아래 primitive는 러프 참조가 아니라 Jenkins IA gate 필수 항목이다. `Widget assertion target`은 후속 구현(02/03)의 widget 테스트가 고정 label로 확인해야 할 대상이고, `Menu target`은 대응하는 Jenkins 메뉴 모델 항목이다.

| Pattern | OTO Components | Widget assertion target | Menu target |
|---------|----------------|-------------------------|-------------|
| Navigation and app context | `console-shell`, `console-rail`, `section-surface` | 통합 header, breadcrumb, global menu(`New Item`, `Build History`, `Nodes`, `Artifacts`, `Manage OTO`), job/run context menu 분리 | Global: `New Item`, `Build History`, `Nodes`, `Artifacts`, `Manage OTO` |
| Entity status scanning | `record-list`, `status-badge`, `state-panel` | Dashboard job table / `Build History` / `Nodes` dense row와 primary id/status | Global: `Jobs`, `Build History`, `Nodes` |
| Write action outcome | `action-feedback`, `authorization-state`, `audit-action-summary` | build/abort/config action 결과와 권한 실패 display-safe message | Run action outcome |
| Pipeline/run detail | `execution-action-toolbar`, `log-preview`, `artifact-list` | `Pipeline Overview`, `Stage Graph`, `Console Output`, `Artifacts` | Run: `Pipeline Overview`, `Console Output`, `Artifacts` |
| Creation/config forms | `job-create-form`, `runner-self-update-form`, `endpoint-tile`, `auth-token-reference` | `New Item` create form, `Manage OTO` 관리 form density | Global: `New Item`, `Manage OTO` |
