ERP-node/frontend/types/data-transfer.ts

/**
 * 데이터 전달 시스템 타입 정의
 * 컴포넌트 간, 화면 간 데이터 전달을 위한 공통 타입들
 */

/**
 * 데이터 수신 가능한 컴포넌트 타입
 */
export type DataReceivableComponentType = "table" | "form" | "input" | "select" | "repeater" | "form-group" | "hidden";

/**
 * 데이터 수신 모드
 */
export type DataReceiveMode =
  | "append" // 기존 데이터에 추가
  | "replace" // 기존 데이터를 완전히 교체
  | "merge"; // 기존 데이터와 병합 (키 기준)

/**
 * 변환 함수 타입
 */
export type TransformFunction =
  | "sum" // 합계
  | "average" // 평균
  | "concat" // 문자열 결합
  | "first" // 첫 번째 값
  | "last" // 마지막 값
  | "count" // 개수
  | "custom"; // 커스텀 함수

/**
 * 조건 연산자
 */
export type ConditionOperator = "equals" | "contains" | "greaterThan" | "lessThan" | "notEquals";

/**
 * 매핑 규칙
 * 소스 필드에서 타겟 필드로 데이터를 매핑하는 규칙
 */
export interface MappingRule {
  sourceField: string; // 소스 필드명
  targetField: string; // 타겟 필드명
  transform?: TransformFunction; // 변환 함수
  defaultValue?: any; // 기본값
  required?: boolean; // 필수 여부
}

/**
 * 데이터 수신자 설정
 * 데이터를 받을 타겟 컴포넌트의 설정
 */
export interface DataReceiverConfig {
  targetComponentId: string; // 타겟 컴포넌트 ID
  targetComponentType: DataReceivableComponentType; // 타겟 컴포넌트 타입
  mode: DataReceiveMode; // 수신 모드
  mappingRules: MappingRule[]; // 매핑 규칙 배열

  // 조건부 전달
  condition?: {
    field: string;
    operator: ConditionOperator;
    value: any;
  };

  // 검증 규칙
  validation?: {
    required?: boolean;
    minRows?: number;
    maxRows?: number;
  };
}

/**
 * 데이터 전달 설정
 * 버튼 액션에서 사용하는 데이터 전달 설정
 */
export interface DataTransferConfig {
  // 소스 설정
  sourceComponentId: string; // 데이터를 가져올 컴포넌트 ID (테이블 등)
  sourceComponentType?: string; // 소스 컴포넌트 타입

  // 타겟 설정
  targetType: "component" | "screen"; // 타겟 타입 (같은 화면의 컴포넌트 or 다른 화면)

  // 타겟이 컴포넌트인 경우
  targetComponentId?: string; // 타겟 컴포넌트 ID
  targetComponentType?: DataReceivableComponentType; // 타겟 컴포넌트 타입

  // 타겟이 화면인 경우
  targetScreenId?: number; // 타겟 화면 ID

  // 데이터 수신자 (여러 개 가능)
  dataReceivers: DataReceiverConfig[];

  // 전달 옵션
  clearAfterTransfer?: boolean; // 전달 후 소스 데이터 초기화
  confirmBeforeTransfer?: boolean; // 전달 전 확인 메시지
  confirmMessage?: string; // 확인 메시지 내용

  // 검증
  validation?: {
    requireSelection?: boolean; // 선택 필수
    minSelection?: number; // 최소 선택 개수
    maxSelection?: number; // 최대 선택 개수
  };
}

/**
 * 데이터 전달 결과
 */
export interface DataTransferResult {
  success: boolean;
  transferredCount: number;
  errors?: string[];
  message?: string;
}

/**
 * 데이터 수신 가능한 컴포넌트 인터페이스
 * 데이터를 받을 수 있는 컴포넌트가 구현해야 하는 인터페이스
 */
export interface DataReceivable {
  componentId: string;
  componentType: DataReceivableComponentType;

  /**
   * 데이터를 수신하는 메서드
   * @param data 전달받은 데이터 배열
   * @param config 수신 설정
   */
  receiveData(data: any[], config: DataReceiverConfig): Promise<void>;

  /**
   * 현재 컴포넌트의 데이터를 가져오는 메서드
   */
  getData(): any;
}

/**
 * 데이터 제공 가능한 컴포넌트 인터페이스
 * 데이터를 제공할 수 있는 컴포넌트가 구현해야 하는 인터페이스
 */
export interface DataProvidable {
  componentId: string;
  componentType: string;

  /**
   * 선택된 데이터를 가져오는 메서드
   */
  getSelectedData(): any[];

  /**
   * 모든 데이터를 가져오는 메서드
   */
  getAllData(): any[];

  /**
   * 선택 초기화 메서드
   */
  clearSelection(): void;
}