invyone/frontend/types/screen-embedding.ts

/**
 * 화면 임베딩 및 데이터 전달 시스템 타입 정의
 */

// ============================================
// 1. 화면 임베딩 타입
// ============================================

/**
 * 임베딩 모드
 */
export type EmbeddingMode =
  | "view"      // 읽기 전용
  | "select"    // 선택 모드 (체크박스)
  | "form"      // 폼 입력 모드
  | "edit";     // 편집 모드

/**
 * 임베딩 위치
 */
export type EmbeddingPosition =
  | "left"
  | "right"
  | "top"
  | "bottom"
  | "center";

/**
 * 임베딩 설정
 */
export interface EmbeddingConfig {
  width?: string;           // "50%", "400px"
  height?: string;          // "100%", "600px"
  resizable?: boolean;
  multi_select?: boolean;
  show_toolbar?: boolean;
  show_search?: boolean;
  show_pagination?: boolean;
}

/**
 * 화면 임베딩
 */
export interface ScreenEmbedding {
  id: number;
  parent_screen_id: number;
  child_screen_id: number;
  position: EmbeddingPosition;
  mode: EmbeddingMode;
  config: EmbeddingConfig;
  company_code: string;
  created_at: string;
  updated_at: string;
  created_by?: string;
}

// ============================================
// 2. 데이터 전달 타입
// ============================================

/**
 * 컴포넌트 타입
 */
export type ComponentType =
  | "table"           // 테이블
  | "input"           // 입력 필드
  | "select"          // 셀렉트 박스
  | "textarea"        // 텍스트 영역
  | "checkbox"        // 체크박스
  | "radio"           // 라디오 버튼
  | "date"            // 날짜 선택
  | "repeater"        // 리피터 (반복 그룹)
  | "form-group"      // 폼 그룹
  | "hidden";         // 히든 필드

/**
 * 데이터 수신 모드
 */
export type DataReceiveMode =
  | "append"    // 기존 데이터에 추가
  | "replace"   // 기존 데이터 덮어쓰기
  | "merge";    // 기존 데이터와 병합 (키 기준)

/**
 * 변환 함수
 */
export type TransformFunction =
  | "none"      // 변환 없음
  | "sum"       // 합계
  | "average"   // 평균
  | "count"     // 개수
  | "min"       // 최소값
  | "max"       // 최대값
  | "first"     // 첫 번째 값
  | "last"      // 마지막 값
  | "concat"    // 문자열 결합
  | "join"      // 배열 결합
  | "custom";   // 커스텀 함수

/**
 * 조건 연산자
 */
export type ConditionOperator =
  | "equals"
  | "notEquals"
  | "contains"
  | "notContains"
  | "greaterThan"
  | "lessThan"
  | "greaterThanOrEqual"
  | "lessThanOrEqual"
  | "in"
  | "notIn";

/**
 * 매핑 규칙
 */
export interface MappingRule {
  source_field: string;          // 소스 필드명
  target_field: string;          // 타겟 필드명
  transform?: TransformFunction; // 변환 함수
  transform_config?: any;        // 변환 함수 설정
  default_value?: any;           // 기본값
  required?: boolean;            // 필수 여부
}

/**
 * 조건
 */
export interface Condition {
  field: string;
  operator: ConditionOperator;
  value: any;
}

/**
 * 검증 설정
 */
export interface ValidationConfig {
  required?: boolean;
  min_rows?: number;
  max_rows?: number;
  custom_validation?: string;     // JavaScript 함수 문자열
}

/**
 * 데이터 수신자
 */
export interface DataReceiver {
  target_component_id: string;      // 타겟 컴포넌트 ID
  target_component_type: ComponentType;
  mode: DataReceiveMode;
  mapping_rules: MappingRule[];
  condition?: Condition;             // 조건부 전달
  validation?: ValidationConfig;
}

/**
 * 버튼 검증 설정
 */
export interface ButtonValidation {
  require_selection: boolean;
  min_selection?: number;
  max_selection?: number;
  confirm_message?: string;
  custom_validation?: string;
}

/**
 * 전달 버튼 설정
 */
export interface TransferButtonConfig {
  label: string;
  position: "left" | "right" | "center";
  icon?: string;
  variant?: "default" | "outline" | "ghost" | "destructive";
  size?: "sm" | "default" | "lg";
  validation?: ButtonValidation;
  clear_after_transfer?: boolean;
}

/**
 * 데이터 전달 설정
 */
export interface ScreenDataTransfer {
  id: number;
  source_screen_id: number;
  target_screen_id: number;
  source_component_id?: string;
  source_component_type?: string;
  data_receivers: DataReceiver[];
  button_config: TransferButtonConfig;
  company_code: string;
  created_at: string;
  updated_at: string;
  created_by?: string;
}

// ============================================
// 3. 분할 패널 타입
// ============================================

/**
 * 레이아웃 설정
 */
export interface LayoutConfig {
  split_ratio: number;              // 0-100 (좌측 비율)
  resizable: boolean;
  min_left_width?: number;          // 최소 좌측 너비 (px)
  min_right_width?: number;         // 최소 우측 너비 (px)
  orientation: "horizontal" | "vertical";
}

/**
 * 분할 패널 설정
 */
export interface ScreenSplitPanel {
  id: number;
  screen_id: number;
  left_embedding_id: number;
  right_embedding_id: number;
  data_transfer_id: number;
  layout_config: LayoutConfig;
  company_code: string;
  created_at: string;
  updated_at: string;

  // 조인된 데이터
  left_embedding?: ScreenEmbedding;
  right_embedding?: ScreenEmbedding;
  data_transfer?: ScreenDataTransfer;
}

// ============================================
// 4. 컴포넌트 인터페이스
// ============================================

/**
 * 데이터 수신 가능 컴포넌트 인터페이스
 */
export interface DataReceivable {
  // 컴포넌트 ID
  component_id: string;

  // 컴포넌트 타입
  component_type: ComponentType;

  // 데이터 수신
  receiveData(data: any[], mode: DataReceiveMode): Promise<void>;

  // 현재 데이터 가져오기
  getData(): any;

  // 데이터 초기화
  clearData(): void;

  // 검증
  validate(): boolean;

  // 이벤트 리스너
  onDataReceived?: (data: any[]) => void;
  onDataCleared?: () => void;
}

/**
 * 선택 가능 컴포넌트 인터페이스
 */
export interface Selectable {
  // 선택된 행/항목 가져오기
  getSelectedRows(): any[];

  // 선택 초기화
  clearSelection(): void;

  // 전체 선택
  selectAll(): void;

  // 선택 이벤트
  onSelectionChanged?: (selectedRows: any[]) => void;
}

/**
 * 임베드된 화면 핸들
 */
export interface EmbeddedScreenHandle {
  // 선택된 행 가져오기
  getSelectedRows(): any[];

  // 선택 초기화
  clearSelection(): void;

  // 데이터 수신
  receiveData(data: any[], receivers: DataReceiver[]): Promise<void>;

  // 현재 데이터 가져오기
  getData(): any;
}

// ============================================
// 5. API 응답 타입
// ============================================

/**
 * API 응답
 */
export interface ApiResponse<T> {
  success: boolean;
  data?: T;
  message?: string;
  error?: string;
}

/**
 * 화면 임베딩 생성 요청
 */
export interface CreateScreenEmbeddingRequest {
  parent_screen_id: number;
  child_screen_id: number;
  position: EmbeddingPosition;
  mode: EmbeddingMode;
  config?: EmbeddingConfig;
}

/**
 * 데이터 전달 설정 생성 요청
 */
export interface CreateScreenDataTransferRequest {
  source_screen_id: number;
  target_screen_id: number;
  source_component_id?: string;
  source_component_type?: string;
  data_receivers: DataReceiver[];
  button_config: TransferButtonConfig;
}

/**
 * 분할 패널 생성 요청
 */
export interface CreateScreenSplitPanelRequest {
  screen_id: number;
  left_embedding: CreateScreenEmbeddingRequest;
  right_embedding: CreateScreenEmbeddingRequest;
  data_transfer: CreateScreenDataTransferRequest;
  layout_config: LayoutConfig;
}

// ============================================
// 6. 유틸리티 타입
// ============================================

/**
 * 데이터 전달 결과
 */
export interface DataTransferResult {
  success: boolean;
  transferred_count: number;
  errors?: Array<{
    component_id: string;
    error: string;
  }>;
}

/**
 * 매핑 결과
 */
export interface MappingResult {
  success: boolean;
  mapped_data: any[];
  errors?: string[];
}

/**
 * 검증 결과
 */
export interface ValidationResult {
  valid: boolean;
  errors?: string[];
}