refactor: 코드 정리 및 가독성 향상

- numberingRuleController.ts에서 API 엔드포인트의 코드 스타일을 일관되게 정리하여 가독성을 높였습니다.
- 불필요한 줄바꿈을 제거하고, 코드 블록을 명확하게 정리하여 유지보수성을 개선했습니다.
- tableManagementService.ts와 ButtonConfigPanel.tsx에서 코드 정리를 통해 일관성을 유지하고, 가독성을 향상시켰습니다.
- 전반적으로 코드의 깔끔함을 유지하고, 향후 개발 시 이해하기 쉽게 개선했습니다.

backend-node/src/controllers/numberingRuleController.ts

@@ -3,14 +3,20 @@
  */
 
 import { Router, Response } from "express";
-import { authenticateToken, AuthenticatedRequest } from "../middleware/authMiddleware";
+import {
+  authenticateToken,
+  AuthenticatedRequest,
+} from "../middleware/authMiddleware";
 import { numberingRuleService } from "../services/numberingRuleService";
 import { logger } from "../utils/logger";
 
 const router = Router();
 
 // 규칙 목록 조회 (전체)
-router.get("/", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.get(
+  "/",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
 
     try {
@@ -20,22 +26,31 @@ router.get("/", authenticateToken, async (req: AuthenticatedRequest, res: Respon
       logger.error("규칙 목록 조회 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 메뉴별 사용 가능한 규칙 조회
-router.get("/available/:menuObjid?", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.get(
+  "/available/:menuObjid?",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
-  const menuObjid = req.params.menuObjid ? parseInt(req.params.menuObjid) : undefined;
+    const menuObjid = req.params.menuObjid
+      ? parseInt(req.params.menuObjid)
+      : undefined;
 
     logger.info("메뉴별 채번 규칙 조회 요청", { menuObjid, companyCode });
 
     try {
-    const rules = await numberingRuleService.getAvailableRulesForMenu(companyCode, menuObjid);
+      const rules = await numberingRuleService.getAvailableRulesForMenu(
+        companyCode,
+        menuObjid
+      );
 
       logger.info("✅ 메뉴별 채번 규칙 조회 성공 (컨트롤러)", {
         companyCode,
         menuObjid,
-      rulesCount: rules.length 
+        rulesCount: rules.length,
       });
 
       return res.json({ success: true, data: rules });
@@ -49,10 +64,14 @@ router.get("/available/:menuObjid?", authenticateToken, async (req: Authenticate
       });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 화면용 채번 규칙 조회 (테이블 기반 필터링 - 간소화)
-router.get("/available-for-screen", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.get(
+  "/available-for-screen",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { tableName } = req.query;
 
@@ -87,27 +106,37 @@ router.get("/available-for-screen", authenticateToken, async (req: Authenticated
         error: error.message,
       });
     }
-});
+  }
+);
 
 // 특정 규칙 조회
-router.get("/:ruleId", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.get(
+  "/:ruleId",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
 
     try {
       const rule = await numberingRuleService.getRuleById(ruleId, companyCode);
       if (!rule) {
-      return res.status(404).json({ success: false, error: "규칙을 찾을 수 없습니다" });
+        return res
+          .status(404)
+          .json({ success: false, error: "규칙을 찾을 수 없습니다" });
       }
       return res.json({ success: true, data: rule });
     } catch (error: any) {
       logger.error("규칙 조회 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 규칙 생성
-router.post("/", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.post(
+  "/",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const userId = req.user!.userId;
     const ruleConfig = req.body;
@@ -125,11 +154,18 @@ router.post("/", authenticateToken, async (req: AuthenticatedRequest, res: Respo
 
     try {
       if (!ruleConfig.ruleId || !ruleConfig.ruleName) {
-      return res.status(400).json({ success: false, error: "규칙 ID와 규칙명은 필수입니다" });
+        return res
+          .status(400)
+          .json({ success: false, error: "규칙 ID와 규칙명은 필수입니다" });
       }
 
       if (!Array.isArray(ruleConfig.parts) || ruleConfig.parts.length === 0) {
-      return res.status(400).json({ success: false, error: "최소 1개 이상의 규칙 파트가 필요합니다" });
+        return res
+          .status(400)
+          .json({
+            success: false,
+            error: "최소 1개 이상의 규칙 파트가 필요합니다",
+          });
       }
 
       // 🆕 scopeType이 'table'인 경우 tableName 필수 체크
@@ -142,7 +178,11 @@ router.post("/", authenticateToken, async (req: AuthenticatedRequest, res: Respo
         }
       }
 
-    const newRule = await numberingRuleService.createRule(ruleConfig, companyCode, userId);
+      const newRule = await numberingRuleService.createRule(
+        ruleConfig,
+        companyCode,
+        userId
+      );
 
       logger.info("✅ [POST /numbering-rules] 채번 규칙 생성 성공:", {
         ruleId: newRule.ruleId,
@@ -152,7 +192,9 @@ router.post("/", authenticateToken, async (req: AuthenticatedRequest, res: Respo
       return res.status(201).json({ success: true, data: newRule });
     } catch (error: any) {
       if (error.code === "23505") {
-      return res.status(409).json({ success: false, error: "이미 존재하는 규칙 ID입니다" });
+        return res
+          .status(409)
+          .json({ success: false, error: "이미 존재하는 규칙 ID입니다" });
       }
       logger.error("❌ [POST /numbering-rules] 규칙 생성 실패:", {
         error: error.message,
@@ -161,10 +203,14 @@ router.post("/", authenticateToken, async (req: AuthenticatedRequest, res: Respo
       });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 규칙 수정
-router.put("/:ruleId", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.put(
+  "/:ruleId",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
     const updates = req.body;
@@ -172,7 +218,11 @@ router.put("/:ruleId", authenticateToken, async (req: AuthenticatedRequest, res:
     logger.info("채번 규칙 수정 요청", { ruleId, companyCode, updates });
 
     try {
-    const updatedRule = await numberingRuleService.updateRule(ruleId, updates, companyCode);
+      const updatedRule = await numberingRuleService.updateRule(
+        ruleId,
+        updates,
+        companyCode
+      );
       logger.info("채번 규칙 수정 성공", { ruleId, companyCode });
       return res.json({ success: true, data: updatedRule });
     } catch (error: any) {
@@ -180,17 +230,21 @@ router.put("/:ruleId", authenticateToken, async (req: AuthenticatedRequest, res:
         ruleId,
         companyCode,
         error: error.message,
-      stack: error.stack 
+        stack: error.stack,
       });
       if (error.message.includes("찾을 수 없거나")) {
         return res.status(404).json({ success: false, error: error.message });
       }
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 규칙 삭제
-router.delete("/:ruleId", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.delete(
+  "/:ruleId",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
 
@@ -204,57 +258,97 @@ router.delete("/:ruleId", authenticateToken, async (req: AuthenticatedRequest, r
       logger.error("규칙 삭제 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 코드 미리보기 (순번 증가 없음)
-router.post("/:ruleId/preview", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.post(
+  "/:ruleId/preview",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
     const { formData } = req.body; // 폼 데이터 (카테고리 기반 채번 시 사용)
 
     try {
-    const previewCode = await numberingRuleService.previewCode(ruleId, companyCode, formData);
+      const previewCode = await numberingRuleService.previewCode(
+        ruleId,
+        companyCode,
+        formData
+      );
       return res.json({ success: true, data: { generatedCode: previewCode } });
     } catch (error: any) {
       logger.error("코드 미리보기 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 코드 할당 (저장 시점에 실제 순번 증가)
-router.post("/:ruleId/allocate", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.post(
+  "/:ruleId/allocate",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
     const { formData, userInputCode } = req.body; // 폼 데이터 + 사용자가 편집한 코드
 
-  logger.info("코드 할당 요청", { ruleId, companyCode, hasFormData: !!formData, userInputCode });
+    logger.info("코드 할당 요청", {
+      ruleId,
+      companyCode,
+      hasFormData: !!formData,
+      userInputCode,
+    });
 
     try {
-    const allocatedCode = await numberingRuleService.allocateCode(ruleId, companyCode, formData, userInputCode);
+      const allocatedCode = await numberingRuleService.allocateCode(
+        ruleId,
+        companyCode,
+        formData,
+        userInputCode
+      );
       logger.info("코드 할당 성공", { ruleId, allocatedCode });
-    return res.json({ success: true, data: { generatedCode: allocatedCode } });
+      return res.json({
+        success: true,
+        data: { generatedCode: allocatedCode },
+      });
     } catch (error: any) {
-    logger.error("코드 할당 실패", { ruleId, companyCode, error: error.message });
+      logger.error("코드 할당 실패", {
+        ruleId,
+        companyCode,
+        error: error.message,
+      });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 코드 생성 (기존 호환성 유지, deprecated)
-router.post("/:ruleId/generate", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.post(
+  "/:ruleId/generate",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
 
     try {
-    const generatedCode = await numberingRuleService.generateCode(ruleId, companyCode);
+      const generatedCode = await numberingRuleService.generateCode(
+        ruleId,
+        companyCode
+      );
       return res.json({ success: true, data: { generatedCode } });
     } catch (error: any) {
       logger.error("코드 생성 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // 시퀀스 초기화
-router.post("/:ruleId/reset", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.post(
+  "/:ruleId/reset",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
 
@@ -265,44 +359,76 @@ router.post("/:ruleId/reset", authenticateToken, async (req: AuthenticatedReques
       logger.error("시퀀스 초기화 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // ==================== 테스트 테이블용 API ====================
 
 // [테스트] 테스트 테이블에서 채번 규칙 목록 조회
-router.get("/test/list/:menuObjid?", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.get(
+  "/test/list/:menuObjid?",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
-  const menuObjid = req.params.menuObjid ? parseInt(req.params.menuObjid) : undefined;
+    const menuObjid = req.params.menuObjid
+      ? parseInt(req.params.menuObjid)
+      : undefined;
 
-  logger.info("[테스트] 채번 규칙 목록 조회 요청", { companyCode, menuObjid });
+    logger.info("[테스트] 채번 규칙 목록 조회 요청", {
+      companyCode,
+      menuObjid,
+    });
 
     try {
-    const rules = await numberingRuleService.getRulesFromTest(companyCode, menuObjid);
+      const rules = await numberingRuleService.getRulesFromTest(
-    logger.info("[테스트] 채번 규칙 목록 조회 성공", { companyCode, menuObjid, count: rules.length });
+        companyCode,
+        menuObjid
+      );
+      logger.info("[테스트] 채번 규칙 목록 조회 성공", {
+        companyCode,
+        menuObjid,
+        count: rules.length,
+      });
       return res.json({ success: true, data: rules });
     } catch (error: any) {
-    logger.error("[테스트] 채번 규칙 목록 조회 실패", { error: error.message });
+      logger.error("[테스트] 채번 규칙 목록 조회 실패", {
+        error: error.message,
+      });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // [테스트] 테이블+컬럼 기반 채번 규칙 조회
-router.get("/test/by-column/:tableName/:columnName", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.get(
+  "/test/by-column/:tableName/:columnName",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { tableName, columnName } = req.params;
 
     try {
-    const rule = await numberingRuleService.getNumberingRuleByColumn(companyCode, tableName, columnName);
+      const rule = await numberingRuleService.getNumberingRuleByColumn(
+        companyCode,
+        tableName,
+        columnName
+      );
       return res.json({ success: true, data: rule });
     } catch (error: any) {
-    logger.error("테이블+컬럼 기반 채번 규칙 조회 실패", { error: error.message });
+      logger.error("테이블+컬럼 기반 채번 규칙 조회 실패", {
+        error: error.message,
+      });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // [테스트] 테스트 테이블에 채번 규칙 저장
 // 채번 규칙은 독립적으로 생성 가능 (나중에 테이블 타입 관리에서 컬럼에 연결)
-router.post("/test/save", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.post(
+  "/test/save",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const userId = req.user!.userId;
     const ruleConfig = req.body;
@@ -319,51 +445,74 @@ router.post("/test/save", authenticateToken, async (req: AuthenticatedRequest, r
       if (!ruleConfig.ruleName) {
         return res.status(400).json({
           success: false,
-        error: "ruleName is required" 
+          error: "ruleName is required",
         });
       }
 
-    const savedRule = await numberingRuleService.saveRuleToTest(ruleConfig, companyCode, userId);
+      const savedRule = await numberingRuleService.saveRuleToTest(
+        ruleConfig,
+        companyCode,
+        userId
+      );
       return res.json({ success: true, data: savedRule });
     } catch (error: any) {
       logger.error("[테스트] 채번 규칙 저장 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // [테스트] 테스트 테이블에서 채번 규칙 삭제
-router.delete("/test/:ruleId", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.delete(
+  "/test/:ruleId",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
 
     try {
       await numberingRuleService.deleteRuleFromTest(ruleId, companyCode);
-    return res.json({ success: true, message: "테스트 채번 규칙이 삭제되었습니다" });
+      return res.json({
+        success: true,
+        message: "테스트 채번 규칙이 삭제되었습니다",
+      });
     } catch (error: any) {
       logger.error("[테스트] 채번 규칙 삭제 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // [테스트] 코드 미리보기 (테스트 테이블 사용)
-router.post("/test/:ruleId/preview", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.post(
+  "/test/:ruleId/preview",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const companyCode = req.user!.companyCode;
     const { ruleId } = req.params;
     const { formData } = req.body;
 
     try {
-    const previewCode = await numberingRuleService.previewCode(ruleId, companyCode, formData);
+      const previewCode = await numberingRuleService.previewCode(
+        ruleId,
+        companyCode,
+        formData
+      );
       return res.json({ success: true, data: { generatedCode: previewCode } });
     } catch (error: any) {
       logger.error("[테스트] 코드 미리보기 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 // ==================== 회사별 채번규칙 복제 API ====================
 
 // 회사별 채번규칙 복제
-router.post("/copy-for-company", authenticateToken, async (req: AuthenticatedRequest, res: Response) => {
+router.post(
+  "/copy-for-company",
+  authenticateToken,
+  async (req: AuthenticatedRequest, res: Response) => {
     const userCompanyCode = req.user!.companyCode;
     const { sourceCompanyCode, targetCompanyCode } = req.body;
 
@@ -371,24 +520,28 @@ router.post("/copy-for-company", authenticateToken, async (req: AuthenticatedReq
     if (userCompanyCode !== "*") {
       return res.status(403).json({
         success: false,
-      error: "최고 관리자만 사용할 수 있습니다" 
+        error: "최고 관리자만 사용할 수 있습니다",
       });
     }
 
     if (!sourceCompanyCode || !targetCompanyCode) {
       return res.status(400).json({
         success: false,
-      error: "sourceCompanyCode와 targetCompanyCode가 필요합니다" 
+        error: "sourceCompanyCode와 targetCompanyCode가 필요합니다",
       });
     }
 
     try {
-    const result = await numberingRuleService.copyRulesForCompany(sourceCompanyCode, targetCompanyCode);
+      const result = await numberingRuleService.copyRulesForCompany(
+        sourceCompanyCode,
+        targetCompanyCode
+      );
       return res.json({ success: true, data: result });
     } catch (error: any) {
       logger.error("회사별 채번규칙 복제 실패", { error: error.message });
       return res.status(500).json({ success: false, error: error.message });
     }
-});
+  }
+);
 
 export default router;

backend-node/src/services/tableManagementService.ts

@@ -322,7 +322,9 @@ export class TableManagementService {
             });
           } else {
             // menu_objid 컬럼이 없는 경우 - 매핑 없이 진행
-            logger.info("⚠️ getColumnList: menu_objid 컬럼이 없음, 카테고리 매핑 스킵");
+            logger.info(
+              "⚠️ getColumnList: menu_objid 컬럼이 없음, 카테고리 매핑 스킵"
+            );
           }
         } catch (mappingError: any) {
           logger.warn("⚠️ getColumnList: 카테고리 매핑 조회 실패, 스킵", {
@@ -488,7 +490,10 @@ export class TableManagementService {
       // table_type_columns에 모든 설정 저장 (멀티테넌시 지원)
       // detailSettings가 문자열이면 그대로, 객체면 JSON.stringify
       let detailSettingsStr = settings.detailSettings;
-      if (typeof settings.detailSettings === "object" && settings.detailSettings !== null) {
+      if (
+        typeof settings.detailSettings === "object" &&
+        settings.detailSettings !== null
+      ) {
         detailSettingsStr = JSON.stringify(settings.detailSettings);
       }
 
@@ -749,7 +754,8 @@ export class TableManagementService {
       );
 
       // 웹 타입별 기본 상세 설정 생성
-      const defaultDetailSettings = this.generateDefaultDetailSettings(finalWebType);
+      const defaultDetailSettings =
+        this.generateDefaultDetailSettings(finalWebType);
 
       // 사용자 정의 설정과 기본 설정 병합
       const finalDetailSettings = {
@@ -768,7 +774,12 @@ export class TableManagementService {
           input_type = EXCLUDED.input_type,
           detail_settings = EXCLUDED.detail_settings,
           updated_date = NOW()`,
-        [tableName, columnName, finalWebType, JSON.stringify(finalDetailSettings)]
+        [
+          tableName,
+          columnName,
+          finalWebType,
+          JSON.stringify(finalDetailSettings),
+        ]
       );
       logger.info(
         `컬럼 입력 타입 설정 완료: ${tableName}.${columnName} = ${finalWebType}`
@@ -1473,7 +1484,11 @@ export class TableManagementService {
           columnInfo &&
           (columnInfo.webType === "date" || columnInfo.webType === "datetime")
         ) {
-          return this.buildDateRangeCondition(columnName, actualValue, paramIndex);
+          return this.buildDateRangeCondition(
+            columnName,
+            actualValue,
+            paramIndex
+          );
         }
 
         // 그 외 타입이면 다중선택(IN 조건)으로 처리

frontend/components/screen/config-panels/ButtonConfigPanel.tsx

@@ -51,11 +51,7 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
 }) => {
   // 🔧 component가 없는 경우 방어 처리
   if (!component) {
-    return (
+    return <div className="text-muted-foreground p-4 text-sm">컴포넌트 정보를 불러올 수 없습니다.</div>;
-      <div className="p-4 text-sm text-muted-foreground">
-        컴포넌트 정보를 불러올 수 없습니다.
-      </div>
-    );
   }
 
   // 🔧 component에서 직접 읽기 (useMemo 제거)
@@ -122,7 +118,9 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
   const [modalActionTargetTable, setModalActionTargetTable] = useState<string | null>(null);
   const [modalActionSourceColumns, setModalActionSourceColumns] = useState<Array<{ name: string; label: string }>>([]);
   const [modalActionTargetColumns, setModalActionTargetColumns] = useState<Array<{ name: string; label: string }>>([]);
-  const [modalActionFieldMappings, setModalActionFieldMappings] = useState<Array<{ sourceField: string; targetField: string }>>([]);
+  const [modalActionFieldMappings, setModalActionFieldMappings] = useState<
+    Array<{ sourceField: string; targetField: string }>
+  >([]);
   const [modalFieldMappingSourceOpen, setModalFieldMappingSourceOpen] = useState<Record<number, boolean>>({});
   const [modalFieldMappingTargetOpen, setModalFieldMappingTargetOpen] = useState<Record<number, boolean>>({});
   const [modalFieldMappingSourceSearch, setModalFieldMappingSourceSearch] = useState<Record<number, string>>({});
@@ -464,7 +462,13 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
 
     loadModalActionMappingData();
     // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [config.action?.type, config.action?.autoDetectDataSource, config.action?.targetScreenId, currentTableName, allComponents]);
+  }, [
+    config.action?.type,
+    config.action?.autoDetectDataSource,
+    config.action?.targetScreenId,
+    currentTableName,
+    allComponents,
+  ]);
 
   // 🆕 현재 테이블 컬럼 로드 (그룹화 컬럼 선택용)
   useEffect(() => {
@@ -985,10 +989,10 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
               }}
             />
             <div className="flex flex-col">
-              <Label htmlFor="auto-detect-data-source" className="text-sm cursor-pointer">
+              <Label htmlFor="auto-detect-data-source" className="cursor-pointer text-sm">
                 선택된 데이터 전달
               </Label>
-              <p className="text-xs text-muted-foreground">
+              <p className="text-muted-foreground text-xs">
                 TableList/SplitPanel에서 선택된 데이터를 모달에 자동으로 전달합니다
               </p>
             </div>
@@ -996,11 +1000,11 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
 
           {/* 🆕 필드 매핑 UI (데이터 전달 활성화 + 테이블이 다른 경우) */}
           {component.componentConfig?.action?.autoDetectDataSource === true && (
-            <div className="mt-4 space-y-3 rounded-lg border bg-background p-3">
+            <div className="bg-background mt-4 space-y-3 rounded-lg border p-3">
               {/* 테이블 정보 표시 */}
               <div className="flex items-center justify-between text-xs">
                 <div className="flex items-center gap-2">
-                  <Database className="h-3 w-3 text-muted-foreground" />
+                  <Database className="text-muted-foreground h-3 w-3" />
                   <span className="text-muted-foreground">소스:</span>
                   <span className="font-medium">{modalActionSourceTable || "감지 중..."}</span>
                 </div>
@@ -1012,14 +1016,18 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
               </div>
 
               {/* 테이블이 같으면 자동 매핑 안내 */}
-              {modalActionSourceTable && modalActionTargetTable && modalActionSourceTable === modalActionTargetTable && (
+              {modalActionSourceTable &&
+                modalActionTargetTable &&
+                modalActionSourceTable === modalActionTargetTable && (
                   <div className="rounded-md bg-green-50 p-2 text-xs text-green-700 dark:bg-green-950/30 dark:text-green-400">
                     동일한 테이블입니다. 컬럼명이 같은 필드는 자동으로 매핑됩니다.
                   </div>
                 )}
 
               {/* 테이블이 다르면 필드 매핑 UI 표시 */}
-              {modalActionSourceTable && modalActionTargetTable && modalActionSourceTable !== modalActionTargetTable && (
+              {modalActionSourceTable &&
+                modalActionTargetTable &&
+                modalActionSourceTable !== modalActionTargetTable && (
                   <div className="space-y-2">
                     <div className="flex items-center justify-between">
                       <Label className="text-xs font-medium">필드 매핑</Label>
@@ -1029,7 +1037,10 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                         size="sm"
                         className="h-6 text-xs"
                         onClick={() => {
-                        const newMappings = [...(component.componentConfig?.action?.fieldMappings || []), { sourceField: "", targetField: "" }];
+                          const newMappings = [
+                            ...(component.componentConfig?.action?.fieldMappings || []),
+                            { sourceField: "", targetField: "" },
+                          ];
                           setModalActionFieldMappings(newMappings);
                           onUpdateProperty("componentConfig.action.fieldMappings", newMappings);
                         }}
@@ -1040,7 +1051,7 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                     </div>
 
                     {(component.componentConfig?.action?.fieldMappings || []).length === 0 && (
-                    <p className="text-xs text-muted-foreground">
+                      <p className="text-muted-foreground text-xs">
                         컬럼명이 다른 경우 매핑을 추가하세요. 매핑이 없으면 동일 컬럼명만 전달됩니다.
                       </p>
                     )}
@@ -1050,12 +1061,15 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                         {/* 소스 필드 선택 */}
                         <Popover
                           open={modalFieldMappingSourceOpen[index] || false}
-                        onOpenChange={(open) => setModalFieldMappingSourceOpen((prev) => ({ ...prev, [index]: open }))}
+                          onOpenChange={(open) =>
+                            setModalFieldMappingSourceOpen((prev) => ({ ...prev, [index]: open }))
+                          }
                         >
                           <PopoverTrigger asChild>
                             <Button variant="outline" size="sm" className="h-7 flex-1 justify-between text-xs">
                               {mapping.sourceField
-                              ? modalActionSourceColumns.find((c) => c.name === mapping.sourceField)?.label || mapping.sourceField
+                                ? modalActionSourceColumns.find((c) => c.name === mapping.sourceField)?.label ||
+                                  mapping.sourceField
                                 : "소스 컬럼 선택"}
                               <ChevronsUpDown className="ml-1 h-3 w-3 opacity-50" />
                             </Button>
@@ -1065,22 +1079,31 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                               <CommandInput
                                 placeholder="컬럼 검색..."
                                 value={modalFieldMappingSourceSearch[index] || ""}
-                              onValueChange={(val) => setModalFieldMappingSourceSearch((prev) => ({ ...prev, [index]: val }))}
+                                onValueChange={(val) =>
+                                  setModalFieldMappingSourceSearch((prev) => ({ ...prev, [index]: val }))
+                                }
                               />
                               <CommandList>
                                 <CommandEmpty>컬럼을 찾을 수 없습니다.</CommandEmpty>
                                 <CommandGroup>
                                   {modalActionSourceColumns
-                                  .filter((col) =>
+                                    .filter(
-                                    col.name.toLowerCase().includes((modalFieldMappingSourceSearch[index] || "").toLowerCase()) ||
+                                      (col) =>
-                                    col.label.toLowerCase().includes((modalFieldMappingSourceSearch[index] || "").toLowerCase())
+                                        col.name
+                                          .toLowerCase()
+                                          .includes((modalFieldMappingSourceSearch[index] || "").toLowerCase()) ||
+                                        col.label
+                                          .toLowerCase()
+                                          .includes((modalFieldMappingSourceSearch[index] || "").toLowerCase()),
                                     )
                                     .map((col) => (
                                       <CommandItem
                                         key={col.name}
                                         value={col.name}
                                         onSelect={() => {
-                                        const newMappings = [...(component.componentConfig?.action?.fieldMappings || [])];
+                                          const newMappings = [
+                                            ...(component.componentConfig?.action?.fieldMappings || []),
+                                          ];
                                           newMappings[index] = { ...newMappings[index], sourceField: col.name };
                                           setModalActionFieldMappings(newMappings);
                                           onUpdateProperty("componentConfig.action.fieldMappings", newMappings);
@@ -1088,11 +1111,14 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                                         }}
                                       >
                                         <Check
-                                        className={cn("mr-2 h-4 w-4", mapping.sourceField === col.name ? "opacity-100" : "opacity-0")}
+                                          className={cn(
+                                            "mr-2 h-4 w-4",
+                                            mapping.sourceField === col.name ? "opacity-100" : "opacity-0",
+                                          )}
                                         />
                                         <div className="flex flex-col">
                                           <span className="text-xs font-medium">{col.label}</span>
-                                        <span className="text-[10px] text-muted-foreground">{col.name}</span>
+                                          <span className="text-muted-foreground text-[10px]">{col.name}</span>
                                         </div>
                                       </CommandItem>
                                     ))}
@@ -1102,17 +1128,20 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                           </PopoverContent>
                         </Popover>
 
-                      <span className="text-xs text-muted-foreground">→</span>
+                        <span className="text-muted-foreground text-xs">→</span>
 
                         {/* 대상 필드 선택 */}
                         <Popover
                           open={modalFieldMappingTargetOpen[index] || false}
-                        onOpenChange={(open) => setModalFieldMappingTargetOpen((prev) => ({ ...prev, [index]: open }))}
+                          onOpenChange={(open) =>
+                            setModalFieldMappingTargetOpen((prev) => ({ ...prev, [index]: open }))
+                          }
                         >
                           <PopoverTrigger asChild>
                             <Button variant="outline" size="sm" className="h-7 flex-1 justify-between text-xs">
                               {mapping.targetField
-                              ? modalActionTargetColumns.find((c) => c.name === mapping.targetField)?.label || mapping.targetField
+                                ? modalActionTargetColumns.find((c) => c.name === mapping.targetField)?.label ||
+                                  mapping.targetField
                                 : "대상 컬럼 선택"}
                               <ChevronsUpDown className="ml-1 h-3 w-3 opacity-50" />
                             </Button>
@@ -1122,22 +1151,31 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                               <CommandInput
                                 placeholder="컬럼 검색..."
                                 value={modalFieldMappingTargetSearch[index] || ""}
-                              onValueChange={(val) => setModalFieldMappingTargetSearch((prev) => ({ ...prev, [index]: val }))}
+                                onValueChange={(val) =>
+                                  setModalFieldMappingTargetSearch((prev) => ({ ...prev, [index]: val }))
+                                }
                               />
                               <CommandList>
                                 <CommandEmpty>컬럼을 찾을 수 없습니다.</CommandEmpty>
                                 <CommandGroup>
                                   {modalActionTargetColumns
-                                  .filter((col) =>
+                                    .filter(
-                                    col.name.toLowerCase().includes((modalFieldMappingTargetSearch[index] || "").toLowerCase()) ||
+                                      (col) =>
-                                    col.label.toLowerCase().includes((modalFieldMappingTargetSearch[index] || "").toLowerCase())
+                                        col.name
+                                          .toLowerCase()
+                                          .includes((modalFieldMappingTargetSearch[index] || "").toLowerCase()) ||
+                                        col.label
+                                          .toLowerCase()
+                                          .includes((modalFieldMappingTargetSearch[index] || "").toLowerCase()),
                                     )
                                     .map((col) => (
                                       <CommandItem
                                         key={col.name}
                                         value={col.name}
                                         onSelect={() => {
-                                        const newMappings = [...(component.componentConfig?.action?.fieldMappings || [])];
+                                          const newMappings = [
+                                            ...(component.componentConfig?.action?.fieldMappings || []),
+                                          ];
                                           newMappings[index] = { ...newMappings[index], targetField: col.name };
                                           setModalActionFieldMappings(newMappings);
                                           onUpdateProperty("componentConfig.action.fieldMappings", newMappings);
@@ -1145,11 +1183,14 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                                         }}
                                       >
                                         <Check
-                                        className={cn("mr-2 h-4 w-4", mapping.targetField === col.name ? "opacity-100" : "opacity-0")}
+                                          className={cn(
+                                            "mr-2 h-4 w-4",
+                                            mapping.targetField === col.name ? "opacity-100" : "opacity-0",
+                                          )}
                                         />
                                         <div className="flex flex-col">
                                           <span className="text-xs font-medium">{col.label}</span>
-                                        <span className="text-[10px] text-muted-foreground">{col.name}</span>
+                                          <span className="text-muted-foreground text-[10px]">{col.name}</span>
                                         </div>
                                       </CommandItem>
                                     ))}
@@ -1164,9 +1205,11 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                           type="button"
                           variant="ghost"
                           size="sm"
-                        className="h-7 w-7 p-0 text-destructive hover:bg-destructive/10"
+                          className="text-destructive hover:bg-destructive/10 h-7 w-7 p-0"
                           onClick={() => {
-                          const newMappings = (component.componentConfig?.action?.fieldMappings || []).filter((_: any, i: number) => i !== index);
+                            const newMappings = (component.componentConfig?.action?.fieldMappings || []).filter(
+                              (_: any, i: number) => i !== index,
+                            );
                             setModalActionFieldMappings(newMappings);
                             onUpdateProperty("componentConfig.action.fieldMappings", newMappings);
                           }}
@@ -1185,9 +1228,10 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
       {/* 🆕 데이터 전달 + 모달 열기 액션 설정 (deprecated - 하위 호환성 유지) */}
       {component.componentConfig?.action?.type === "openModalWithData" && (
         <div className="mt-4 space-y-4 rounded-lg border bg-amber-50 p-4 dark:bg-amber-950/20">
-          <h4 className="text-sm font-medium text-foreground">데이터 전달 + 모달 설정</h4>
+          <h4 className="text-foreground text-sm font-medium">데이터 전달 + 모달 설정</h4>
           <p className="text-xs text-amber-600 dark:text-amber-400">
-            이 옵션은 "모달 열기" 액션으로 통합되었습니다. 새 개발에서는 "모달 열기" + "선택된 데이터 전달"을 사용하세요.
+            이 옵션은 "모달 열기" 액션으로 통합되었습니다. 새 개발에서는 "모달 열기" + "선택된 데이터 전달"을
+            사용하세요.
           </p>
 
           {/* 🆕 블록 기반 제목 빌더 */}
@@ -3546,8 +3590,8 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
         <div className="bg-muted/50 mt-4 space-y-4 rounded-lg border p-4">
           <h4 className="text-foreground text-sm font-medium">이벤트 발송 설정</h4>
           <p className="text-muted-foreground text-xs">
-            버튼 클릭 시 V2 이벤트 버스를 통해 이벤트를 발송합니다.
+            버튼 클릭 시 V2 이벤트 버스를 통해 이벤트를 발송합니다. 다른 컴포넌트나 서비스에서 이 이벤트를 수신하여
-            다른 컴포넌트나 서비스에서 이 이벤트를 수신하여 처리할 수 있습니다.
+            처리할 수 있습니다.
           </p>
 
           <div>
@@ -3597,11 +3641,13 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                   type="number"
                   className="h-8 text-xs"
                   placeholder="3"
-                  value={component.componentConfig?.action?.eventConfig?.eventPayload?.config?.scheduling?.leadTimeDays || 3}
+                  value={
+                    component.componentConfig?.action?.eventConfig?.eventPayload?.config?.scheduling?.leadTimeDays || 3
+                  }
                   onChange={(e) => {
                     onUpdateProperty(
                       "componentConfig.action.eventConfig.eventPayload.config.scheduling.leadTimeDays",
-                      parseInt(e.target.value) || 3
+                      parseInt(e.target.value) || 3,
                     );
                   }}
                 />
@@ -3613,11 +3659,14 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
                   type="number"
                   className="h-8 text-xs"
                   placeholder="100"
-                  value={component.componentConfig?.action?.eventConfig?.eventPayload?.config?.scheduling?.maxDailyCapacity || 100}
+                  value={
+                    component.componentConfig?.action?.eventConfig?.eventPayload?.config?.scheduling
+                      ?.maxDailyCapacity || 100
+                  }
                   onChange={(e) => {
                     onUpdateProperty(
                       "componentConfig.action.eventConfig.eventPayload.config.scheduling.maxDailyCapacity",
-                      parseInt(e.target.value) || 100
+                      parseInt(e.target.value) || 100,
                     );
                   }}
                 />
@@ -3625,8 +3674,8 @@ export const ButtonConfigPanel: React.FC<ButtonConfigPanelProps> = ({
 
               <div className="rounded-md bg-blue-50 p-2 dark:bg-blue-950/20">
                 <p className="text-xs text-blue-800 dark:text-blue-200">
-                  <strong>동작 방식:</strong> 테이블에서 선택된 데이터를 기반으로 스케줄을 자동 생성합니다.
+                  <strong>동작 방식:</strong> 테이블에서 선택된 데이터를 기반으로 스케줄을 자동 생성합니다. 생성 전
-                  생성 전 미리보기 확인 다이얼로그가 표시됩니다.
+                  미리보기 확인 다이얼로그가 표시됩니다.
                 </p>
               </div>
             </div>

frontend/components/screen/widgets/TabsWidget.tsx

@@ -109,18 +109,23 @@ export function TabsWidget({
       for (const tab of visibleTabs) {
         const extTab = tab as ExtendedTabItem;
         // screenId가 있고, 아직 로드하지 않았으며, 인라인 컴포넌트가 없는 경우만 로드
-        if (extTab.screenId && !screenLayouts[tab.id] && !screenLoadingStates[tab.id] && (!extTab.components || extTab.components.length === 0)) {
+        if (
-          setScreenLoadingStates(prev => ({ ...prev, [tab.id]: true }));
+          extTab.screenId &&
+          !screenLayouts[tab.id] &&
+          !screenLoadingStates[tab.id] &&
+          (!extTab.components || extTab.components.length === 0)
+        ) {
+          setScreenLoadingStates((prev) => ({ ...prev, [tab.id]: true }));
           try {
             const layoutData = await screenApi.getLayout(extTab.screenId);
             if (layoutData && layoutData.components) {
-              setScreenLayouts(prev => ({ ...prev, [tab.id]: layoutData.components }));
+              setScreenLayouts((prev) => ({ ...prev, [tab.id]: layoutData.components }));
             }
           } catch (error) {
             console.error(`탭 "${tab.label}" 화면 로드 실패:`, error);
-            setScreenErrors(prev => ({ ...prev, [tab.id]: "화면을 불러올 수 없습니다." }));
+            setScreenErrors((prev) => ({ ...prev, [tab.id]: "화면을 불러올 수 없습니다." }));
           } finally {
-            setScreenLoadingStates(prev => ({ ...prev, [tab.id]: false }));
+            setScreenLoadingStates((prev) => ({ ...prev, [tab.id]: false }));
           }
         }
       }
@@ -180,11 +185,7 @@ export function TabsWidget({
   const getTabsListClass = () => {
     const baseClass = orientation === "vertical" ? "flex-col" : "";
     const variantClass =
-      variant === "pills"
+      variant === "pills" ? "bg-muted p-1 rounded-lg" : variant === "underline" ? "border-b" : "bg-muted p-1";
-        ? "bg-muted p-1 rounded-lg"
-        : variant === "underline"
-          ? "border-b"
-          : "bg-muted p-1";
     return `${baseClass} ${variantClass}`;
   };
 
@@ -199,8 +200,8 @@ export function TabsWidget({
       if (screenLoadingStates[tab.id]) {
         return (
           <div className="flex h-full w-full items-center justify-center">
-            <Loader2 className="h-8 w-8 animate-spin text-primary" />
+            <Loader2 className="text-primary h-8 w-8 animate-spin" />
-            <span className="ml-2 text-muted-foreground">화면을 불러오는 중...</span>
+            <span className="text-muted-foreground ml-2">화면을 불러오는 중...</span>
           </div>
         );
       }
@@ -208,7 +209,7 @@ export function TabsWidget({
       // 에러 발생
       if (screenErrors[tab.id]) {
         return (
-          <div className="flex h-full w-full items-center justify-center rounded border-2 border-dashed border-destructive/50 bg-destructive/5">
+          <div className="border-destructive/50 bg-destructive/5 flex h-full w-full items-center justify-center rounded border-2 border-dashed">
             <p className="text-destructive text-sm">{screenErrors[tab.id]}</p>
           </div>
         );
@@ -223,7 +224,7 @@ export function TabsWidget({
       // 아직 로드되지 않은 경우
       return (
         <div className="flex h-full w-full items-center justify-center">
-          <Loader2 className="h-8 w-8 animate-spin text-primary" />
+          <Loader2 className="text-primary h-8 w-8 animate-spin" />
         </div>
       );
     }
@@ -246,17 +247,12 @@ export function TabsWidget({
   // screenId로 로드한 화면 컴포넌트 렌더링
   const renderScreenComponents = (components: ComponentData[]) => {
     // InteractiveScreenViewerDynamic 동적 로드
-    const InteractiveScreenViewerDynamic = require("@/components/screen/InteractiveScreenViewerDynamic").InteractiveScreenViewerDynamic;
+    const InteractiveScreenViewerDynamic =
+      require("@/components/screen/InteractiveScreenViewerDynamic").InteractiveScreenViewerDynamic;
 
     // 컴포넌트들의 최대 위치를 계산하여 스크롤 가능한 영역 확보
-    const maxBottom = Math.max(
+    const maxBottom = Math.max(...components.map((c) => (c.position?.y || 0) + (c.size?.height || 100)), 300);
-      ...components.map((c) => (c.position?.y || 0) + (c.size?.height || 100)),
+    const maxRight = Math.max(...components.map((c) => (c.position?.x || 0) + (c.size?.width || 200)), 400);
-      300
-    );
-    const maxRight = Math.max(
-      ...components.map((c) => (c.position?.x || 0) + (c.size?.width || 200)),
-      400
-    );
 
     return (
       <div
@@ -295,11 +291,11 @@ export function TabsWidget({
     // 컴포넌트들의 최대 위치를 계산하여 스크롤 가능한 영역 확보
     const maxBottom = Math.max(
       ...components.map((c) => (c.position?.y || 0) + (c.size?.height || 100)),
-      300 // 최소 높이
+      300, // 최소 높이
     );
     const maxRight = Math.max(
       ...components.map((c) => (c.position?.x || 0) + (c.size?.width || 200)),
-      400 // 최소 너비
+      400, // 최소 너비
     );
 
     return (
@@ -319,7 +315,7 @@ export function TabsWidget({
               className={cn(
                 "absolute",
                 isDesignMode && "cursor-move",
-                isDesignMode && isSelected && "ring-2 ring-primary ring-offset-2"
+                isDesignMode && isSelected && "ring-primary ring-2 ring-offset-2",
               )}
               style={{
                 left: comp.position?.x || 0,
@@ -380,9 +376,7 @@ export function TabsWidget({
                 <TabsTrigger value={tab.id} disabled={tab.disabled} className="relative pr-8">
                   {tab.label}
                   {tab.components && tab.components.length > 0 && (
-                    <span className="ml-1 text-xs text-muted-foreground">
+                    <span className="text-muted-foreground ml-1 text-xs">({tab.components.length})</span>
-                      ({tab.components.length})
-                    </span>
                   )}
                 </TabsTrigger>
                 {allowCloseable && (
@@ -390,7 +384,7 @@ export function TabsWidget({
                     onClick={(e) => handleCloseTab(tab.id, e)}
                     variant="ghost"
                     size="sm"
-                    className="absolute right-1 top-1/2 h-5 w-5 -translate-y-1/2 p-0 hover:bg-destructive/10"
+                    className="hover:bg-destructive/10 absolute top-1/2 right-1 h-5 w-5 -translate-y-1/2 p-0"
                   >
                     <X className="h-3 w-3" />
                   </Button>

frontend/components/unified/UnifiedRepeater.tsx

@@ -124,13 +124,16 @@ export const UnifiedRepeater: React.FC<UnifiedRepeaterProps> = ({
   // DataProvidable 인터페이스 구현
   // 다른 컴포넌트에서 이 리피터의 데이터를 가져갈 수 있게 함
   // ============================================================
-  const dataProvider: DataProvidable = useMemo(() => ({
+  const dataProvider: DataProvidable = useMemo(
+    () => ({
       componentId: parentId || config.fieldName || "unified-repeater",
       componentType: "unified-repeater",
 
       // 선택된 행 데이터 반환
       getSelectedData: () => {
-      return Array.from(selectedRows).map((idx) => data[idx]).filter(Boolean);
+        return Array.from(selectedRows)
+          .map((idx) => data[idx])
+          .filter(Boolean);
       },
 
       // 전체 데이터 반환
@@ -142,13 +145,16 @@ export const UnifiedRepeater: React.FC<UnifiedRepeaterProps> = ({
       clearSelection: () => {
         setSelectedRows(new Set());
       },
-  }), [parentId, config.fieldName, data, selectedRows]);
+    }),
+    [parentId, config.fieldName, data, selectedRows],
+  );
 
   // ============================================================
   // DataReceivable 인터페이스 구현
   // 외부에서 이 리피터로 데이터를 전달받을 수 있게 함
   // ============================================================
-  const dataReceiver: DataReceivable = useMemo(() => ({
+  const dataReceiver: DataReceivable = useMemo(
+    () => ({
       componentId: parentId || config.fieldName || "unified-repeater",
       componentType: "repeater",
 
@@ -200,7 +206,9 @@ export const UnifiedRepeater: React.FC<UnifiedRepeaterProps> = ({
       getData: () => {
         return [...data];
       },
-  }), [parentId, config.fieldName, data, onDataChange]);
+    }),
+    [parentId, config.fieldName, data, onDataChange],
+  );
 
   // ============================================================
   // ScreenContext에 DataProvider/DataReceiver 등록
@@ -231,7 +239,9 @@ export const UnifiedRepeater: React.FC<UnifiedRepeaterProps> = ({
         componentId: parentId || config.fieldName || "unified-repeater",
         tableName: config.dataSource?.tableName || "",
         data: data,
-        selectedData: Array.from(selectedRows).map((idx) => data[idx]).filter(Boolean),
+        selectedData: Array.from(selectedRows)
+          .map((idx) => data[idx])
+          .filter(Boolean),
       });
       prevDataLengthRef.current = data.length;
     }
@@ -701,7 +711,8 @@ export const UnifiedRepeater: React.FC<UnifiedRepeaterProps> = ({
 
   // 🆕 채번 API 호출 (비동기)
   // 🆕 수동 입력 부분 지원을 위해 userInputCode 파라미터 추가
-  const generateNumberingCode = useCallback(async (ruleId: string, userInputCode?: string, formData?: Record<string, any>): Promise<string> => {
+  const generateNumberingCode = useCallback(
+    async (ruleId: string, userInputCode?: string, formData?: Record<string, any>): Promise<string> => {
       try {
         const result = await allocateNumberingCode(ruleId, userInputCode, formData);
         if (result.success && result.data?.generatedCode) {
@@ -713,7 +724,9 @@ export const UnifiedRepeater: React.FC<UnifiedRepeaterProps> = ({
         console.error("채번 API 호출 실패:", error);
         return "";
       }
-  }, []);
+    },
+    [],
+  );
 
   // 🆕 행 추가 (inline 모드 또는 모달 열기) - 비동기로 변경
   const handleAddRow = useCallback(async () => {

frontend/components/v2/V2Repeater.tsx

@@ -88,9 +88,8 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
   // 전역 리피터 등록
   // 🆕 useCustomTable이 설정된 경우 mainTableName 사용 (실제 저장될 테이블)
   useEffect(() => {
-    const targetTableName = config.useCustomTable && config.mainTableName
+    const targetTableName =
-      ? config.mainTableName
+      config.useCustomTable && config.mainTableName ? config.mainTableName : config.dataSource?.tableName;
-      : config.dataSource?.tableName;
 
     if (targetTableName) {
       if (!window.__v2RepeaterInstances) {
@@ -110,9 +109,8 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
   useEffect(() => {
     const handleSaveEvent = async (event: CustomEvent) => {
       // 🆕 mainTableName이 설정된 경우 우선 사용, 없으면 dataSource.tableName 사용
-      const tableName = config.useCustomTable && config.mainTableName 
+      const tableName =
-        ? config.mainTableName 
+        config.useCustomTable && config.mainTableName ? config.mainTableName : config.dataSource?.tableName;
-        : config.dataSource?.tableName;
       const eventParentId = event.detail?.parentId;
       const mainFormData = event.detail?.mainFormData;
 
@@ -196,7 +194,6 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
 
           await apiClient.post(`/table-management/tables/${tableName}/add`, filteredData);
         }
-
       } catch (error) {
         console.error("❌ V2Repeater 저장 실패:", error);
         throw error;
@@ -207,14 +204,13 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
     const unsubscribe = v2EventBus.subscribe(
       V2_EVENTS.REPEATER_SAVE,
       async (payload) => {
-        const tableName = config.useCustomTable && config.mainTableName
+        const tableName =
-          ? config.mainTableName
+          config.useCustomTable && config.mainTableName ? config.mainTableName : config.dataSource?.tableName;
-          : config.dataSource?.tableName;
         if (payload.tableName === tableName) {
           await handleSaveEvent({ detail: payload } as CustomEvent);
         }
       },
-      { componentId: `v2-repeater-${config.dataSource?.tableName}` }
+      { componentId: `v2-repeater-${config.dataSource?.tableName}` },
     );
 
     // 레거시 이벤트도 계속 지원 (점진적 마이그레이션)
@@ -223,7 +219,14 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
       unsubscribe();
       window.removeEventListener("repeaterSave" as any, handleSaveEvent);
     };
-  }, [data, config.dataSource?.tableName, config.useCustomTable, config.mainTableName, config.foreignKeyColumn, parentId]);
+  }, [
+    data,
+    config.dataSource?.tableName,
+    config.useCustomTable,
+    config.mainTableName,
+    config.foreignKeyColumn,
+    parentId,
+  ]);
 
   // 현재 테이블 컬럼 정보 로드
   useEffect(() => {
@@ -455,13 +458,12 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
 
       // 🆕 _targetTable 메타데이터 포함하여 전달 (백엔드에서 테이블 분리용)
       if (onDataChange) {
-      const targetTable = config.useCustomTable && config.mainTableName 
+        const targetTable =
-        ? config.mainTableName 
+          config.useCustomTable && config.mainTableName ? config.mainTableName : config.dataSource?.tableName;
-        : config.dataSource?.tableName;
 
         if (targetTable) {
           // 각 행에 _targetTable 추가
-        const dataWithTarget = newData.map(row => ({
+          const dataWithTarget = newData.map((row) => ({
             ...row,
             _targetTable: targetTable,
           }));
@@ -486,12 +488,11 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
 
       // 🆕 _targetTable 메타데이터 포함
       if (onDataChange) {
-      const targetTable = config.useCustomTable && config.mainTableName 
+        const targetTable =
-        ? config.mainTableName 
+          config.useCustomTable && config.mainTableName ? config.mainTableName : config.dataSource?.tableName;
-        : config.dataSource?.tableName;
 
         if (targetTable) {
-        const dataWithTarget = newData.map(row => ({
+          const dataWithTarget = newData.map((row) => ({
             ...row,
             _targetTable: targetTable,
           }));
@@ -568,7 +569,8 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
 
   // 🆕 채번 API 호출 (비동기)
   // 🆕 수동 입력 부분 지원을 위해 userInputCode 파라미터 추가
-  const generateNumberingCode = useCallback(async (ruleId: string, userInputCode?: string, formData?: Record<string, any>): Promise<string> => {
+  const generateNumberingCode = useCallback(
+    async (ruleId: string, userInputCode?: string, formData?: Record<string, any>): Promise<string> => {
       try {
         const result = await allocateNumberingCode(ruleId, userInputCode, formData);
         if (result.success && result.data?.generatedCode) {
@@ -580,7 +582,9 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
         console.error("채번 API 호출 실패:", error);
         return "";
       }
-  }, []);
+    },
+    [],
+  );
 
   // 🆕 행 추가 (inline 모드 또는 모달 열기) - 비동기로 변경
   const handleAddRow = useCallback(async () => {
@@ -616,7 +620,7 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
 
       // 채번이 필요한 컬럼 찾기
       const numberingColumns = config.columns.filter(
-        (col) => !col.isSourceDisplay && col.autoFill?.type === "numbering" && col.autoFill.numberingRuleId
+        (col) => !col.isSourceDisplay && col.autoFill?.type === "numbering" && col.autoFill.numberingRuleId,
       );
 
       const newRows = await Promise.all(
@@ -649,14 +653,22 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
           }
 
           return row;
-        })
+        }),
       );
 
       const newData = [...data, ...newRows];
       handleDataChange(newData);
       setModalOpen(false);
     },
-    [config.dataSource?.foreignKey, resolvedReferenceKey, config.columns, data, handleDataChange, generateAutoFillValueSync, generateNumberingCode],
+    [
+      config.dataSource?.foreignKey,
+      resolvedReferenceKey,
+      config.columns,
+      data,
+      handleDataChange,
+      generateAutoFillValueSync,
+      generateNumberingCode,
+    ],
   );
 
   // 소스 컬럼 목록 (모달용) - 🆕 columns 배열에서 isSourceDisplay인 것만 필터링
@@ -726,7 +738,7 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
         } as CustomEvent;
         await handleBeforeFormSave(fakeEvent);
       },
-      { componentId: `v2-repeater-${config.dataSource?.tableName}` }
+      { componentId: `v2-repeater-${config.dataSource?.tableName}` },
     );
 
     // 레거시 이벤트도 계속 지원 (점진적 마이그레이션)
@@ -831,7 +843,7 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
         } as CustomEvent;
         handleComponentDataTransfer(fakeEvent);
       },
-      { componentId: `v2-repeater-${config.dataSource?.tableName}` }
+      { componentId: `v2-repeater-${config.dataSource?.tableName}` },
     );
 
     const unsubscribeSplitPanel = v2EventBus.subscribe(
@@ -846,7 +858,7 @@ export const V2Repeater: React.FC<V2RepeaterProps> = ({
         } as CustomEvent;
         handleSplitPanelDataTransfer(fakeEvent);
       },
-      { componentId: `v2-repeater-${config.dataSource?.tableName}` }
+      { componentId: `v2-repeater-${config.dataSource?.tableName}` },
     );
 
     // 레거시 이벤트도 계속 지원 (점진적 마이그레이션)
@@ -928,11 +940,7 @@ V2Repeater.displayName = "V2Repeater";
 // V2ErrorBoundary로 래핑된 안전한 버전 export
 export const SafeV2Repeater: React.FC<V2RepeaterProps> = (props) => {
   return (
-    <V2ErrorBoundary
+    <V2ErrorBoundary componentId={props.parentId || "v2-repeater"} componentType="V2Repeater" fallbackStyle="compact">
-      componentId={props.parentId || "v2-repeater"}
-      componentType="V2Repeater"
-      fallbackStyle="compact"
-    >
       <V2Repeater {...props} />
     </V2ErrorBoundary>
   );

frontend/lib/api/numberingRule.ts

@@ -26,13 +26,9 @@ export async function getNumberingRules(): Promise<ApiResponse<NumberingRuleConf
  * @param menuObjid 현재 메뉴의 objid (선택)
  * @returns 사용 가능한 채번 규칙 목록
  */
-export async function getAvailableNumberingRules(
+export async function getAvailableNumberingRules(menuObjid?: number): Promise<ApiResponse<NumberingRuleConfig[]>> {
-  menuObjid?: number
-): Promise<ApiResponse<NumberingRuleConfig[]>> {
   try {
-    const url = menuObjid
+    const url = menuObjid ? `/numbering-rules/available/${menuObjid}` : "/numbering-rules/available";
-      ? `/numbering-rules/available/${menuObjid}`
-      : "/numbering-rules/available";
     const response = await apiClient.get(url);
     return response.data;
   } catch (error: any) {
@@ -46,7 +42,7 @@ export async function getAvailableNumberingRules(
  * @returns 해당 테이블의 채번 규칙 목록
  */
 export async function getAvailableNumberingRulesForScreen(
-  tableName: string
+  tableName: string,
 ): Promise<ApiResponse<NumberingRuleConfig[]>> {
   try {
     const response = await apiClient.get("/numbering-rules/available-for-screen", {
@@ -70,9 +66,7 @@ export async function getNumberingRuleById(ruleId: string): Promise<ApiResponse<
   }
 }
 
-export async function createNumberingRule(
+export async function createNumberingRule(config: NumberingRuleConfig): Promise<ApiResponse<NumberingRuleConfig>> {
-  config: NumberingRuleConfig
-): Promise<ApiResponse<NumberingRuleConfig>> {
   try {
     const response = await apiClient.post("/numbering-rules", config);
     return response.data;
@@ -83,7 +77,7 @@ export async function createNumberingRule(
 
 export async function updateNumberingRule(
   ruleId: string,
-  config: Partial<NumberingRuleConfig>
+  config: Partial<NumberingRuleConfig>,
 ): Promise<ApiResponse<NumberingRuleConfig>> {
   try {
     const response = await apiClient.put(`/numbering-rules/${ruleId}`, config);
@@ -110,7 +104,7 @@ export async function deleteNumberingRule(ruleId: string): Promise<ApiResponse<v
  */
 export async function previewNumberingCode(
   ruleId: string,
-  formData?: Record<string, unknown>
+  formData?: Record<string, unknown>,
 ): Promise<ApiResponse<{ generatedCode: string }>> {
   // ruleId 유효성 검사
   if (!ruleId || ruleId === "undefined" || ruleId === "null") {
@@ -128,10 +122,7 @@ export async function previewNumberingCode(
   } catch (error: unknown) {
     const err = error as { response?: { data?: { error?: string; message?: string } }; message?: string };
     const errorMessage =
-      err.response?.data?.error || 
+      err.response?.data?.error || err.response?.data?.message || err.message || "코드 미리보기 실패";
-      err.response?.data?.message || 
-      err.message || 
-      "코드 미리보기 실패";
     return { success: false, error: errorMessage };
   }
 }
@@ -146,7 +137,7 @@ export async function previewNumberingCode(
 export async function allocateNumberingCode(
   ruleId: string,
   userInputCode?: string,
-  formData?: Record<string, any>
+  formData?: Record<string, any>,
 ): Promise<ApiResponse<{ generatedCode: string }>> {
   try {
     const response = await apiClient.post(`/numbering-rules/${ruleId}/allocate`, {
@@ -162,9 +153,7 @@ export async function allocateNumberingCode(
 /**
  * @deprecated 기존 generateNumberingCode는 previewNumberingCode를 사용하세요
  */
-export async function generateNumberingCode(
+export async function generateNumberingCode(ruleId: string): Promise<ApiResponse<{ generatedCode: string }>> {
-  ruleId: string
-): Promise<ApiResponse<{ generatedCode: string }>> {
   console.warn("generateNumberingCode는 deprecated. previewNumberingCode 사용 권장");
   return previewNumberingCode(ruleId);
 }
@@ -188,13 +177,9 @@ export async function resetSequence(ruleId: string): Promise<ApiResponse<void>>
  * numbering_rules 테이블 사용
  * @param menuObjid 메뉴 OBJID (선택) - 필터링용
  */
-export async function getNumberingRulesFromTest(
+export async function getNumberingRulesFromTest(menuObjid?: number): Promise<ApiResponse<NumberingRuleConfig[]>> {
-  menuObjid?: number
-): Promise<ApiResponse<NumberingRuleConfig[]>> {
   try {
-    const url = menuObjid
+    const url = menuObjid ? `/numbering-rules/test/list/${menuObjid}` : "/numbering-rules/test/list";
-      ? `/numbering-rules/test/list/${menuObjid}`
-      : "/numbering-rules/test/list";
     const response = await apiClient.get(url);
     return response.data;
   } catch (error: any) {
@@ -211,7 +196,7 @@ export async function getNumberingRulesFromTest(
  */
 export async function getNumberingRuleByColumn(
   tableName: string,
-  columnName: string
+  columnName: string,
 ): Promise<ApiResponse<NumberingRuleConfig>> {
   try {
     const response = await apiClient.get("/numbering-rules/test/by-column", {
@@ -230,9 +215,7 @@ export async function getNumberingRuleByColumn(
  * [테스트] 테스트 테이블에 채번규칙 저장
  * numbering_rules 테이블 사용
  */
-export async function saveNumberingRuleToTest(
+export async function saveNumberingRuleToTest(config: NumberingRuleConfig): Promise<ApiResponse<NumberingRuleConfig>> {
-  config: NumberingRuleConfig
-): Promise<ApiResponse<NumberingRuleConfig>> {
   try {
     const response = await apiClient.post("/numbering-rules/test/save", config);
     return response.data;
@@ -248,9 +231,7 @@ export async function saveNumberingRuleToTest(
  * [테스트] 테스트 테이블에서 채번규칙 삭제
  * numbering_rules 테이블 사용
  */
-export async function deleteNumberingRuleFromTest(
+export async function deleteNumberingRuleFromTest(ruleId: string): Promise<ApiResponse<void>> {
-  ruleId: string
-): Promise<ApiResponse<void>> {
   try {
     const response = await apiClient.delete(`/numbering-rules/test/${ruleId}`);
     return response.data;
@@ -270,7 +251,7 @@ export async function getNumberingRuleByColumnWithCategory(
   tableName: string,
   columnName: string,
   categoryColumn?: string,
-  categoryValueId?: number
+  categoryValueId?: number,
 ): Promise<ApiResponse<NumberingRuleConfig>> {
   try {
     const response = await apiClient.get("/numbering-rules/test/by-column-with-category", {
@@ -290,7 +271,7 @@ export async function getNumberingRuleByColumnWithCategory(
  */
 export async function getRulesByTableColumn(
   tableName: string,
-  columnName: string
+  columnName: string,
 ): Promise<ApiResponse<NumberingRuleConfig[]>> {
   try {
     const response = await apiClient.get("/numbering-rules/test/rules-by-table-column", {
@@ -304,4 +285,3 @@ export async function getRulesByTableColumn(
     };
   }
 }
-

frontend/lib/registry/components/universal-form-modal/UniversalFormModalComponent.tsx

@@ -115,14 +115,14 @@ const CascadingSelectField: React.FC<CascadingSelectFieldProps> = ({
               type="button"
               variant="ghost"
               size="sm"
-              className="absolute right-0 top-0 h-full px-2 hover:bg-transparent"
+              className="absolute top-0 right-0 h-full px-2 hover:bg-transparent"
               onClick={() => !isDisabled && setOpen(!open)}
               disabled={isDisabled}
             >
               {loading ? (
-                <Loader2 className="h-4 w-4 animate-spin text-muted-foreground" />
+                <Loader2 className="text-muted-foreground h-4 w-4 animate-spin" />
               ) : (
-                <ChevronsUpDown className="h-4 w-4 text-muted-foreground" />
+                <ChevronsUpDown className="text-muted-foreground h-4 w-4" />
               )}
             </Button>
           </div>
@@ -149,12 +149,7 @@ const CascadingSelectField: React.FC<CascadingSelectFieldProps> = ({
                         setOpen(false);
                       }}
                     >
-                      <Check
+                      <Check className={cn("mr-2 h-4 w-4", value === option.value ? "opacity-100" : "opacity-0")} />
-                        className={cn(
-                          "mr-2 h-4 w-4",
-                          value === option.value ? "opacity-100" : "opacity-0"
-                        )}
-                      />
                       {option.label}
                     </CommandItem>
                   ))}
@@ -948,13 +943,17 @@ export function UniversalFormModalComponent({
             // 각 테이블 섹션별로 별도의 키에 원본 데이터 저장 (groupedDataInitializedRef와 무관하게 항상 저장)
             const originalTableSectionKey = `_originalTableSectionData_${section.id}`;
             newFormData[originalTableSectionKey] = JSON.parse(JSON.stringify(items));
-            console.log(`[initializeForm] 테이블 섹션 ${section.id}: formData[${originalTableSectionKey}]에 원본 ${items.length}건 저장`);
+            console.log(
+              `[initializeForm] 테이블 섹션 ${section.id}: formData[${originalTableSectionKey}]에 원본 ${items.length}건 저장`,
+            );
 
             // 기존 originalGroupedData에도 추가 (하위 호환성)
             if (!groupedDataInitializedRef.current) {
               setOriginalGroupedData((prev) => {
                 const newOriginal = [...prev, ...JSON.parse(JSON.stringify(items))];
-                console.log(`[initializeForm] 테이블 섹션 ${section.id}: originalGroupedData에 ${items.length}건 추가 (총 ${newOriginal.length}건)`);
+                console.log(
+                  `[initializeForm] 테이블 섹션 ${section.id}: originalGroupedData에 ${items.length}건 추가 (총 ${newOriginal.length}건)`,
+                );
                 return newOriginal;
               });
             }
@@ -2433,14 +2432,14 @@ function SelectField({ fieldId, value, onChange, optionConfig, placeholder, disa
               type="button"
               variant="ghost"
               size="sm"
-              className="absolute right-0 top-0 h-full px-2 hover:bg-transparent"
+              className="absolute top-0 right-0 h-full px-2 hover:bg-transparent"
               onClick={() => !disabled && !loading && setOpen(!open)}
               disabled={disabled || loading}
             >
               {loading ? (
-                <Loader2 className="h-4 w-4 animate-spin text-muted-foreground" />
+                <Loader2 className="text-muted-foreground h-4 w-4 animate-spin" />
               ) : (
-                <ChevronsUpDown className="h-4 w-4 text-muted-foreground" />
+                <ChevronsUpDown className="text-muted-foreground h-4 w-4" />
               )}
             </Button>
           </div>
@@ -2463,12 +2462,7 @@ function SelectField({ fieldId, value, onChange, optionConfig, placeholder, disa
                         setOpen(false);
                       }}
                     >
-                      <Check
+                      <Check className={cn("mr-2 h-4 w-4", value === option.value ? "opacity-100" : "opacity-0")} />
-                        className={cn(
-                          "mr-2 h-4 w-4",
-                          value === option.value ? "opacity-100" : "opacity-0"
-                        )}
-                      />
                       {option.label}
                     </CommandItem>
                   ))}

frontend/lib/registry/components/v2-input/V2InputRenderer.tsx

@@ -47,7 +47,7 @@ export class V2InputRenderer extends AutoRegisteringComponentRenderer {
     const style = component.style || {};
     const labelDisplay = style.labelDisplay ?? (component as any).labelDisplay;
     // labelDisplay: true → 라벨 표시, false → 숨김, undefined → 기존 동작 유지(숨김)
-    const effectiveLabel = labelDisplay === true ? (style.labelText || component.label) : undefined;
+    const effectiveLabel = labelDisplay === true ? style.labelText || component.label : undefined;
 
     return (
       <V2Input

frontend/lib/utils/buttonActions.ts

@@ -1626,7 +1626,9 @@ export class ButtonActionExecutor {
           // saveResult.data.data.data = 실제 폼 데이터 { sabun, user_name... }
           const savedRecord = saveResult?.data?.data || saveResult?.data || {};
           const actualFormData = savedRecord?.data || savedRecord;
-          const formData: Record<string, any> = (Object.keys(actualFormData).length > 0 ? actualFormData : context.formData || {}) as Record<string, any>;
+          const formData: Record<string, any> = (
+            Object.keys(actualFormData).length > 0 ? actualFormData : context.formData || {}
+          ) as Record<string, any>;
           console.log("📦 [executeAfterSaveControl] savedRecord 구조:", Object.keys(savedRecord));
           console.log("📦 [executeAfterSaveControl] actualFormData 추출:", Object.keys(formData));
           console.log("📦 [executeAfterSaveControl] formData.sabun:", formData.sabun);
@@ -2924,8 +2926,7 @@ export class ButtonActionExecutor {
 
             if (v2ListComponent) {
               dataSourceId =
-                v2ListComponent.componentConfig.dataSource?.table ||
+                v2ListComponent.componentConfig.dataSource?.table || v2ListComponent.componentConfig.tableName;
-                v2ListComponent.componentConfig.tableName;
               console.log("✨ V2List 자동 감지:", {
                 componentId: v2ListComponent.id,
                 tableName: dataSourceId,