From e19a28fa52511448d7095638038c03688f8589e0 Mon Sep 17 00:00:00 2001
From: leeheejin <imleesinok@gmail.com>
Date: Thu, 22 Jan 2026 09:59:20 +0900
Subject: [PATCH 1/2] =?UTF-8?q?=EC=97=91=EC=85=80=20=EC=97=85=EB=A1=9C?=
 =?UTF-8?q?=EB=93=9C=EC=97=90=EC=84=9C=20=EA=B3=B5=EA=B8=89=EC=97=85?=
 =?UTF-8?q?=EC=B2=B4=20=EB=AA=85=EC=9D=B4=20=EC=95=88=EB=93=A4=EC=96=B4?=
 =?UTF-8?q?=EA=B0=80=EB=8D=98=20=EC=98=A4=EB=A5=98=20=EC=88=98=EC=A0=95?=
 =?UTF-8?q?=EC=99=84=EB=A3=8C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../components/common/ExcelUploadModal.tsx    | 39 ++++++++++++++++---
 1 file changed, 33 insertions(+), 6 deletions(-)

diff --git a/frontend/components/common/ExcelUploadModal.tsx b/frontend/components/common/ExcelUploadModal.tsx
index 64fe38b8..cddbb73f 100644
--- a/frontend/components/common/ExcelUploadModal.tsx
+++ b/frontend/components/common/ExcelUploadModal.tsx
@@ -928,12 +928,39 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
                         {field.inputType === "entity" ? (
                           <Select
                             value={masterFieldValues[field.columnName]?.toString() || ""}
-                            onValueChange={(value) =>
-                              setMasterFieldValues((prev) => ({
-                                ...prev,
-                                [field.columnName]: value,
-                              }))
-                            }
+                            onValueChange={(value) => {
+                              // 선택한 item 찾기
+                              const selectedItem = entitySearchData[field.columnName]?.find(
+                                (item: any) => item[field.referenceColumn || "id"]?.toString() === value
+                              );
+                              
+                              // displayColumn에서 name 값도 가져오기
+                              const displayColName = 
+                                field.displayColumn || 
+                                entityDisplayColumns[field.columnName] || 
+                                field.referenceColumn || 
+                                "id";
+                              const displayValue = selectedItem?.[displayColName];
+                              
+                              // code와 name 컬럼명 추출 (예: supplier_code → supplier_name)
+                              const codeColName = field.columnName; // supplier_code
+                              const nameColName = codeColName.replace(/_code$/, "_name"); // supplier_name
+                              
+                              setMasterFieldValues((prev) => {
+                                const newValues = {
+                                  ...prev,
+                                  [codeColName]: value,
+                                };
+                                
+                                // _code로 끝나는 컬럼이면 _name도 함께 저장
+                                if (codeColName.endsWith("_code") && displayValue) {
+                                  newValues[nameColName] = displayValue;
+                                  console.log(`🔗 엔티티 연동: ${codeColName}=${value}, ${nameColName}=${displayValue}`);
+                                }
+                                
+                                return newValues;
+                              });
+                            }}
                           >
                             <SelectTrigger className="h-9 text-xs">
                               <SelectValue placeholder={`${field.columnLabel} 선택`} />

From 7a71b7e98a47e5090396338a2c74477fd05c08a2 Mon Sep 17 00:00:00 2001
From: kjs <kjs@wace.me>
Date: Thu, 22 Jan 2026 11:57:12 +0900
Subject: [PATCH 2/2] =?UTF-8?q?feat:=20=EC=97=91=EC=85=80=20=EC=97=85?=
 =?UTF-8?q?=EB=A1=9C=EB=93=9C=20=EB=AA=A8=EB=8B=AC=EC=97=90=20=EC=A4=91?=
 =?UTF-8?q?=EB=B3=B5=20=EC=B2=B4=ED=81=AC=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94?=
 =?UTF-8?q?=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 엑셀 컬럼과 시스템 컬럼 간의 중복 체크 설정을 위한 체크박스 추가
- 중복 체크 시 처리 방법을 선택할 수 있는 옵션(건너뛰기/덮어쓰기) 추가
- 중복 체크 설정된 컬럼 수 및 관련 안내 메시지 표시
- 중복 체크를 위한 기존 데이터 조회 로직 구현
- 업로드 후 성공/실패/건너뛰기 건수에 대한 상세 결과 메시지 표시
---
 .../components/common/ExcelUploadModal.tsx    | 249 +++++++++++++++++-
 1 file changed, 238 insertions(+), 11 deletions(-)

diff --git a/frontend/components/common/ExcelUploadModal.tsx b/frontend/components/common/ExcelUploadModal.tsx
index cddbb73f..f6429a09 100644
--- a/frontend/components/common/ExcelUploadModal.tsx
+++ b/frontend/components/common/ExcelUploadModal.tsx
@@ -26,7 +26,9 @@ import {
   CheckCircle2,
   ArrowRight,
   Zap,
+  Copy,
 } from "lucide-react";
+import { Checkbox } from "@/components/ui/checkbox";
 import { importFromExcel, getExcelSheetNames } from "@/lib/utils/excelExport";
 import { DynamicFormApi } from "@/lib/api/dynamicForm";
 import { getTableSchema, TableColumn } from "@/lib/api/tableSchema";
@@ -94,6 +96,8 @@ export interface ExcelUploadModalProps {
 interface ColumnMapping {
   excelColumn: string;
   systemColumn: string | null;
+  // 중복 체크 설정 (해당 컬럼을 중복 체크 키로 사용할지)
+  checkDuplicate?: boolean;
 }
 
 export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
@@ -131,6 +135,9 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
   const [excelColumns, setExcelColumns] = useState<string[]>([]);
   const [systemColumns, setSystemColumns] = useState<TableColumn[]>([]);
   const [columnMappings, setColumnMappings] = useState<ColumnMapping[]>([]);
+  
+  // 중복 처리 방법 (전역 설정)
+  const [duplicateAction, setDuplicateAction] = useState<"overwrite" | "skip">("skip");
 
   // 3단계: 확인
   const [isUploading, setIsUploading] = useState(false);
@@ -544,6 +551,20 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
     );
   };
 
+  // 중복 체크 설정 변경
+  const handleDuplicateCheckChange = (excelColumn: string, checkDuplicate: boolean) => {
+    setColumnMappings((prev) =>
+      prev.map((mapping) =>
+        mapping.excelColumn === excelColumn
+          ? { ...mapping, checkDuplicate }
+          : mapping
+      )
+    );
+  };
+
+  // 중복 체크 설정된 컬럼 수
+  const duplicateCheckCount = columnMappings.filter((m) => m.checkDuplicate && m.systemColumn).length;
+
   // 다음 단계
   const handleNext = () => {
     if (currentStep === 1 && !file) {
@@ -707,16 +728,96 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
         // 기존 단일 테이블 업로드 로직
         let successCount = 0;
         let failCount = 0;
+        let skipCount = 0;
+        let overwriteCount = 0;
 
         // 단일 테이블 채번 설정 확인
         const hasNumbering = numberingRuleId && numberingTargetColumn;
 
+        // 중복 체크 설정 확인
+        const duplicateCheckMappings = columnMappings.filter(
+          (m) => m.checkDuplicate && m.systemColumn
+        );
+        const hasDuplicateCheck = duplicateCheckMappings.length > 0;
+
+        // 중복 체크를 위한 기존 데이터 조회 (중복 체크가 설정된 경우에만)
+        let existingDataMap: Map<string, any> = new Map();
+        if (hasDuplicateCheck) {
+          try {
+            // 중복 체크할 컬럼들의 값 조회
+            const checkColumns = duplicateCheckMappings.map((m) => {
+              let colName = m.systemColumn!;
+              if (isMasterDetail && colName.includes(".")) {
+                colName = colName.split(".")[1];
+              }
+              return colName;
+            });
+
+            // DynamicFormApi.getTableData 사용
+            const existingResponse = await DynamicFormApi.getTableData(tableName, {
+              page: 1,
+              pageSize: 10000,
+            });
+
+            console.log("📊 중복 체크용 기존 데이터 조회 결과:", existingResponse);
+
+            // getTableData는 { success, data: [...] } 또는 { success, data: { rows: [...] } } 형식
+            const rows = existingResponse.data?.rows || existingResponse.data;
+            if (existingResponse.success && rows && Array.isArray(rows)) {
+              // 중복 체크 컬럼 값을 키로 하는 맵 생성
+              rows.forEach((row: any) => {
+                const keyParts = checkColumns.map((col) => String(row[col] || "").trim());
+                const key = keyParts.join("|||");
+                existingDataMap.set(key, row);
+              });
+              console.log(`📊 중복 체크용 기존 데이터 로드: ${existingDataMap.size}건`);
+            }
+          } catch (error) {
+            console.error("중복 체크 데이터 조회 오류:", error);
+          }
+        }
+
         for (const row of filteredData) {
           try {
             let dataToSave = { ...row };
+            let shouldSkip = false;
+            let shouldUpdate = false;
+            let existingRow: any = null;
 
-            // 채번 적용: 각 행마다 채번 API 호출
-            if (hasNumbering && uploadMode === "insert") {
+            // 중복 체크
+            if (hasDuplicateCheck) {
+              const checkColumns = duplicateCheckMappings.map((m) => {
+                let colName = m.systemColumn!;
+                if (isMasterDetail && colName.includes(".")) {
+                  colName = colName.split(".")[1];
+                }
+                return colName;
+              });
+              
+              const keyParts = checkColumns.map((col) => String(dataToSave[col] || "").trim());
+              const key = keyParts.join("|||");
+              
+              if (existingDataMap.has(key)) {
+                existingRow = existingDataMap.get(key);
+                // 중복 발견 - 전역 설정에 따라 처리
+                if (duplicateAction === "skip") {
+                  shouldSkip = true;
+                  skipCount++;
+                  console.log(`⏭️ 중복으로 건너뛰기: ${key}`);
+                } else {
+                  shouldUpdate = true;
+                  console.log(`🔄 중복으로 덮어쓰기: ${key}`);
+                }
+              }
+            }
+
+            // 건너뛰기 처리
+            if (shouldSkip) {
+              continue;
+            }
+
+            // 채번 적용: 각 행마다 채번 API 호출 (신규 등록 시에만)
+            if (hasNumbering && uploadMode === "insert" && !shouldUpdate) {
               try {
                 const { apiClient } = await import("@/lib/api/client");
                 const numberingResponse = await apiClient.post(`/numbering-rules/${numberingRuleId}/allocate`);
@@ -729,7 +830,22 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
               }
             }
 
-            if (uploadMode === "insert") {
+            if (shouldUpdate && existingRow) {
+              // 덮어쓰기: 기존 데이터 업데이트
+              const formData = { 
+                screenId: 0, 
+                tableName, 
+                data: dataToSave,
+              };
+              const result = await DynamicFormApi.updateFormData(existingRow.id, formData);
+              if (result.success) {
+                overwriteCount++;
+                successCount++;
+              } else {
+                failCount++;
+              }
+            } else if (uploadMode === "insert") {
+              // 신규 등록
               const formData = { screenId: 0, tableName, data: dataToSave };
               const result = await DynamicFormApi.saveFormData(formData);
               if (result.success) {
@@ -743,7 +859,7 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
           }
         }
 
-        // 🆕 업로드 후 제어 실행
+        // 업로드 후 제어 실행
         if (afterUploadFlows && afterUploadFlows.length > 0 && successCount > 0) {
           console.log("🔄 업로드 후 제어 실행:", afterUploadFlows);
           try {
@@ -761,10 +877,24 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
           }
         }
 
-        if (successCount > 0) {
-          toast.success(
-            `${successCount}개 행이 업로드되었습니다.${failCount > 0 ? ` (실패: ${failCount}개)` : ""}`
-          );
+        if (successCount > 0 || skipCount > 0) {
+          // 상세 결과 메시지 생성
+          let message = "";
+          if (successCount > 0) {
+            message += `${successCount}개 행 업로드`;
+            if (overwriteCount > 0) {
+              message += ` (덮어쓰기 ${overwriteCount}건)`;
+            }
+          }
+          if (skipCount > 0) {
+            message += message ? `, ` : "";
+            message += `중복 건너뛰기 ${skipCount}개`;
+          }
+          if (failCount > 0) {
+            message += ` (실패: ${failCount}개)`;
+          }
+          
+          toast.success(message);
 
           // 매핑 템플릿 저장
           await saveMappingTemplateInternal();
@@ -825,6 +955,7 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
       setExcelColumns([]);
       setSystemColumns([]);
       setColumnMappings([]);
+      setDuplicateAction("skip");
       // 🆕 마스터-디테일 모드 초기화
       setMasterFieldValues({});
     }
@@ -1168,17 +1299,18 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
 
               {/* 매핑 리스트 */}
               <div className="space-y-2">
-                <div className="grid grid-cols-[1fr_auto_1fr] gap-2 text-[10px] font-medium text-muted-foreground sm:text-xs">
+                <div className="grid grid-cols-[1fr_auto_1fr_80px] gap-2 text-[10px] font-medium text-muted-foreground sm:text-xs">
                   <div>엑셀 컬럼</div>
                   <div></div>
                   <div>시스템 컬럼</div>
+                  <div className="text-center">중복 키</div>
                 </div>
 
-                <div className="max-h-[350px] space-y-2 overflow-y-auto">
+                <div className="max-h-[300px] space-y-2 overflow-y-auto">
                   {columnMappings.map((mapping, index) => (
                     <div
                       key={index}
-                      className="grid grid-cols-[1fr_auto_1fr] items-center gap-2"
+                      className="grid grid-cols-[1fr_auto_1fr_80px] items-center gap-2"
                     >
                       <div className="rounded-md border border-border bg-muted px-3 py-2 text-xs font-medium sm:text-sm">
                         {mapping.excelColumn}
@@ -1220,11 +1352,78 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
                           ))}
                         </SelectContent>
                       </Select>
+                      {/* 중복 체크 체크박스 */}
+                      <div className="flex justify-center">
+                        {mapping.systemColumn ? (
+                          <Checkbox
+                            checked={mapping.checkDuplicate || false}
+                            onCheckedChange={(checked) =>
+                              handleDuplicateCheckChange(mapping.excelColumn, checked as boolean)
+                            }
+                            className="h-4 w-4"
+                          />
+                        ) : (
+                          <span className="text-[10px] text-muted-foreground">-</span>
+                        )}
+                      </div>
                     </div>
                   ))}
                 </div>
               </div>
 
+              {/* 중복 체크 안내 */}
+              {duplicateCheckCount > 0 ? (
+                <div className="rounded-md border border-blue-200 bg-blue-50 p-3">
+                  <div className="flex items-start justify-between gap-4">
+                    <div className="flex items-start gap-2">
+                      <Copy className="mt-0.5 h-4 w-4 text-blue-600" />
+                      <div className="text-[10px] text-blue-700 sm:text-xs">
+                        <p className="font-medium">
+                          중복 키: {columnMappings
+                            .filter((m) => m.checkDuplicate && m.systemColumn)
+                            .map((m) => {
+                              const col = systemColumns.find((c) => c.name === m.systemColumn);
+                              return col?.label || m.systemColumn;
+                            })
+                            .join(" + ")}
+                        </p>
+                        <p className="mt-1">
+                          위 컬럼 값이 모두 일치하는 기존 데이터가 있으면 중복으로 처리합니다.
+                        </p>
+                      </div>
+                    </div>
+                    <div className="flex items-center gap-2 shrink-0">
+                      <span className="text-[10px] text-blue-700 sm:text-xs">중복 시:</span>
+                      <Select
+                        value={duplicateAction}
+                        onValueChange={(value) => setDuplicateAction(value as "overwrite" | "skip")}
+                      >
+                        <SelectTrigger className="h-7 w-[100px] text-[10px] sm:text-xs border-blue-300 bg-white">
+                          <SelectValue />
+                        </SelectTrigger>
+                        <SelectContent>
+                          <SelectItem value="skip" className="text-xs">건너뛰기</SelectItem>
+                          <SelectItem value="overwrite" className="text-xs">덮어쓰기</SelectItem>
+                        </SelectContent>
+                      </Select>
+                    </div>
+                  </div>
+                </div>
+              ) : (
+                <div className="rounded-md border border-muted bg-muted/30 p-3">
+                  <div className="flex items-start gap-2">
+                    <Copy className="mt-0.5 h-4 w-4 text-muted-foreground" />
+                    <div className="text-[10px] text-muted-foreground sm:text-xs">
+                      <p className="font-medium">중복 체크 (선택사항)</p>
+                      <p className="mt-1">
+                        "중복 키" 체크박스를 선택하면 해당 컬럼 값으로 기존 데이터와 비교합니다.
+                        여러 컬럼을 선택하면 복합 키로 중복을 판단합니다.
+                      </p>
+                    </div>
+                  </div>
+                </div>
+              )}
+
               {/* 매핑 자동 저장 안내 */}
               {isAutoMappingLoaded ? (
                 <div className="rounded-md border border-success bg-success/10 p-3">
@@ -1298,6 +1497,11 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
                         <p key={index}>
                           <span className="font-medium">{mapping.excelColumn}</span> →{" "}
                           {col?.label || mapping.systemColumn}
+                          {mapping.checkDuplicate && (
+                            <span className="ml-2 text-blue-600">
+                              (중복 체크: {mapping.duplicateAction === "overwrite" ? "덮어쓰기" : "건너뛰기"})
+                            </span>
+                          )}
                         </p>
                       );
                     })}
@@ -1307,6 +1511,29 @@ export const ExcelUploadModal: React.FC<ExcelUploadModalProps> = ({
                 </div>
               </div>
 
+              {/* 중복 체크 요약 */}
+              {duplicateCheckCount > 0 && (
+                <div className="rounded-md border border-blue-200 bg-blue-50 p-4">
+                  <h3 className="text-sm font-medium text-blue-800 sm:text-base">중복 체크 설정</h3>
+                  <div className="mt-2 space-y-1 text-[10px] text-blue-700 sm:text-xs">
+                    <p>
+                      <span className="font-medium">중복 키:</span>{" "}
+                      {columnMappings
+                        .filter((m) => m.checkDuplicate && m.systemColumn)
+                        .map((m) => {
+                          const col = systemColumns.find((c) => c.name === m.systemColumn);
+                          return col?.label || m.systemColumn;
+                        })
+                        .join(" + ")}
+                    </p>
+                    <p>
+                      <span className="font-medium">중복 시 처리:</span>{" "}
+                      {duplicateAction === "overwrite" ? "덮어쓰기 (기존 데이터 업데이트)" : "건너뛰기 (해당 행 무시)"}
+                    </p>
+                  </div>
+                </div>
+              )}
+
               <div className="rounded-md border border-warning bg-warning/10 p-3">
                 <div className="flex items-start gap-2">
                   <AlertCircle className="mt-0.5 h-4 w-4 text-warning" />