ariadne/agent-roadmap/phase/operator-experience/milestones/operator-console.md
2026-07-24 05:45:04 +09:00

3.1 KiB

Milestone: 오류와 수정 작업 운영 화면

위치

목표

사용자가 조직의 열린 오류와 발생 추세를 확인하고, 오류별 분석 보고와 수정 작업 상태를 이해하며 필요한 경우 수정안을 승인하거나 병합 요청으로 이동할 수 있게 한다.

상태

[계획]

승격 조건

  • 없음

구현 잠금

  • 상태: 해제
  • SDD: 불필요
  • SDD 문서: 없음
  • SDD 사유: 앞선 API와 상태 계약을 소비하는 단일 저장소 UI 구현이며 agent-ui 정의와 화면 검증으로 완료 판단할 수 있다.
  • 잠금 해제 조건: 없음
  • 결정 필요: 없음

범위

  • agent-ui 기반 화면 정의와 사용자 검토
  • 조직 선택과 프로젝트 범위
  • 오류 목록, 상태·발생 횟수·최근 발생 필터
  • 오류 상세, 원본 발생 이력과 분석 보고
  • 수정 가능할 때만 노출되는 승인·거부 동작
  • 수정·검증·병합 요청 상태와 실패 원인
  • 프로젝트 연결 설정의 핵심 흐름

기능

Epic: [definition] 화면 계약

코드 전에 핵심 운영 흐름과 상태 표현을 고정한다.

  • [agent-ui] 오류 목록·상세, 수정 작업 검토와 프로젝트 연결 화면을 agent-ui로 정의하고 사용자 검토를 해결한다.
  • [api-model] API 응답을 화면 상태 모델로 변환하고 로딩·빈 상태·권한 없음·실패를 구분한다.

Epic: [workspace] 오류와 수정 작업 화면

사용자가 오류에서 검토와 병합 요청까지 이동할 수 있게 한다.

  • [error-list] 조직·프로젝트별 오류 목록, 상태·횟수·최근 발생과 필터를 제공한다.
  • [error-detail] 오류 원문 이력, 분석 보고, 수정 가능 여부와 표준 실패 원인을 보여준다.
  • [approval-action] 수정 가능하고 승인 대기인 정확한 수정안에만 승인·거부 동작을 노출한다.
  • [run-status] 분석·수정·검증 실행 이력과 병합 요청 링크 및 상태를 보여준다.
  • [connection-ui] 프로젝트, 오류 입력 출처, 저장소, 읽기 전용 운영 환경과 대상 규칙의 핵심 설정 흐름을 제공한다.
  • [ui-tests] 좁은 화면, 확대 글자, 키보드·스크린리더 의미와 주요 상태별 위젯 검사를 제공한다. 검증: Flutter 테스트·분석·웹 배포 빌드가 통과한다.

완료 리뷰

  • 상태: 없음
  • 요청일: 없음
  • 완료 근거: 없음
  • 검토 항목: agent-ui 사용자 검토, 권한·상태별 동작 노출과 접근성 검사
  • agent-ui 상태 반영: 해당 없음
  • 리뷰 코멘트: 없음

범위 제외

  • 고급 통계와 사용자 정의 대시보드
  • 모바일 네이티브 앱
  • 화면에서의 최종 병합 실행

작업 컨텍스트

  • 관련 경로: apps/client/
  • 표준선: 한국어 Material 3 반응형 구조를 유지하고 도메인 상태는 서버 계약을 원본으로 삼는다.
  • 선행 작업: 수정 정책과 승인·검증 흐름
  • 후속 작업: 없음
  • 확인 필요: 없음