65 lines
3 KiB
Markdown
65 lines
3 KiB
Markdown
---
|
|
ui_doc_type: definition-index
|
|
surface_type: ops-dev
|
|
source_evidence:
|
|
- type: code
|
|
path: apps/client/lib/main.dart
|
|
notes: MaterialApp home으로 GitoHomePage가 연결된 단일 Flutter control surface scaffold.
|
|
- type: docs
|
|
path: README.md
|
|
notes: Gito는 platformless Git control plane이며 Flutter client는 control surface 경계만 잡혀 있음.
|
|
- type: docs
|
|
path: docs/architecture.md
|
|
notes: agent-shell은 UI package, iop는 backend/runtime을 소유하는 구조.
|
|
- type: docs
|
|
path: agent-roadmap/phase/agent-shell-iop-execution/milestones/iop-agent-run-bridge.md
|
|
notes: 현재 Milestone은 Flutter UI를 범위 제외로 두고 backend bridge를 다룸.
|
|
- type: user
|
|
path: null
|
|
notes: 사용자가 agent-ui 생성을 요청함.
|
|
---
|
|
|
|
# UI Definition
|
|
|
|
## Purpose
|
|
|
|
Gito의 Flutter control surface scaffold를 기준으로 현재 구현된 화면과 향후 UI 동기화 기준을 기록한다. 초기 기준은 ops/dev UI이며, product UI 전용 레이어는 아직 생성하지 않는다.
|
|
|
|
## Surface Type
|
|
|
|
- Type: ops-dev
|
|
- Notes: 현재 Flutter client는 control surface 경계만 있는 상태다. Product UI 확장은 별도 요청 또는 agent-shell 통합 결정 이후 추가한다.
|
|
|
|
## Source Evidence
|
|
|
|
| Type | Path | Notes |
|
|
|------|------|-------|
|
|
| code | `apps/client/lib/main.dart` | `MaterialApp`의 `home`이 `GitoHomePage`로 연결되어 있고, 본문은 `Gito control surface` 텍스트만 표시한다. |
|
|
| docs | `README.md` | Flutter client는 control surface 경계만 잡혀 있으며, agent interaction UI는 sibling `../agent-shell` package를 사용하는 방향이다. |
|
|
| docs | `docs/architecture.md` | `../agent-shell`은 UI/domain package, `../iop`는 backend/runtime 소유로 분리한다. |
|
|
| docs | `agent-roadmap/phase/agent-shell-iop-execution/milestones/iop-agent-run-bridge.md` | 현재 Milestone은 Flutter UI를 범위 제외로 두며 backend bridge를 다룬다. |
|
|
| user | 없음 | 사용자가 agent-ui 생성을 요청했다. |
|
|
|
|
## 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-25: 기존 Flutter scaffold와 프로젝트 문서를 근거로 `code-first` agent-ui 기준선을 생성했다.
|