518 lines
16 KiB
TypeScript
518 lines
16 KiB
TypeScript
/**
|
|
* 🔥 성능 최적화: 버튼 데이터플로우 서비스
|
|
*
|
|
* 즉시 응답 + 백그라운드 실행 패턴으로
|
|
* 사용자에게 최고의 성능을 제공합니다.
|
|
*/
|
|
|
|
import {
|
|
ButtonActionType,
|
|
ButtonTypeConfig,
|
|
ButtonDataflowConfig,
|
|
DataflowExecutionResult,
|
|
DataflowCondition,
|
|
} from "@/types/screen";
|
|
import { dataflowConfigCache } from "./dataflowCache";
|
|
import { dataflowJobQueue, JobPriority } from "./dataflowJobQueue";
|
|
import { apiClient } from "@/lib/api/client";
|
|
|
|
export interface OptimizedExecutionResult {
|
|
jobId: string;
|
|
immediateResult?: any;
|
|
isBackground?: boolean;
|
|
timing?: "before" | "after" | "replace";
|
|
}
|
|
|
|
export interface QuickValidationResult {
|
|
success: boolean;
|
|
message?: string;
|
|
canExecuteImmediately: boolean;
|
|
}
|
|
|
|
/**
|
|
* 🔥 최적화된 버튼 데이터플로우 서비스
|
|
*
|
|
* 핵심 원칙:
|
|
* 1. 즉시 응답 우선 (0-100ms)
|
|
* 2. 복잡한 작업은 백그라운드
|
|
* 3. 캐시 활용으로 속도 향상
|
|
* 4. 스마트한 타이밍 제어
|
|
*/
|
|
export class OptimizedButtonDataflowService {
|
|
/**
|
|
* 🔥 메인 엔트리포인트: 즉시 응답 + 백그라운드 실행
|
|
*/
|
|
static async executeButtonWithDataflow(
|
|
buttonId: string,
|
|
actionType: ButtonActionType,
|
|
buttonConfig: ButtonTypeConfig,
|
|
contextData: Record<string, any>,
|
|
companyCode: string,
|
|
): Promise<OptimizedExecutionResult> {
|
|
const { enableDataflowControl, dataflowTiming } = buttonConfig;
|
|
|
|
// 🔥 제어관리가 비활성화된 경우: 즉시 실행
|
|
if (!enableDataflowControl) {
|
|
const result = await this.executeOriginalAction(actionType, buttonConfig, contextData);
|
|
return {
|
|
jobId: "immediate",
|
|
immediateResult: result,
|
|
timing: undefined,
|
|
};
|
|
}
|
|
|
|
// 🔥 타이밍별 즉시 응답 전략
|
|
switch (dataflowTiming) {
|
|
case "before":
|
|
return await this.executeBeforeTiming(buttonId, actionType, buttonConfig, contextData, companyCode);
|
|
|
|
case "after":
|
|
return await this.executeAfterTiming(buttonId, actionType, buttonConfig, contextData, companyCode);
|
|
|
|
case "replace":
|
|
return await this.executeReplaceTiming(buttonId, actionType, buttonConfig, contextData, companyCode);
|
|
|
|
default:
|
|
// 기본값은 after
|
|
return await this.executeAfterTiming(buttonId, actionType, buttonConfig, contextData, companyCode);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 🔥 After 타이밍: 즉시 기존 액션 + 백그라운드 제어관리
|
|
*
|
|
* 가장 일반적이고 안전한 패턴
|
|
* - 기존 액션 즉시 실행 (50-200ms)
|
|
* - 제어관리는 백그라운드에서 처리
|
|
*/
|
|
private static async executeAfterTiming(
|
|
buttonId: string,
|
|
actionType: ButtonActionType,
|
|
buttonConfig: ButtonTypeConfig,
|
|
contextData: Record<string, any>,
|
|
companyCode: string,
|
|
): Promise<OptimizedExecutionResult> {
|
|
// 🔥 Step 1: 기존 액션 즉시 실행
|
|
const immediateResult = await this.executeOriginalAction(actionType, buttonConfig, contextData);
|
|
|
|
// 🔥 Step 2: 제어관리는 백그라운드에서 실행
|
|
const enrichedContext = {
|
|
...contextData,
|
|
originalActionResult: immediateResult,
|
|
};
|
|
|
|
const jobId = dataflowJobQueue.enqueue(
|
|
buttonId,
|
|
actionType,
|
|
buttonConfig,
|
|
enrichedContext,
|
|
companyCode,
|
|
"normal", // 일반 우선순위
|
|
);
|
|
|
|
return {
|
|
jobId,
|
|
immediateResult,
|
|
isBackground: true,
|
|
timing: "after",
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 🔥 Before 타이밍: 빠른 검증 + 기존 액션
|
|
*
|
|
* 검증 목적으로 주로 사용
|
|
* - 간단한 검증: 즉시 처리
|
|
* - 복잡한 검증: 백그라운드 처리
|
|
*/
|
|
private static async executeBeforeTiming(
|
|
buttonId: string,
|
|
actionType: ButtonActionType,
|
|
buttonConfig: ButtonTypeConfig,
|
|
contextData: Record<string, any>,
|
|
companyCode: string,
|
|
): Promise<OptimizedExecutionResult> {
|
|
// 🔥 설정 캐시에서 빠르게 로드
|
|
const dataflowConfig = buttonConfig.dataflowConfig || (await dataflowConfigCache.getConfig(buttonId));
|
|
|
|
if (!dataflowConfig) {
|
|
// 설정이 없으면 기존 액션만 실행
|
|
const result = await this.executeOriginalAction(actionType, buttonConfig, contextData);
|
|
return { jobId: "immediate", immediateResult: result, timing: "before" };
|
|
}
|
|
|
|
// 간단한 검증인지 판단
|
|
const isSimpleValidation = await this.isSimpleValidationOnly(dataflowConfig);
|
|
|
|
if (isSimpleValidation) {
|
|
// 🔥 간단한 검증: 메모리에서 즉시 처리 (1-10ms)
|
|
const validationResult = await this.executeQuickValidation(dataflowConfig, contextData);
|
|
|
|
if (!validationResult.success) {
|
|
return {
|
|
jobId: "validation_failed",
|
|
immediateResult: {
|
|
success: false,
|
|
message: validationResult.message,
|
|
},
|
|
timing: "before",
|
|
};
|
|
}
|
|
|
|
// 검증 통과 시 기존 액션 실행
|
|
const actionResult = await this.executeOriginalAction(actionType, buttonConfig, contextData);
|
|
|
|
return {
|
|
jobId: "immediate",
|
|
immediateResult: actionResult,
|
|
timing: "before",
|
|
};
|
|
} else {
|
|
// 🔥 복잡한 검증: 사용자에게 알림 후 백그라운드 처리
|
|
const jobId = dataflowJobQueue.enqueue(
|
|
buttonId,
|
|
actionType,
|
|
buttonConfig,
|
|
contextData,
|
|
companyCode,
|
|
"high", // 높은 우선순위 (사용자 대기 중)
|
|
);
|
|
|
|
return {
|
|
jobId,
|
|
immediateResult: {
|
|
success: true,
|
|
message: "검증 중입니다. 잠시만 기다려주세요.",
|
|
processing: true,
|
|
},
|
|
isBackground: true,
|
|
timing: "before",
|
|
};
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 🔥 Replace 타이밍: 제어관리로 완전 대체
|
|
*
|
|
* 기존 액션 대신 제어관리만 실행
|
|
* - 간단한 제어: 즉시 실행
|
|
* - 복잡한 제어: 백그라운드 실행
|
|
*/
|
|
private static async executeReplaceTiming(
|
|
buttonId: string,
|
|
actionType: ButtonActionType,
|
|
buttonConfig: ButtonTypeConfig,
|
|
contextData: Record<string, any>,
|
|
companyCode: string,
|
|
): Promise<OptimizedExecutionResult> {
|
|
const dataflowConfig = buttonConfig.dataflowConfig || (await dataflowConfigCache.getConfig(buttonId));
|
|
|
|
if (!dataflowConfig) {
|
|
throw new Error("Replace 모드이지만 제어관리 설정이 없습니다.");
|
|
}
|
|
|
|
// 간단한 제어관리인지 판단
|
|
const isSimpleControl = this.isSimpleControl(dataflowConfig);
|
|
|
|
if (isSimpleControl) {
|
|
// 🔥 간단한 제어: 즉시 실행
|
|
try {
|
|
const result = await this.executeSimpleDataflow(dataflowConfig, contextData, companyCode);
|
|
|
|
return {
|
|
jobId: "immediate",
|
|
immediateResult: result,
|
|
timing: "replace",
|
|
};
|
|
} catch (error) {
|
|
return {
|
|
jobId: "immediate",
|
|
immediateResult: {
|
|
success: false,
|
|
message: "제어관리 실행 중 오류가 발생했습니다.",
|
|
error: error.message,
|
|
},
|
|
timing: "replace",
|
|
};
|
|
}
|
|
} else {
|
|
// 🔥 복잡한 제어: 백그라운드 실행
|
|
const jobId = dataflowJobQueue.enqueue(buttonId, actionType, buttonConfig, contextData, companyCode, "normal");
|
|
|
|
return {
|
|
jobId,
|
|
immediateResult: {
|
|
success: true,
|
|
message: "사용자 정의 작업을 처리 중입니다...",
|
|
processing: true,
|
|
},
|
|
isBackground: true,
|
|
timing: "replace",
|
|
};
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 🔥 간단한 조건인지 판단
|
|
*
|
|
* 메모리에서 즉시 처리 가능한 조건:
|
|
* - 조건 5개 이하
|
|
* - 단순 비교 연산자만 사용
|
|
* - 그룹핑 없음
|
|
*/
|
|
private static async isSimpleValidationOnly(config: ButtonDataflowConfig): Promise<boolean> {
|
|
if (config.controlMode !== "advanced") {
|
|
return true; // 간편 모드는 일단 간단하다고 가정
|
|
}
|
|
|
|
const conditions = config.directControl?.conditions || [];
|
|
|
|
return (
|
|
conditions.length <= 5 &&
|
|
conditions.every((c) => c.type === "condition" && ["=", "!=", ">", "<", ">=", "<="].includes(c.operator || ""))
|
|
);
|
|
}
|
|
|
|
/**
|
|
* 🔥 간단한 제어관리인지 판단
|
|
*/
|
|
private static isSimpleControl(config: ButtonDataflowConfig): boolean {
|
|
if (config.controlMode === "simple") {
|
|
return true; // 간편 모드는 대부분 간단
|
|
}
|
|
|
|
const actions = config.directControl?.actions || [];
|
|
const conditions = config.directControl?.conditions || [];
|
|
|
|
// 액션 3개 이하, 조건 5개 이하면 간단한 제어로 판단
|
|
return actions.length <= 3 && conditions.length <= 5;
|
|
}
|
|
|
|
/**
|
|
* 🔥 빠른 검증 (메모리에서 즉시 처리)
|
|
*/
|
|
private static async executeQuickValidation(
|
|
config: ButtonDataflowConfig,
|
|
data: Record<string, any>,
|
|
): Promise<QuickValidationResult> {
|
|
if (config.controlMode === "simple") {
|
|
// 간편 모드는 일단 통과 (실제 검증은 백그라운드에서)
|
|
return {
|
|
success: true,
|
|
canExecuteImmediately: true,
|
|
};
|
|
}
|
|
|
|
const conditions = config.directControl?.conditions || [];
|
|
|
|
for (const condition of conditions) {
|
|
if (condition.type === "condition") {
|
|
const fieldValue = data[condition.field!];
|
|
const isValid = this.evaluateSimpleCondition(fieldValue, condition.operator!, condition.value);
|
|
|
|
if (!isValid) {
|
|
return {
|
|
success: false,
|
|
message: `조건 불만족: ${condition.field} ${condition.operator} ${condition.value}`,
|
|
canExecuteImmediately: true,
|
|
};
|
|
}
|
|
}
|
|
}
|
|
|
|
return {
|
|
success: true,
|
|
canExecuteImmediately: true,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 🔥 단순 조건 평가 (메모리에서 즉시)
|
|
*/
|
|
private static evaluateSimpleCondition(fieldValue: any, operator: string, conditionValue: any): boolean {
|
|
switch (operator) {
|
|
case "=":
|
|
return fieldValue === conditionValue;
|
|
case "!=":
|
|
return fieldValue !== conditionValue;
|
|
case ">":
|
|
return Number(fieldValue) > Number(conditionValue);
|
|
case "<":
|
|
return Number(fieldValue) < Number(conditionValue);
|
|
case ">=":
|
|
return Number(fieldValue) >= Number(conditionValue);
|
|
case "<=":
|
|
return Number(fieldValue) <= Number(conditionValue);
|
|
case "LIKE":
|
|
return String(fieldValue).toLowerCase().includes(String(conditionValue).toLowerCase());
|
|
default:
|
|
return true;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 🔥 간단한 데이터플로우 즉시 실행
|
|
*/
|
|
private static async executeSimpleDataflow(
|
|
config: ButtonDataflowConfig,
|
|
contextData: Record<string, any>,
|
|
companyCode: string,
|
|
): Promise<DataflowExecutionResult> {
|
|
try {
|
|
const response = await apiClient.post("/api/button-dataflow/execute-simple", {
|
|
config,
|
|
contextData,
|
|
companyCode,
|
|
});
|
|
|
|
if (response.data.success) {
|
|
return response.data.data as DataflowExecutionResult;
|
|
} else {
|
|
throw new Error(response.data.message || "Simple dataflow execution failed");
|
|
}
|
|
} catch (error) {
|
|
console.error("Simple dataflow execution failed:", error);
|
|
throw error;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 🔥 기존 액션 실행 (최적화)
|
|
*/
|
|
private static async executeOriginalAction(
|
|
actionType: ButtonActionType,
|
|
buttonConfig: ButtonTypeConfig,
|
|
contextData: Record<string, any>,
|
|
): Promise<any> {
|
|
const startTime = performance.now();
|
|
|
|
try {
|
|
// 액션별 분기 처리
|
|
switch (actionType) {
|
|
case "save":
|
|
return await this.executeSaveAction(buttonConfig, contextData);
|
|
case "delete":
|
|
return await this.executeDeleteAction(buttonConfig, contextData);
|
|
case "search":
|
|
return await this.executeSearchAction(buttonConfig, contextData);
|
|
case "edit":
|
|
return await this.executeEditAction(buttonConfig, contextData);
|
|
case "add":
|
|
return await this.executeAddAction(buttonConfig, contextData);
|
|
case "reset":
|
|
return await this.executeResetAction(buttonConfig, contextData);
|
|
case "submit":
|
|
return await this.executeSubmitAction(buttonConfig, contextData);
|
|
case "close":
|
|
return await this.executeCloseAction(buttonConfig, contextData);
|
|
case "popup":
|
|
return await this.executePopupAction(buttonConfig, contextData);
|
|
case "navigate":
|
|
return await this.executeNavigateAction(buttonConfig, contextData);
|
|
default:
|
|
return {
|
|
success: true,
|
|
message: `${actionType} 액션이 실행되었습니다.`,
|
|
};
|
|
}
|
|
} catch (error) {
|
|
console.error(`Action execution failed: ${actionType}`, error);
|
|
return {
|
|
success: false,
|
|
message: `${actionType} 액션 실행 중 오류가 발생했습니다.`,
|
|
error: error.message,
|
|
};
|
|
} finally {
|
|
const executionTime = performance.now() - startTime;
|
|
if (executionTime > 200) {
|
|
console.warn(`🐌 Slow action: ${actionType} took ${executionTime.toFixed(2)}ms`);
|
|
} else {
|
|
console.log(`⚡ ${actionType} completed in ${executionTime.toFixed(2)}ms`);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 개별 액션 구현들
|
|
*/
|
|
private static async executeSaveAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
// TODO: 실제 저장 로직 구현
|
|
return { success: true, message: "저장되었습니다." };
|
|
}
|
|
|
|
private static async executeDeleteAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
// TODO: 실제 삭제 로직 구현
|
|
return { success: true, message: "삭제되었습니다." };
|
|
}
|
|
|
|
private static async executeSearchAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
// TODO: 실제 검색 로직 구현
|
|
return { success: true, message: "검색되었습니다.", data: [] };
|
|
}
|
|
|
|
private static async executeEditAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
return { success: true, message: "수정 모드로 전환되었습니다." };
|
|
}
|
|
|
|
private static async executeAddAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
return { success: true, message: "추가 모드로 전환되었습니다." };
|
|
}
|
|
|
|
private static async executeResetAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
return { success: true, message: "초기화되었습니다." };
|
|
}
|
|
|
|
private static async executeSubmitAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
return { success: true, message: "제출되었습니다." };
|
|
}
|
|
|
|
private static async executeCloseAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
return { success: true, message: "닫기 액션이 실행되었습니다." };
|
|
}
|
|
|
|
private static async executePopupAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
return {
|
|
success: true,
|
|
message: "팝업이 열렸습니다.",
|
|
popupUrl: config.navigateUrl,
|
|
popupScreenId: config.popupScreenId,
|
|
};
|
|
}
|
|
|
|
private static async executeNavigateAction(config: ButtonTypeConfig, data: Record<string, any>) {
|
|
return {
|
|
success: true,
|
|
message: "페이지 이동이 실행되었습니다.",
|
|
navigateUrl: config.navigateUrl,
|
|
navigateTarget: config.navigateTarget,
|
|
};
|
|
}
|
|
|
|
/**
|
|
* 🔥 작업 상태 조회
|
|
*/
|
|
static getJobStatus(jobId: string): { status: string; result?: any; progress?: number } {
|
|
try {
|
|
return dataflowJobQueue.getJobStatus(jobId);
|
|
} catch (error) {
|
|
return { status: "not_found" };
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 🔥 성능 메트릭 조회
|
|
*/
|
|
static getPerformanceMetrics(): {
|
|
cache: any;
|
|
queue: any;
|
|
} {
|
|
return {
|
|
cache: dataflowConfigCache.getMetrics(),
|
|
queue: dataflowJobQueue.getMetrics(),
|
|
};
|
|
}
|
|
}
|
|
|
|
// 🔥 전역 접근을 위한 싱글톤 서비스
|
|
export const optimizedButtonDataflowService = OptimizedButtonDataflowService;
|