본문으로 건너뛰기
버전: v0.1.0

워크플로우 편집기

파이프라인 편집기의 인터페이스와 주요 기능을 소개합니다.

화면 구성

스크린샷 TODO

워크플로우 편집기 전체 와이드 샷 — 상단 툴바, 좌측 자산 라이브러리, 중앙 캔버스, 우측 인스펙터가 모두 보여야 합니다. 폴더 컨텍스트로 진입한 경우 상단의 잠긴 저장 위치 칩(컬렉션·폴더)도 함께 보여주세요.

1. 상단 툴바 (Action Bar)

파이프라인의 전반적인 제어와 상태를 관리합니다.

  • 뒤로 가기: 파이프라인 목록으로 돌아갑니다.
  • 제목 편집: 파이프라인의 이름이나 별칭을 클릭하여 수정할 수 있습니다.
  • 파이프라인 타입 배지: batch 또는 event 파이프라인인지 표시합니다.
  • 저장 위치 칩: 컬렉션·폴더에서 진입한 경우 잠긴 저장 위치(예: analytics / marketing-2025)를 표시합니다. /pipelines/edit로 직접 진입한 경우 칩은 비어 있고, 저장 시 위치 선택 다이얼로그가 열립니다.
  • 상태 표시: 현재 파이프라인의 상태(Ready, Running, Failed 등)를 보여줍니다.
  • 실행 이력 (Run History): 최근 실행 결과(성공/실패)를 색상 바 형태로 시각화합니다. (Batch 파이프라인 전용)
  • 저장/실행: 변경 사항을 저장하거나 파이프라인을 실행/정지합니다.
    • batch 파이프라인: Run / Stop 버튼
    • event 파이프라인: Register / Unregister 버튼
  • 설정 (Settings): 스케줄링, 실행 옵션을 모달에서 설정합니다(재설계됨 — 파이프라인 설정).

2. 왼쪽 패널: 자산 라이브러리 (Asset Library)

파이프라인에 추가할 수 있는 리소스들을 제공합니다.

  • Quick Add: 자주 사용하는 노드를 캔버스로 바로 드래그할 수 있습니다.
    • Dataset 노드 (서브타입: delta / kafka / rest / object)
    • Code 노드 (python / sql)
    • Entity / Relation 노드: 온톨로지에서 정의한 EntityType / RelationType 입출력 (ADR-0059)
    • HITL 노드: 실행 중간에 채팅 표면에서 사람 승인을 받는 단계
  • Collections: 컬렉션 트리에서 기존 데이터셋·코드·온톨로지 자원을 찾아 재사용할 수 있습니다.
  • 검색: 원하는 자산을 빠르게 찾을 수 있습니다.

3. 메인 캔버스 (Canvas)

워크플로우를 시각적으로 설계하는 공간입니다.

  • 노드 배치: 드래그 앤 드롭으로 노드를 배치하고 위치를 자유롭게 조정합니다.
  • 연결: 노드의 핸들을 드래그하여 데이터 흐름을 연결합니다.
  • 엣지 인라인 삭제: 연결선 위의 × 버튼(또는 선택 후 Delete)으로 연결만 즉시 제거합니다.
  • 노드 호버 하이라이트: 노드에 마우스를 올리면 해당 노드와 연결된 엣지가 강조되어 흐름을 즉시 파악할 수 있습니다.
  • 미니맵: 우측 하단에서 전체 구조를 조망하고 이동할 수 있습니다.
  • 컨트롤: 좌측 하단에서 확대/축소, 패닝/선택 모드 전환, 자동 정렬 기능을 제공합니다.

Undo / Redo

편집 중 마지막 변경을 되돌리거나 다시 적용할 수 있습니다.

단축키동작
Ctrl(Cmd) + Z되돌리기
Ctrl(Cmd) + Shift + Z 또는 Ctrl(Cmd) + Y다시 실행

Undo 스택은 캔버스 상의 노드/엣지 변경과 속성 편집 일부를 포함합니다. 저장 또는 배포 이후에도 편집 세션이 유지되는 동안에는 히스토리가 보존됩니다.

4. 우측 패널: 속성 (Inspector)

선택한 노드의 상세 속성을 설정합니다. 노드 유형에 따라 탭이 다릅니다.

Code 노드:

설명
Overview노드 이름, 설명 등 기본 정보
Code코드 편집기(Monaco Editor)로 스크립트 작성
Options입출력 연결 관리, 쓰기 모드, 실행 옵션
History배치 실행 이력 조회

Dataset 노드:

설명
Overview노드 이름, 설명 등 기본 정보
Schema데이터셋 스키마 조회 및 편집
Data데이터 미리보기

Entity / Relation 노드:

설명
Overview자원 별칭·시스템 이름, backing dataset 링크
Schema엔티티/관계 스키마 및 Identity Keys / Display Column
Data인스턴스 데이터 미리보기 (행 단위, PK 기반 fetch)

HITL 노드:

설명
Overview단계 이름·설명, 승인 표면(채팅 채널)·승인자 그룹
Schema입력 페이로드 스키마 (승인 요청에 함께 노출됨)
History과거 승인/거부 응답과 응답자

단축키

효율적인 작업을 위한 키보드 단축키를 지원합니다. ? 키를 눌러 전체 목록을 확인할 수 있습니다.

단축키기능
Delete / Backspace선택한 노드/엣지 삭제
Ctrl(Cmd) + S저장
Ctrl(Cmd) + D선택한 노드 복제
Ctrl(Cmd) + R파이프라인 실행
Ctrl(Cmd) + L자동 정렬
Ctrl(Cmd) + A전체 선택
Ctrl(Cmd) + Shift + D데이터셋 노드 추가
Ctrl(Cmd) + Shift + C코드 노드 추가
Esc선택 해제 / 인스펙터 닫기
?단축키 도움말