128 lines
5.9 KiB
Markdown
128 lines
5.9 KiB
Markdown
---
|
|
ui_doc_type: view
|
|
view_id: executions
|
|
status: 구현됨
|
|
frame: null
|
|
source_evidence:
|
|
- type: code
|
|
path: packages/flutter/oto_console/lib/src/oto_executions_surface.dart
|
|
notes: "OtoExecutionsSurface 구현"
|
|
- type: code
|
|
path: apps/client/lib/src/app/oto_client_app.dart
|
|
notes: "execution actions, logs, artifacts snapshot 연결"
|
|
- type: docs
|
|
path: agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md
|
|
notes: "execution cancel/report/log/artifact write action과 감사 노출 경계"
|
|
- type: user
|
|
path: null
|
|
notes: "agent-ui 생성 요청"
|
|
regions:
|
|
- executions.header
|
|
- executions.state-panel
|
|
- executions.execution-list
|
|
- executions.execution-detail
|
|
- executions.action-toolbar
|
|
- executions.action-feedback
|
|
- executions.logs-preview
|
|
- executions.artifacts-preview
|
|
---
|
|
|
|
# Executions
|
|
|
|
View ID: `executions`
|
|
|
|
Frame:
|
|
- 없음
|
|
|
|
Status: `구현됨`
|
|
|
|
## Source Evidence
|
|
|
|
| Type | Path | Notes |
|
|
|------|------|-------|
|
|
| code | `packages/flutter/oto_console/lib/src/oto_executions_surface.dart` | `OtoExecutionsSurface` 구현 |
|
|
| code | `apps/client/lib/src/app/oto_client_app.dart` | execution actions, logs, artifacts snapshot 연결 |
|
|
| docs | `agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md` | execution write action과 감사 노출 경계 |
|
|
| user | 없음 | agent-ui 생성 요청 |
|
|
|
|
## Purpose
|
|
|
|
execution 상태를 확인하고, 상세 영역에서 cancel/report/log/artifact write action과 log/artifact preview를 조작한다.
|
|
|
|
## Primary Users
|
|
|
|
- operator/admin
|
|
- local developer
|
|
|
|
## Primary Tasks
|
|
|
|
- execution 목록과 상태 확인
|
|
- execution detail 확장/접기
|
|
- cancel/report/log/artifact action submit
|
|
- logs preview와 artifacts preview 확인
|
|
- artifacts tab으로 이동
|
|
|
|
## Information Priority
|
|
|
|
1. execution id, job id, runner id, state
|
|
2. action toolbar와 결과 feedback
|
|
3. logs/artifacts preview
|
|
|
|
## Jenkins Reference Alignment
|
|
|
|
- Jenkins Build History, build/run detail, Console Output, Pipeline Graph View를 OTO `executions` view의 active reference로 삼는다.
|
|
- 현재 구현은 execution list row를 tap해서 detail을 확장하는 구조이며, Jenkins build page의 run header, action list, console/artifact 영역을 한 row detail 안으로 압축한다.
|
|
- Pipeline Graph View의 stage graph, collapsible stage list, live log pane은 후속 조정 후보다. 현재 정의에서는 `executions.logs-preview`와 `executions.artifacts-preview`가 우선 대응한다.
|
|
- Blue Ocean restart/stage UI는 deprecated legacy reference로만 두고, 신규 정의 기준은 Pipeline Graph View로 맞춘다.
|
|
- cancel/report/log/artifact action은 Jenkins Abort/Restart/Console/Artifacts 흐름을 참고하되 OTO write action contract와 audit masking 기준을 우선한다.
|
|
|
|
## Target Layout Delta
|
|
|
|
- execution list와 selected run detail을 Jenkins Build History + build page처럼 list/detail 관계로 재정렬한다.
|
|
- selected detail은 run header, action toolbar, stage/step summary placeholder, log pane, artifact pane 순서로 구성한다.
|
|
- Pipeline Graph View의 graph/stage/log 통합 layout을 후속 구현 기준으로 두되, OTO에 stage graph 데이터가 없으면 summary placeholder를 먼저 둔다.
|
|
- 현재 코드는 selected run detail, action toolbar, stage summary placeholder, log pane, artifact pane 반영이 완료되어 `구현됨` 상태다.
|
|
|
|
## Regions
|
|
|
|
| Region ID | Purpose | Component | Priority | Notes |
|
|
|-----------|---------|-----------|----------|-------|
|
|
| `executions.header` | 화면 제목 | 없음 | high | `Executions` |
|
|
| `executions.state-panel` | loading/empty/error 표현 | `state-panel` | high | snapshot state 기준 |
|
|
| `executions.execution-list` | execution row 목록 | `record-list` | high | expandable row |
|
|
| `executions.execution-detail` | 확장된 execution 상세 | `record-list` | high | actions, logs, artifacts 포함 |
|
|
| `executions.action-toolbar` | cancel/report/log/artifact action | `execution-action-toolbar` | high | runner id 존재, not canceled, not submitting |
|
|
| `executions.action-feedback` | action 결과 표시 | `action-feedback` | medium | success/failed |
|
|
| `executions.logs-preview` | execution log preview | `log-preview` | medium | raw log 원문 복제 노출은 SDD 기준에서 주의 |
|
|
| `executions.artifacts-preview` | execution artifact preview | `artifact-list` | medium | artifact path 민감도는 SDD 기준에서 주의 |
|
|
|
|
## Actions
|
|
|
|
| Action ID | Trigger | Result | Guard |
|
|
|-----------|---------|--------|-------|
|
|
| `executions.toggle-detail` | execution row tap | detail expand/collapse | execution id 존재 |
|
|
| `executions.cancel` | Cancel button and confirmation | cancel execution draft submit | runner id 존재, not canceled, not submitting |
|
|
| `executions.report` | Report button | report execution draft submit | runner id 존재, not canceled, not submitting |
|
|
| `executions.append-log` | Log button | append log draft submit | runner id 존재, not canceled, not submitting |
|
|
| `executions.append-artifact` | Artifact button | append artifact draft submit | runner id 존재, not canceled, not submitting |
|
|
| `executions.view-artifacts` | View Artifacts Tab | `artifacts` view로 이동 | navigation handler 존재 |
|
|
|
|
## States
|
|
|
|
- loading: 중앙 progress indicator.
|
|
- empty: `No executions` state panel.
|
|
- error: `Error loading executions` state panel과 snapshot error message.
|
|
- permission-denied: 계획 `authorization-state` component에서 operator/admin 권한 실패를 display-safe message로 표현한다.
|
|
|
|
## Planned Extensions
|
|
|
|
- `authorization-state`: cancel/report/log/artifact action의 허용/거부, disabled/error 상태.
|
|
- `audit-action-summary`: cancel/report/log/artifact action의 actor/action/target/outcome/timestamp/reason metadata 요약.
|
|
|
|
## Open Questions
|
|
|
|
- 없음
|
|
|
|
## Decision History
|
|
|
|
- 2026-06-24: execution detail과 action toolbar를 주요 region으로 정의했다.
|