Files
vexplor/frontend/components/dataflow/node-editor/nodes/FieldMappingNode.tsx
kjs 0743786f9b feat: 노드 기반 데이터 플로우 시스템 구현
- 노드 에디터 UI 구현 (React Flow 기반)
  - TableSource, DataTransform, INSERT, UPDATE, DELETE, UPSERT 노드
  - 드래그앤드롭 노드 추가 및 연결
  - 속성 패널을 통한 노드 설정
  - 실시간 필드 라벨 표시 (column_labels 테이블 연동)

- 데이터 변환 노드 (DataTransform) 기능
  - EXPLODE: 구분자로 1개 행 → 여러 행 확장
  - UPPERCASE, LOWERCASE, TRIM, CONCAT, SPLIT, REPLACE 등 12가지 변환 타입
  - In-place 변환 지원 (타겟 필드 생략 시 소스 필드 덮어쓰기)
  - 변환된 필드가 하위 액션 노드에 자동 전달

- 노드 플로우 실행 엔진
  - 위상 정렬을 통한 노드 실행 순서 결정
  - 레벨별 병렬 실행 (Promise.allSettled)
  - 부분 실패 허용 (한 노드 실패 시 연결된 하위 노드만 스킵)
  - 트랜잭션 기반 안전한 데이터 처리

- UPSERT 액션 로직 구현
  - DB 제약 조건 없이 SELECT → UPDATE or INSERT 방식
  - 복합 충돌 키 지원 (예: sales_no + product_name)
  - 파라미터 인덱스 정확한 매핑

- 데이터 소스 자동 감지
  - 테이블 선택 데이터 (selectedRowsData) 자동 주입
  - 폼 입력 데이터 (formData) 자동 주입
  - TableSource 노드가 외부 데이터 우선 사용

- 버튼 컴포넌트 통합
  - 기존 관계 실행 + 새 노드 플로우 실행 하이브리드 지원
  - 노드 플로우 선택 UI 추가
  - API 클라이언트 통합 (Axios)

- 개발 문서 작성
  - 노드 기반 제어 시스템 개선 계획
  - 노드 연결 규칙 설계
  - 노드 실행 엔진 설계
  - 노드 구조 개선안
  - 버튼 통합 분석
2025-10-02 16:22:29 +09:00

67 lines
2.7 KiB
TypeScript

"use client";
/**
* 필드 매핑 노드
*/
import { memo } from "react";
import { Handle, Position, NodeProps } from "reactflow";
import { ArrowLeftRight } from "lucide-react";
import type { FieldMappingNodeData } from "@/types/node-editor";
export const FieldMappingNode = memo(({ data, selected }: NodeProps<FieldMappingNodeData>) => {
return (
<div
className={`min-w-[250px] rounded-lg border-2 bg-white shadow-md transition-all ${
selected ? "border-purple-500 shadow-lg" : "border-gray-200"
}`}
>
{/* 입력 핸들 */}
<Handle type="target" position={Position.Left} className="!h-3 !w-3 !border-2 !border-purple-500 !bg-white" />
{/* 헤더 */}
<div className="flex items-center gap-2 rounded-t-lg bg-purple-500 px-3 py-2 text-white">
<ArrowLeftRight className="h-4 w-4" />
<div className="flex-1">
<div className="text-sm font-semibold"> </div>
<div className="text-xs opacity-80">{data.displayName || "데이터 매핑"}</div>
</div>
</div>
{/* 본문 */}
<div className="p-3">
{data.mappings && data.mappings.length > 0 ? (
<div className="space-y-1">
<div className="text-xs font-medium text-gray-700"> : ({data.mappings.length})</div>
<div className="max-h-[150px] space-y-1 overflow-y-auto">
{data.mappings.slice(0, 5).map((mapping) => (
<div key={mapping.id} className="rounded bg-gray-50 px-2 py-1 text-xs">
<div className="flex items-center justify-between">
<span className="font-mono text-gray-600">{mapping.sourceField || "정적값"}</span>
<span className="text-purple-500"></span>
<span className="font-mono text-gray-700">{mapping.targetField}</span>
</div>
{mapping.transform && <div className="mt-0.5 text-xs text-gray-400">: {mapping.transform}</div>}
{mapping.staticValue !== undefined && (
<div className="mt-0.5 text-xs text-gray-400">: {String(mapping.staticValue)}</div>
)}
</div>
))}
{data.mappings.length > 5 && (
<div className="text-xs text-gray-400">... {data.mappings.length - 5}</div>
)}
</div>
</div>
) : (
<div className="text-center text-xs text-gray-400"> </div>
)}
</div>
{/* 출력 핸들 */}
<Handle type="source" position={Position.Right} className="!h-3 !w-3 !border-2 !border-purple-500 !bg-white" />
</div>
);
});
FieldMappingNode.displayName = "FieldMappingNode";