3.5 KiB
3.5 KiB
Milestone: 운영 UI
위치
- Roadmap: ROADMAP.md
- Phase: PHASE.md
목표
운영자가 프로젝트, integration, source, workflow, dataset, evaluation과 release를 데이터베이스나 내부 파일을 직접 조회하지 않고 관찰·제어할 수 있게 한다. UI는 공통 Control Plane API와 권한·감사 계약만 소비한다.
상태
[스케치]
승격 조건
- 첫 사용자 역할과 역할별 핵심 운영 여정을 확정한다.
- 브라우저 중심 Flutter UI와 다른 전달 형태 중 초기 delivery surface를 확정한다.
- resource·workflow·quality 화면의 최소 정보 구조와 승인 동작을 정의한다.
- agent-ui를 생성하고 Control Plane API·권한 계약과 연결한다.
- API·권한·승인 흐름을 다루는 SDD 필요성을 확정하고 초안을 작성했다.
구현 잠금
- 상태: 잠금
- SDD: 필요
- SDD 문서: SDD.md
- SDD 사유: UI 소비 API, 사용자 역할, 권한, 수동 promotion·rollback과 audit 계약을 정의한다.
- 잠금 해제 조건:
- SDD 잠금이 해제되어 있다.
- SDD 사용자 리뷰가 승인/해결되었다.
- Acceptance Scenario가 Milestone 기능 Task와 연결되어 있다.
- Evidence Map이 완료 시 Roadmap Completion과 최종 검증 evidence로 검증 가능하게 연결되어 있다.
- 모든 승격 조건이 해소되고 Milestone 상태가
[계획]이다.
- 결정 필요:
- 첫 운영 UI의 delivery surface와 우선 사용자 역할
범위
- project·integration·source·knowledge base 관리 화면
- workflow run·step, dataset lineage와 artifact 탐색
- evaluation 비교, release promotion·rollback 승인 흐름
- 권한에 따른 action 노출과 audit reason 입력
- health·readiness·SLO 상태 조회
기능
Epic: [ops-ui] 운영자 Workflow
공통 API가 제공하는 상태와 명령을 역할에 맞는 운영 여정으로 구성한다.
- [resource-ui] project, integration, source와 knowledge base 상태를 조회·관리한다.
- [workflow-ui] workflow run, step progress, retry·cancel과 artifact lineage를 탐색한다.
- [quality-ui] evaluation 비교, promotion eligibility, 수동 승격과 rollback을 audit reason과 함께 제공한다.
- [accessibility-state] loading·empty·error·forbidden·stale revision 상태와 접근성 기준을 일관되게 표현한다.
완료 리뷰
- 상태: 없음
- 요청일: 없음
- 완료 근거: 스케치 단계이며
[계획]승격 뒤 기록한다. - 검토 항목: 사용자 결정, agent-ui, API·권한·승인 흐름
- agent-ui 상태 반영: 해당 없음
- 리뷰 코멘트:
[계획]승격 시 agent-ui 생성과 상태 반영 방식을 함께 확정한다.
범위 제외
- UI가 Control Plane 외 별도 운영 상태를 소유하는 구조
- production 배포·backup·restore 구현
- identity provider 제품 자체 구현
작업 컨텍스트
- 관련 경로:
apps/client/,api/openapi/,agent-ui/ - 표준선(선택): API-first UI, least privilege, explicit destructive action, auditable approval
- 선행 작업: Control Plane Resource API, Identity·권한과 감사
- 후속 작업: Production 신뢰성
- 확인 필요:
구현 잠금 > 결정 필요