9.1 KiB
9.1 KiB
| ui_doc_type | views | |||||||
|---|---|---|---|---|---|---|---|---|
| views-index |
|
View Definitions
View Tree
| View ID | Status | Evidence | Description |
|---|---|---|---|
overview |
계획 | OtoConsoleOverview + Jenkins IA gate |
Control Plane endpoint, connection, authentication reference overview. 필수: 통합 header/breadcrumb/action(Dashboard root)이 shell/header에 존재한다. Jenkins IA gate 미충족, 후속 구현 대기. |
runners |
계획 | OtoRunnersSurface + Jenkins IA gate |
runner registry state and self-update action surface. 필수: Jenkins Nodes/Agents 목록 구조로 node 상태/현재 작업/연결 메시지를 스캔한다. Jenkins IA gate 미충족, 후속 구현 대기. |
pipelines |
계획 | OtoJobsSurface + Jenkins IA gate |
pipeline/job queue list and create job action surface. 필수: Dashboard job table density와 New Item 생성 entry가 존재한다. Jenkins IA gate 미충족, 후속 구현 대기. |
executions |
계획 | OtoExecutionsSurface + Jenkins IA gate |
execution list, detail expansion, write actions, log/artifact preview. 필수: Pipeline Graph View 스타일 Pipeline Overview/Stage Graph, Console Output, Build History가 run detail에 존재한다. Jenkins IA gate 미충족, 후속 구현 대기. |
artifacts |
구현됨 | OtoArtifactsSurface + Jenkins reference baseline |
artifact event list. Jenkins artifact browser-style list 반영 |
agent |
구현됨 | OtoAgentPanel |
embeddable agent-shell panel for OTO capabilities |
settings |
계획 | OtoConsoleShell fallback section + Jenkins IA gate |
runtime endpoint and browser policy details. 필수: Manage OTO(Manage Jenkins 대응) 관리 category grouping이 존재한다. Jenkins IA gate 미충족, 후속 구현 대기. |
Required Visible Primitives
후속 구현(02/03)이 widget 테스트로 확인해야 할 view별 required visible primitive와 메뉴 매핑 target이다. label은 후속 test assertion의 고정 기준 문자열이다.
| View | Required visible primitives | Global menu target | Context menu target |
|---|---|---|---|
overview |
통합 header, breadcrumb, Dashboard root |
Dashboard |
없음 |
pipelines |
New Item, job table row, Status |
New Item, Jobs |
Job: Status, Build History, Stages |
executions |
Build History, Pipeline Overview, Stage Graph, Console Output |
Build History |
Run: Pipeline Overview, Console Output, Artifacts, Build History |
runners |
Nodes 목록, node status |
Nodes |
없음 |
artifacts |
Artifacts 목록 row |
Artifacts |
Run: Artifacts |
settings |
Manage OTO category grouping |
Manage OTO |
없음 |
Navigation
overview->runners: rail navigationoverview->pipelines: rail navigationoverview->executions: rail navigationoverview->artifacts: rail navigationoverview->agent: rail navigationoverview->settings: rail navigationpipelines->executions: job execution id tapexecutions->artifacts: "View Artifacts Tab" action
Jenkins Left Menu Reference
Jenkins의 좌측 메뉴는 하나의 고정 global sidebar가 아니라 화면 컨텍스트별 task/action list다. OTO의 현재 60px rail은 Jenkins Dashboard 수준의 주요 destination 일부만 축약한 것이며, job/run 페이지의 세부 좌측 task menu는 아직 별도 contextual menu로 구현되어 있지 않다.
사용자 결정(2026-07-03): OTO Control Plane은 Jenkins 메뉴 모델 중 OTO에 바로 적용 가능한 항목만 1차 적용한다. Core 계약이나 source of truth가 없는 Jenkins 항목은 메뉴 자리를 만들지 않고 제외/후순위로 명시한다.
1차 적용 Global Menu
| Order | Jenkins menu model | OTO menu target | Target behavior |
|---|---|---|---|
| 1 | Dashboard / view root | overview |
Control Plane dashboard/home으로 이동한다. |
| 2 | New Item |
pipelines + job-create-form |
새 job/pipeline 생성 entry로 노출한다. |
| 3 | Jobs / item list | pipelines |
job 목록과 selected job status/context로 이동한다. |
| 4 | Build History |
executions |
execution history와 selected run context로 이동한다. |
| 5 | Nodes/Agents | runners |
OTO runner/node 목록으로 이동한다. |
| 6 | Artifacts |
artifacts |
실행 산출물 목록으로 이동한다. |
| 7 | Manage Jenkins |
settings / Manage OTO |
endpoint, policy, node/runtime 관리 category로 이동한다. |
| 8 | OTO-specific Agent | agent |
Jenkins parity 대상은 아니지만 OTO agent surface로 유지한다. |
1차 적용 Job Context Menu
| Order | Jenkins job menu model | OTO target | Target behavior |
|---|---|---|---|
| 1 | Status |
pipelines job status/detail |
selected job 상태와 최근 execution link를 보여준다. |
| 2 | Build History |
executions filtered/context list |
selected job의 execution history로 연결한다. |
| 3 | Stages / Full Stage View |
executions stage graph |
selected execution의 Pipeline Overview/Stage Graph로 연결한다. |
1차 적용 Run/Build Context Menu
| Order | Jenkins run menu model | OTO target | Target behavior |
|---|---|---|---|
| 1 | Pipeline Overview / stage detail |
executions stage graph |
Pipeline Graph View 스타일 primary region으로 연결한다. |
| 2 | Console Output |
log-preview |
selected execution log preview/full log로 연결한다. |
| 3 | Artifacts |
artifacts, execution detail artifacts |
selected execution artifacts와 global Artifacts view로 연결한다. |
| 4 | Build History |
executions list |
selected run 주변 history/context list로 둔다. |
제외/후순위 Menu Items
| Jenkins menu item | Decision | Reason |
|---|---|---|
People |
제외 | OTO 현재 범위에 user directory가 없다. |
Changes |
제외 | SCM change set source가 없다. |
Build Now |
후순위 | 기존 job 재실행/dispatch 계약이 명확해진 뒤 적용한다. |
Configure |
후순위 | job configuration surface가 생긴 뒤 적용한다. |
Replay |
후순위 | replay contract가 없다. |
Pipeline Syntax |
후순위 | OTO YAML/runner command authoring surface와 별도다. |
Common States
- loading
- empty
- error
- permission-denied
Common Permissions
- operator/admin: write action submit 가능 여부를 제어하는 최소 역할 후보. 현재 SDD 기준은 단일 역할과 표시 가능한 token reference다.
Jenkins Reference Mapping
| OTO View | Jenkins Reference | Structural Acceptance |
|---|---|---|
overview |
Dashboard, controller monitors, header status | Core/API 상태와 주요 진입점을 통합 header/breadcrumb 아래에서 스캔한다. |
runners |
Nodes and Clouds, agents list | runner를 Jenkins Nodes/Agents 목록 구조로 상태, 현재 작업, 연결 메시지 중심으로 목록화한다. |
pipelines |
Dashboard jobs, New Item, job page | Dashboard job table density의 pipeline/job 목록, New Item create action, 연결된 execution 이동을 갖춘다. |
executions |
Build/run detail, Build History, Console Output, Pipeline Graph View | 실행 목록에서 run detail로 확장하고 Pipeline Overview/Stage Graph, Console Output, Build History, artifact preview를 함께 갖춘다. Stage graph는 Jenkins IA gate 필수 항목이다. |
artifacts |
Build artifacts, workspace/artifact browser | artifact name/path를 빌드 산출물 목록처럼 스캔한다. 다운로드/브라우징은 후속 후보로 둔다. |
settings |
Manage Jenkins | endpoint, policy, local runtime preference를 Manage OTO 관리 category grouping으로 둔다. |
agent |
없음 | OTO 전용 agent-shell 확장 표면이며 Jenkins parity 대상에서 제외한다. |
Structural Layout Gate
- Jenkins
2.516+의 통합 header/breadcrumb/action 모델은 OTO view header와 action 영역의 필수 구조이며, 러프 참조가 아니라 Jenkins IA gate 항목이다. - 메뉴 구조는 Jenkins 기준 중 OTO에 적용 가능한 항목만 맞춘다. Dashboard-level left menu는 global navigation으로, job/run left task list는 page-local contextual menu로 분리해 구현한다.
- 현재 OTO 구현의 60px rail은 Jenkins Dashboard-level destination만 부분 대응하므로 Jenkins IA gate를 만족하지 못한다. 위 메뉴 계약을 만족하려면 코드 재작업이 필요하다.
- Pipeline execution 상세는 Blue Ocean보다 Pipeline Graph View를 active reference로 삼으며
Pipeline Overview/Stage Graph는 필수다. - pixel, spacing, color token, exact component parity는 이번 화면정의서 범위에서 제외한다.
- Jenkins IA gate primitive가 코드와 widget 테스트로 확인된 대상 view만 status를
구현됨으로 승격한다. 미충족 상태에서는계획으로 두고 설명에 미충족 사유를 남긴다.
Open Questions
- 없음