feat: Enhance entity join functionality with company code support

- Updated the EntityJoinController to log the company code during entity join configuration retrieval.
- Modified the entityJoinService to accept company code as a parameter, allowing for company-specific entity join detection.
- Enhanced the TableManagementService to pass the company code when detecting entity joins and retrieving reference table columns.
- Implemented a helper function in the SplitPanelLayoutComponent to extract additional join columns based on the entity join configuration.
- Improved the SplitPanelLayoutConfigPanel to display entity join columns dynamically, enhancing user experience and functionality.

frontend/lib/registry/components/v2-split-panel-layout/SplitPanelLayoutComponent.tsx

@@ -957,6 +957,67 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
     [formatDateValue, formatNumberValue],
   );
 
+  // 🆕 패널 config의 columns에서 additionalJoinColumns 추출하는 헬퍼
+  const extractAdditionalJoinColumns = useCallback((columns: any[] | undefined, tableName: string) => {
+    if (!columns || columns.length === 0) return undefined;
+
+    const joinColumns: Array<{
+      sourceTable: string;
+      sourceColumn: string;
+      referenceTable: string;
+      joinAlias: string;
+    }> = [];
+
+    columns.forEach((col: any) => {
+      // 방법 1: isEntityJoin 플래그가 있는 경우 (설정 패널에서 Entity 조인 컬럼으로 추가한 경우)
+      if (col.isEntityJoin && col.joinInfo) {
+        const existing = joinColumns.find(
+          (j) => j.referenceTable === col.joinInfo.referenceTable && j.joinAlias === col.joinInfo.joinAlias
+        );
+        if (!existing) {
+          joinColumns.push({
+            sourceTable: col.joinInfo.sourceTable || tableName,
+            sourceColumn: col.joinInfo.sourceColumn,
+            referenceTable: col.joinInfo.referenceTable,
+            joinAlias: col.joinInfo.joinAlias,
+          });
+        }
+        return;
+      }
+
+      // 방법 2: "테이블명.컬럼명" 형식 (기존 좌측 패널 방식)
+      const colName = typeof col === "string" ? col : col.name || col.columnName;
+      if (colName && colName.includes(".")) {
+        const [refTable, refColumn] = colName.split(".");
+        const inferredSourceColumn = refTable.replace("_info", "_code").replace("_mng", "_id");
+        const existing = joinColumns.find(
+          (j) => j.referenceTable === refTable && j.sourceColumn === inferredSourceColumn
+        );
+        if (!existing) {
+          joinColumns.push({
+            sourceTable: tableName,
+            sourceColumn: inferredSourceColumn,
+            referenceTable: refTable,
+            joinAlias: `${inferredSourceColumn}_${refColumn}`,
+          });
+        } else {
+          // 이미 추가된 테이블이면 별칭만 추가
+          const newAlias = `${inferredSourceColumn}_${refColumn}`;
+          if (!joinColumns.find((j) => j.joinAlias === newAlias)) {
+            joinColumns.push({
+              sourceTable: tableName,
+              sourceColumn: inferredSourceColumn,
+              referenceTable: refTable,
+              joinAlias: newAlias,
+            });
+          }
+        }
+      }
+    });
+
+    return joinColumns.length > 0 ? joinColumns : undefined;
+  }, []);
+
   // 좌측 데이터 로드
   const loadLeftData = useCallback(async () => {
     const leftTableName = componentConfig.leftPanel?.tableName;
@@ -967,74 +1028,22 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
       // 🎯 필터 조건을 API에 전달 (entityJoinApi 사용)
       const filters = Object.keys(searchValues).length > 0 ? searchValues : undefined;
 
-      // 🆕 "테이블명.컬럼명" 형식의 조인 컬럼들을 additionalJoinColumns로 변환
-      const configuredColumns = componentConfig.leftPanel?.columns || [];
-      const additionalJoinColumns: Array<{
-        sourceTable: string;
-        sourceColumn: string;
-        referenceTable: string;
-        joinAlias: string;
-      }> = [];
+      // 🆕 좌측 패널 config의 Entity 조인 컬럼 추출 (헬퍼 함수 사용)
+      const leftJoinColumns = extractAdditionalJoinColumns(
+        componentConfig.leftPanel?.columns,
+        leftTableName,
+      );
 
-      // 소스 컬럼 매핑 (item_info → item_code, warehouse_info → warehouse_id 등)
-      const sourceColumnMap: Record<string, string> = {};
-
-      configuredColumns.forEach((col: any) => {
-        const colName = typeof col === "string" ? col : col.name || col.columnName;
-        if (colName && colName.includes(".")) {
-          const [refTable, refColumn] = colName.split(".");
-          // 소스 컬럼 추론 (item_info → item_code 또는 warehouse_info → warehouse_id)
-          // 기본: _info → _code, 백업: _info → _id
-          const primarySourceColumn = refTable.replace("_info", "_code").replace("_mng", "_id");
-          const secondarySourceColumn = refTable.replace("_info", "_id").replace("_mng", "_id");
-          // 실제 존재하는 소스 컬럼은 백엔드에서 결정 (프론트엔드는 두 패턴 모두 전달)
-          const inferredSourceColumn = primarySourceColumn;
-
-          // 이미 추가된 조인인지 확인 (동일 테이블, 동일 소스컬럼)
-          const existingJoin = additionalJoinColumns.find(
-            (j) => j.referenceTable === refTable && j.sourceColumn === inferredSourceColumn,
-          );
-
-          if (!existingJoin) {
-            // 새로운 조인 추가 (첫 번째 컬럼)
-            additionalJoinColumns.push({
-              sourceTable: leftTableName,
-              sourceColumn: inferredSourceColumn,
-              referenceTable: refTable,
-              joinAlias: `${inferredSourceColumn}_${refColumn}`,
-            });
-            sourceColumnMap[refTable] = inferredSourceColumn;
-          }
-
-          // 추가 컬럼도 별도로 요청 (item_code_standard, item_code_unit 등)
-          // 단, 첫 번째 컬럼과 다른 경우만
-          const existingAliases = additionalJoinColumns
-            .filter((j) => j.referenceTable === refTable)
-            .map((j) => j.joinAlias);
-          const newAlias = `${sourceColumnMap[refTable] || inferredSourceColumn}_${refColumn}`;
-
-          if (!existingAliases.includes(newAlias)) {
-            additionalJoinColumns.push({
-              sourceTable: leftTableName,
-              sourceColumn: sourceColumnMap[refTable] || inferredSourceColumn,
-              referenceTable: refTable,
-              joinAlias: newAlias,
-            });
-          }
-        }
-      });
-
-      console.log("🔗 [분할패널] additionalJoinColumns:", additionalJoinColumns);
-      console.log("🔗 [분할패널] configuredColumns:", configuredColumns);
+      console.log("🔗 [분할패널] 좌측 additionalJoinColumns:", leftJoinColumns);
 
       const result = await entityJoinApi.getTableDataWithJoins(leftTableName, {
         page: 1,
         size: 100,
-        search: filters, // 필터 조건 전달
-        enableEntityJoin: true, // 엔티티 조인 활성화
-        dataFilter: componentConfig.leftPanel?.dataFilter, // 🆕 데이터 필터 전달
-        additionalJoinColumns: additionalJoinColumns.length > 0 ? additionalJoinColumns : undefined, // 🆕 추가 조인 컬럼
-        companyCodeOverride: companyCode, // 🆕 프리뷰용 회사 코드 오버라이드
+        search: filters,
+        enableEntityJoin: true,
+        dataFilter: componentConfig.leftPanel?.dataFilter,
+        additionalJoinColumns: leftJoinColumns,
+        companyCodeOverride: companyCode,
       });
 
       // 🔍 디버깅: API 응답 데이터의 키 확인
@@ -1093,11 +1102,16 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
 
           // 🆕 엔티티 조인 API 사용
           const { entityJoinApi } = await import("@/lib/api/entityJoin");
+          const rightDetailJoinColumns = extractAdditionalJoinColumns(
+            componentConfig.rightPanel?.columns,
+            rightTableName,
+          );
           const result = await entityJoinApi.getTableDataWithJoins(rightTableName, {
             search: { id: primaryKey },
-            enableEntityJoin: true, // 엔티티 조인 활성화
+            enableEntityJoin: true,
             size: 1,
-            companyCodeOverride: companyCode, // 🆕 프리뷰용 회사 코드 오버라이드
+            companyCodeOverride: companyCode,
+            additionalJoinColumns: rightDetailJoinColumns, // 🆕 Entity 조인 컬럼 전달
           });
 
           const detail = result.items && result.items.length > 0 ? result.items[0] : null;
@@ -1141,6 +1155,12 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
             const { entityJoinApi } = await import("@/lib/api/entityJoin");
             const allResults: any[] = [];
 
+            // 🆕 우측 패널 Entity 조인 컬럼 추출 (그룹 합산용)
+            const rightJoinColumnsForGroup = extractAdditionalJoinColumns(
+              componentConfig.rightPanel?.columns,
+              rightTableName,
+            );
+
             // 각 원본 항목에 대해 조회
             for (const originalItem of leftItem._originalItems) {
               const searchConditions: Record<string, any> = {};
@@ -1155,7 +1175,8 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
                   search: searchConditions,
                   enableEntityJoin: true,
                   size: 1000,
-                  companyCodeOverride: companyCode, // 🆕 프리뷰용 회사 코드 오버라이드
+                  companyCodeOverride: companyCode,
+                  additionalJoinColumns: rightJoinColumnsForGroup, // 🆕 Entity 조인 컬럼 전달
                 });
                 if (result.data) {
                   allResults.push(...result.data);
@@ -1185,12 +1206,22 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
 
             console.log("🔗 [분할패널] 복합키 조건:", searchConditions);
 
+            // 🆕 우측 패널 config의 Entity 조인 컬럼 추출
+            const rightJoinColumns = extractAdditionalJoinColumns(
+              componentConfig.rightPanel?.columns,
+              rightTableName,
+            );
+            if (rightJoinColumns) {
+              console.log("🔗 [분할패널] 우측 패널 additionalJoinColumns:", rightJoinColumns);
+            }
+
             // 엔티티 조인 API로 데이터 조회
             const result = await entityJoinApi.getTableDataWithJoins(rightTableName, {
               search: searchConditions,
               enableEntityJoin: true,
               size: 1000,
-              companyCodeOverride: companyCode, // 🆕 프리뷰용 회사 코드 오버라이드
+              companyCodeOverride: companyCode,
+              additionalJoinColumns: rightJoinColumns, // 🆕 Entity 조인 컬럼 전달
             });
 
             console.log("🔗 [분할패널] 복합키 조회 결과:", result);
@@ -1275,6 +1306,12 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
         const leftColumn = tabConfig.relation?.leftColumn || keys?.[0]?.leftColumn;
         const rightColumn = tabConfig.relation?.foreignKey || keys?.[0]?.rightColumn;
 
+        // 🆕 탭 config의 Entity 조인 컬럼 추출
+        const tabJoinColumns = extractAdditionalJoinColumns(tabConfig.columns, tabTableName);
+        if (tabJoinColumns) {
+          console.log(`🔗 [분할패널] 탭 ${tabIndex} additionalJoinColumns:`, tabJoinColumns);
+        }
+
         let resultData: any[] = [];
 
         if (leftColumn && rightColumn) {
@@ -1303,12 +1340,14 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
             search: searchConditions,
             enableEntityJoin: true,
             size: 1000,
+            additionalJoinColumns: tabJoinColumns, // 🆕 Entity 조인 컬럼 전달
           });
           resultData = result.data || [];
         } else {
           const result = await entityJoinApi.getTableDataWithJoins(tabTableName, {
             enableEntityJoin: true,
             size: 1000,
+            additionalJoinColumns: tabJoinColumns, // 🆕 Entity 조인 컬럼 전달
           });
           resultData = result.data || [];
         }