feat: Improve entity join handling with enhanced column validation and support for complex keys

- Updated the entityJoinService to include type casting for source and reference columns, ensuring compatibility during joins.
- Implemented validation for reference columns in the TableManagementService, allowing automatic fallback to 'id' if the specified reference column does not exist.
- Enhanced logging for join configurations to provide better insights during the join setup process.
- Transitioned the SplitPanelLayoutComponent to utilize the entityJoinApi for handling single key to composite key transformations, improving data retrieval efficiency.
- Added support for displaying null or empty values as "-" in the SplitPanelLayout, enhancing user experience.

backend-node/src/services/entityJoinService.ts

@@ -457,17 +457,18 @@ export class EntityJoinService {
 
           // table_column_category_values는 특별한 조인 조건 필요 (회사별 필터링)
           if (config.referenceTable === "table_column_category_values") {
-            return `LEFT JOIN ${config.referenceTable} ${alias} ON main.${config.sourceColumn} = ${alias}.${config.referenceColumn} AND ${alias}.table_name = '${tableName}' AND ${alias}.column_name = '${config.sourceColumn}' AND ${alias}.company_code = main.company_code AND ${alias}.is_active = true`;
+            return `LEFT JOIN ${config.referenceTable} ${alias} ON main."${config.sourceColumn}"::TEXT = ${alias}."${config.referenceColumn}"::TEXT AND ${alias}.table_name = '${tableName}' AND ${alias}.column_name = '${config.sourceColumn}' AND ${alias}.company_code = main.company_code AND ${alias}.is_active = true`;
           }
 
           // user_info는 전역 테이블이므로 company_code 조건 없이 조인
           if (config.referenceTable === "user_info") {
-            return `LEFT JOIN ${config.referenceTable} ${alias} ON main.${config.sourceColumn} = ${alias}.${config.referenceColumn}`;
+            return `LEFT JOIN ${config.referenceTable} ${alias} ON main."${config.sourceColumn}"::TEXT = ${alias}."${config.referenceColumn}"::TEXT`;
           }
 
           // 일반 테이블: company_code가 있으면 같은 회사 데이터만 조인 (멀티테넌시)
           // supplier_mng, customer_mng, item_info 등 회사별 데이터 테이블
-          return `LEFT JOIN ${config.referenceTable} ${alias} ON main.${config.sourceColumn} = ${alias}.${config.referenceColumn} AND ${alias}.company_code = main.company_code`;
+          // ::TEXT 캐스팅으로 varchar/integer 등 타입 불일치 방지
+          return `LEFT JOIN ${config.referenceTable} ${alias} ON main."${config.sourceColumn}"::TEXT = ${alias}."${config.referenceColumn}"::TEXT AND ${alias}.company_code = main.company_code`;
         })
         .join("\n");
 
@@ -580,6 +581,7 @@ export class EntityJoinService {
       logger.info("🔍 조인 설정 검증 상세:", {
         sourceColumn: config.sourceColumn,
         referenceTable: config.referenceTable,
+        referenceColumn: config.referenceColumn,
         displayColumns: config.displayColumns,
         displayColumn: config.displayColumn,
         aliasColumn: config.aliasColumn,
@@ -598,7 +600,45 @@ export class EntityJoinService {
         return false;
       }
 
-      // 참조 컬럼 존재 확인 (displayColumns[0] 사용)
+      // 참조 컬럼(JOIN 키) 존재 확인 - 참조 테이블에 reference_column이 실제로 있는지 검증
+      if (config.referenceColumn) {
+        const refColExists = await query<{ exists: number }>(
+          `SELECT 1 as exists FROM information_schema.columns 
+           WHERE table_name = $1 
+           AND column_name = $2
+           LIMIT 1`,
+          [config.referenceTable, config.referenceColumn]
+        );
+
+        if (refColExists.length === 0) {
+          // reference_column이 없으면 'id' 컬럼으로 자동 대체 시도
+          const idColExists = await query<{ exists: number }>(
+            `SELECT 1 as exists FROM information_schema.columns 
+             WHERE table_name = $1 
+             AND column_name = 'id'
+             LIMIT 1`,
+            [config.referenceTable]
+          );
+
+          if (idColExists.length > 0) {
+            logger.warn(
+              `⚠️ 참조 컬럼 ${config.referenceTable}.${config.referenceColumn}이 존재하지 않음 → 'id'로 자동 대체`
+            );
+            config.referenceColumn = "id";
+          } else {
+            logger.warn(
+              `❌ 참조 컬럼 ${config.referenceTable}.${config.referenceColumn}이 존재하지 않고 'id' 컬럼도 없음 → 스킵`
+            );
+            return false;
+          }
+        } else {
+          logger.info(
+            `✅ 참조 컬럼 확인 완료: ${config.referenceTable}.${config.referenceColumn}`
+          );
+        }
+      }
+
+      // 표시 컬럼 존재 확인 (displayColumns[0] 사용)
       const displayColumn = config.displayColumns?.[0] || config.displayColumn;
       logger.info(
         `🔍 표시 컬럼 확인: ${displayColumn} (from displayColumns: ${config.displayColumns}, displayColumn: ${config.displayColumn})`
@@ -686,10 +726,10 @@ export class EntityJoinService {
           // table_column_category_values는 특별한 조인 조건 필요 (회사별 필터링만)
           if (config.referenceTable === "table_column_category_values") {
             // 멀티테넌시: 회사 데이터만 사용 (공통 데이터 제외)
-            return `LEFT JOIN ${config.referenceTable} ${alias} ON main.${config.sourceColumn} = ${alias}.${config.referenceColumn} AND ${alias}.table_name = '${tableName}' AND ${alias}.column_name = '${config.sourceColumn}' AND ${alias}.company_code = main.company_code AND ${alias}.is_active = true`;
+            return `LEFT JOIN ${config.referenceTable} ${alias} ON main."${config.sourceColumn}"::TEXT = ${alias}."${config.referenceColumn}"::TEXT AND ${alias}.table_name = '${tableName}' AND ${alias}.column_name = '${config.sourceColumn}' AND ${alias}.company_code = main.company_code AND ${alias}.is_active = true`;
           }
 
-          return `LEFT JOIN ${config.referenceTable} ${alias} ON main.${config.sourceColumn} = ${alias}.${config.referenceColumn}`;
+          return `LEFT JOIN ${config.referenceTable} ${alias} ON main."${config.sourceColumn}"::TEXT = ${alias}."${config.referenceColumn}"::TEXT`;
         })
         .join("\n");