워크플로우 편집기
파이프라인 편집기의 인터페이스와 주요 기능을 소개합니다.
화면 구성
스크린샷 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 노드: 실행 중간에 채팅 표면에서 사람 승인을 받는 단계
- Dataset 노드 (서브타입:
- 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 | 선택 해제 / 인스펙터 닫기 |
? | 단축키 도움말 |