toki/oto
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
oto/agent-ui/definition/index.md

5.1 KiB
Raw Blame History

ui_doc_type surface_type source_evidence
definition-index ops-dev
type path notes
code packages/flutter/oto_console/lib/src/oto_console_shell.dart OtoConsoleShell, rail navigation, fallback section surface 구현
type path notes
code apps/client/lib/src/app/oto_client_app.dart Host MaterialApp이 overview/runners/pipelines/executions/artifacts surface를 mount
type path notes
docs agent-roadmap/phase/control-plane-product-surface/milestones/control-plane-security-audit-surface.md 운영 보안, 감사, UI 노출 범위가 현재 Milestone에 정의됨
type path notes
docs agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md auth token reference, action outcome, 감사 metadata 노출/마스킹 기준
type path notes
user null agent-ui 생성 요청

UI Definition

Purpose

OTO Control Plane Flutter 콘솔의 운영 화면, 반복 component, 상태 표현, write action 결과 표면을 agent와 사람이 같은 기준으로 읽을 수 있게 고정한다.

Surface Type

  • Type: ops-dev
  • Notes: 현재는 운영자용 Control Plane 콘솔을 다룬다. product UI 레이어는 요청될 때 brand/content/assets/tokens/motion 문서로 확장한다.

Source Evidence

Type Path Notes
code packages/flutter/oto_console/lib/src/oto_console_shell.dart OtoConsoleShell, rail navigation, fallback section surface 구현
code apps/client/lib/src/app/oto_client_app.dart host app이 콘솔 section surface를 실제 mount
docs agent-roadmap/phase/control-plane-product-surface/milestones/control-plane-security-audit-surface.md 운영 보안, 감사, UI 노출 범위
docs agent-roadmap/sdd/control-plane-product-surface/control-plane-security-audit-surface/SDD.md auth token reference와 audit metadata 노출/마스킹 기준
user 없음 agent-ui 생성 요청

External Reference Baseline

이 화면정의서는 pixel parity가 아니라 정보 구조와 러프한 운영 화면 배치를 맞추는 기준으로 Jenkins 최신 UI를 참조한다.

Reference 확인일 적용 기준
Jenkins weekly 2.571 changelog 2026-07-02 최신 weekly 기준. breadcrumb, System Log, task UI, dialog/apply animation 같은 운영 UI 보정이 계속 반영되는 기준으로 본다. URL: https://www.jenkins.io/changelog/
Jenkins LTS 2.555.3 changelog 2026-07-02 안정 배포 기준. Java 21+, permission/API token/security UI 변화와 LTS 호환 범위를 확인하는 기준으로 본다. URL: https://www.jenkins.io/changelog-stable/
Jenkins refreshed design 2.516.1+ 2026-07-02 통합 header/breadcrumb/action, 접근성 대비, 테마, responsive action 배치를 러프 레이아웃 참조로 삼는다. URL: https://www.jenkins.io/blog/2025/07/24/redesigning-jenkins-part-two/
Pipeline Graph View 2026-07-02 Pipeline/run 상세의 active reference. stage graph, stage list, logs를 한 화면에서 다루는 구조를 executions view의 후속 조정 후보로 둔다. URL: https://plugins.jenkins.io/pipeline-graph-view/
Blue Ocean 2026-07-02 2026년 7월 deprecation 예정이므로 신규 기준이 아니라 legacy comparison으로만 사용한다. URL: https://www.jenkins.io/doc/book/blueocean/getting-started/

Target Layout Status

  • 현재 Flutter 구현은 Jenkins 정렬 레이아웃 패스가 반영된 OTO console layout의 code evidence다.
  • Jenkins 정렬 목표가 이번 레이아웃 패스에서 코드와 검증으로 확인된 view/component는 구현됨 상태로 둔다.
  • 목표는 pixel parity가 아니라 header/action/status/list/detail/log/artifact의 정보 배치와 운영 밀도를 Jenkins 최신 UI 흐름에 맞추는 것이다.
  • 보안/감사 source of truth처럼 문서 계획만 있는 항목은 계속 계획 상태로 둔다.

Structure

  • views/: 화면 또는 업무 단위 정의
  • components/: 반복 UI 구성요소 정의
  • archive/: 현재 기준이 아닌 과거 정의/결정 로그

Reading Rules

  • 현재 UI 동기화는 이 디렉터리의 활성 문서를 기준으로 한다.
  • archive/**는 과거 비교, 복원, 특정 근거 확인 요청이 있을 때만 읽는다.

Sync Rules

  • frame-view가 있으면 view region id와 frame region id는 동일해야 한다.
  • view에서 참조한 component id는 components/ 아래에 정의되어야 한다.
  • frame은 definition을 대체하지 않는다.
  • 문서 계획만 있는 보안/감사 항목은 구현됨 상태로 쓰지 않는다.
  • 기본 코드 동기화는 .sync-state.json 기준 이후 변경분만 대상으로 한다.
  • 전체 동기화는 사용자가 명시한 경우에만 수행한다.

Decision History

  • 2026-06-24: Flutter 콘솔 구현을 기준으로 code-first agent-ui scaffold를 생성했다.
  • 2026-07-02: Jenkins 최신 weekly/LTS와 2.516+ refreshed UI를 러프 레이아웃 참조 기준선으로 추가했다.
  • 2026-07-03: Jenkins 정렬 레이아웃 패스 구현과 검증 근거를 바탕으로 대상 view/component status를 구현됨으로 갱신했다.