feat: Enhance SplitPanelLayout with modal support for add and edit buttons

- Implemented modal configuration for add and edit buttons in the SplitPanelLayoutComponent, allowing for custom modal screens based on user interactions.
- Added settings for button visibility and modes (auto or modal) in the SplitPanelLayoutConfigPanel, improving flexibility in UI configuration.
- Enhanced data handling by storing selected left panel items in modalDataStore for use in modal screens, ensuring seamless data flow.
- Updated types to include new properties for add and edit button configurations, facilitating better type safety and clarity in component usage.

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

@@ -1993,6 +1993,88 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
   // 추가 버튼 핸들러
   const handleAddClick = useCallback(
     (panel: "left" | "right") => {
+      // 좌측 패널 추가 시, addButton 모달 모드 확인
+      if (panel === "left") {
+        const addButtonConfig = componentConfig.leftPanel?.addButton;
+        if (addButtonConfig?.mode === "modal" && addButtonConfig?.modalScreenId) {
+          const leftTableName = componentConfig.leftPanel?.tableName || "";
+
+          // ScreenModal 열기 이벤트 발생
+          window.dispatchEvent(
+            new CustomEvent("openScreenModal", {
+              detail: {
+                screenId: addButtonConfig.modalScreenId,
+                urlParams: {
+                  mode: "add",
+                  tableName: leftTableName,
+                },
+              },
+            }),
+          );
+
+          console.log("✅ [SplitPanel] 좌측 추가 모달 화면 열기:", {
+            screenId: addButtonConfig.modalScreenId,
+            tableName: leftTableName,
+          });
+          return;
+        }
+      }
+
+      // 우측 패널 추가 시, addButton 모달 모드 확인
+      if (panel === "right") {
+        const addButtonConfig =
+          activeTabIndex === 0
+            ? componentConfig.rightPanel?.addButton
+            : (componentConfig.rightPanel?.additionalTabs?.[activeTabIndex - 1] as any)?.addButton;
+
+        if (addButtonConfig?.mode === "modal" && addButtonConfig?.modalScreenId) {
+          // 커스텀 모달 화면 열기
+          const currentTableName =
+            activeTabIndex === 0
+              ? componentConfig.rightPanel?.tableName || ""
+              : (componentConfig.rightPanel?.additionalTabs?.[activeTabIndex - 1] as any)?.tableName || "";
+
+          // 좌측 선택 데이터를 modalDataStore에 저장 (추가 화면에서 참조 가능)
+          if (selectedLeftItem && componentConfig.leftPanel?.tableName) {
+            import("@/stores/modalDataStore").then(({ useModalDataStore }) => {
+              useModalDataStore.getState().setData(componentConfig.leftPanel!.tableName!, [selectedLeftItem]);
+            });
+          }
+
+          // ScreenModal 열기 이벤트 발생
+          window.dispatchEvent(
+            new CustomEvent("openScreenModal", {
+              detail: {
+                screenId: addButtonConfig.modalScreenId,
+                urlParams: {
+                  mode: "add",
+                  tableName: currentTableName,
+                  // 좌측 선택 항목의 연결 키 값 전달
+                  ...(selectedLeftItem && (() => {
+                    const relation = activeTabIndex === 0
+                      ? componentConfig.rightPanel?.relation
+                      : (componentConfig.rightPanel?.additionalTabs?.[activeTabIndex - 1] as any)?.relation;
+                    const leftColumn = relation?.keys?.[0]?.leftColumn || relation?.leftColumn;
+                    const rightColumn = relation?.keys?.[0]?.rightColumn || relation?.foreignKey;
+                    if (leftColumn && rightColumn && selectedLeftItem[leftColumn] !== undefined) {
+                      return { [rightColumn]: selectedLeftItem[leftColumn] };
+                    }
+                    return {};
+                  })()),
+                },
+              },
+            }),
+          );
+
+          console.log("✅ [SplitPanel] 추가 모달 화면 열기:", {
+            screenId: addButtonConfig.modalScreenId,
+            tableName: currentTableName,
+          });
+          return;
+        }
+      }
+
+      // 기존 내장 추가 모달 로직
       setAddModalPanel(panel);
 
       // 우측 패널 추가 시, 좌측에서 선택된 항목의 조인 컬럼 값을 자동으로 채움
@@ -2012,12 +2094,66 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
 
       setShowAddModal(true);
     },
-    [selectedLeftItem, componentConfig],
+    [selectedLeftItem, componentConfig, activeTabIndex],
   );
 
   // 수정 버튼 핸들러
   const handleEditClick = useCallback(
     (panel: "left" | "right", item: any) => {
+      // 좌측 패널 수정 버튼 설정 확인 (모달 모드)
+      if (panel === "left") {
+        const editButtonConfig = componentConfig.leftPanel?.editButton;
+        if (editButtonConfig?.mode === "modal" && editButtonConfig?.modalScreenId) {
+          const leftTableName = componentConfig.leftPanel?.tableName || "";
+          const sourceColumn = componentConfig.leftPanel?.itemAddConfig?.sourceColumn || "id";
+
+          // Primary Key 찾기
+          let primaryKeyName = sourceColumn;
+          let primaryKeyValue = item[sourceColumn];
+
+          if (primaryKeyValue === undefined || primaryKeyValue === null) {
+            if (item.id !== undefined && item.id !== null) {
+              primaryKeyName = "id";
+              primaryKeyValue = item.id;
+            } else if (item.ID !== undefined && item.ID !== null) {
+              primaryKeyName = "ID";
+              primaryKeyValue = item.ID;
+            } else {
+              const firstKey = Object.keys(item)[0];
+              primaryKeyName = firstKey;
+              primaryKeyValue = item[firstKey];
+            }
+          }
+
+          // modalDataStore에 저장
+          import("@/stores/modalDataStore").then(({ useModalDataStore }) => {
+            useModalDataStore.getState().setData(leftTableName, [item]);
+          });
+
+          // ScreenModal 열기 이벤트 발생
+          window.dispatchEvent(
+            new CustomEvent("openScreenModal", {
+              detail: {
+                screenId: editButtonConfig.modalScreenId,
+                urlParams: {
+                  mode: "edit",
+                  editId: primaryKeyValue,
+                  tableName: leftTableName,
+                },
+              },
+            }),
+          );
+
+          console.log("✅ [SplitPanel] 좌측 수정 모달 화면 열기:", {
+            screenId: editButtonConfig.modalScreenId,
+            tableName: leftTableName,
+            primaryKeyName,
+            primaryKeyValue,
+          });
+          return;
+        }
+      }
+
       // 우측 패널 수정 버튼 설정 확인 (탭별 설정 지원)
       if (panel === "right") {
         const editButtonConfig =
@@ -3339,29 +3475,33 @@ export const SplitPanelLayoutComponent: React.FC<SplitPanelLayoutComponentProps>
                               {/* 항목별 버튼들 */}
                               {!isDesignMode && (
                                 <div className="flex flex-shrink-0 items-center gap-1 opacity-0 transition-opacity group-hover:opacity-100">
-                                  {/* 수정 버튼 */}
-                                  <button
-                                    onClick={(e) => {
-                                      e.stopPropagation();
-                                      handleEditClick("left", item);
-                                    }}
-                                    className="rounded p-1 transition-colors hover:bg-gray-200"
-                                    title="수정"
-                                  >
-                                    <Pencil className="h-4 w-4 text-gray-600" />
-                                  </button>
+                                  {/* 수정 버튼 (showEdit 활성화 시에만 표시) */}
+                                  {(componentConfig.leftPanel?.showEdit !== false) && (
+                                    <button
+                                      onClick={(e) => {
+                                        e.stopPropagation();
+                                        handleEditClick("left", item);
+                                      }}
+                                      className="rounded p-1 transition-colors hover:bg-gray-200"
+                                      title="수정"
+                                    >
+                                      <Pencil className="h-4 w-4 text-gray-600" />
+                                    </button>
+                                  )}
 
-                                  {/* 삭제 버튼 */}
-                                  <button
-                                    onClick={(e) => {
-                                      e.stopPropagation();
-                                      handleDeleteClick("left", item);
-                                    }}
-                                    className="rounded p-1 transition-colors hover:bg-red-100"
-                                    title="삭제"
-                                  >
-                                    <Trash2 className="h-4 w-4 text-red-600" />
-                                  </button>
+                                  {/* 삭제 버튼 (showDelete 활성화 시에만 표시) */}
+                                  {(componentConfig.leftPanel?.showDelete !== false) && (
+                                    <button
+                                      onClick={(e) => {
+                                        e.stopPropagation();
+                                        handleDeleteClick("left", item);
+                                      }}
+                                      className="rounded p-1 transition-colors hover:bg-red-100"
+                                      title="삭제"
+                                    >
+                                      <Trash2 className="h-4 w-4 text-red-600" />
+                                    </button>
+                                  )}
 
                                   {/* 항목별 추가 버튼 */}
                                   {componentConfig.leftPanel?.showItemAddButton && (

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

@@ -1066,6 +1066,62 @@ const AdditionalTabConfigPanel: React.FC<AdditionalTabConfigPanelProps> = ({
             </div>
           )}
 
+          {/* ===== 10-1. 추가 버튼 설정 ===== */}
+          {tab.showAdd && (
+            <div className="space-y-3 rounded-lg border border-border/50 bg-muted/40 p-3">
+              <h3 className="border-l-2 border-l-primary/40 pl-2 text-xs font-semibold">추가 버튼 설정</h3>
+              <div className="space-y-2">
+                <div className="space-y-1">
+                  <Label className="text-[10px]">추가 모드</Label>
+                  <Select
+                    value={tab.addButton?.mode || "auto"}
+                    onValueChange={(value: "auto" | "modal") => {
+                      updateTab({
+                        addButton: { ...tab.addButton, enabled: true, mode: value },
+                      });
+                    }}
+                  >
+                    <SelectTrigger className="h-7 text-xs">
+                      <SelectValue />
+                    </SelectTrigger>
+                    <SelectContent>
+                      <SelectItem value="auto">자동 (내장 폼)</SelectItem>
+                      <SelectItem value="modal">모달 화면</SelectItem>
+                    </SelectContent>
+                  </Select>
+                </div>
+
+                {tab.addButton?.mode === "modal" && (
+                  <div className="space-y-1">
+                    <Label className="text-[10px]">추가 모달 화면</Label>
+                    <ScreenSelector
+                      value={tab.addButton?.modalScreenId}
+                      onChange={(screenId) => {
+                        updateTab({
+                          addButton: { ...tab.addButton, enabled: true, mode: "modal", modalScreenId: screenId },
+                        });
+                      }}
+                    />
+                  </div>
+                )}
+
+                <div className="space-y-1">
+                  <Label className="text-[10px]">버튼 라벨</Label>
+                  <Input
+                    value={tab.addButton?.buttonLabel || ""}
+                    onChange={(e) => {
+                      updateTab({
+                        addButton: { ...tab.addButton, enabled: true, buttonLabel: e.target.value || undefined },
+                      });
+                    }}
+                    placeholder="추가"
+                    className="h-7 text-xs"
+                  />
+                </div>
+              </div>
+            </div>
+          )}
+
           {/* ===== 11. 삭제 버튼 설정 ===== */}
           {tab.showDelete && (
             <div className="space-y-3 rounded-lg border border-border/50 bg-muted/40 p-3">
@@ -2071,6 +2127,169 @@ export const SplitPanelLayoutConfigPanel: React.FC<SplitPanelLayoutConfigPanelPr
           menuObjid={menuObjid} // 🆕 메뉴 OBJID 전달
         />
       </div>
+
+      {/* 좌측 패널 버튼 설정 */}
+      <div className="space-y-4 rounded-lg border border-border/50 bg-muted/40 p-4">
+        <h3 className="border-l-2 border-l-primary/40 pl-2 text-sm font-semibold">좌측 패널 버튼 설정</h3>
+
+        {/* 버튼 표시 체크박스 */}
+        <div className="grid grid-cols-4 gap-2">
+          <div className="flex items-center gap-1">
+            <Checkbox
+              id="left-showSearch"
+              checked={config.leftPanel?.showSearch ?? false}
+              onCheckedChange={(checked) => updateLeftPanel({ showSearch: !!checked })}
+            />
+            <label htmlFor="left-showSearch" className="text-xs">검색</label>
+          </div>
+          <div className="flex items-center gap-1">
+            <Checkbox
+              id="left-showAdd"
+              checked={config.leftPanel?.showAdd ?? false}
+              onCheckedChange={(checked) => updateLeftPanel({ showAdd: !!checked })}
+            />
+            <label htmlFor="left-showAdd" className="text-xs">추가</label>
+          </div>
+          <div className="flex items-center gap-1">
+            <Checkbox
+              id="left-showEdit"
+              checked={config.leftPanel?.showEdit ?? true}
+              onCheckedChange={(checked) => updateLeftPanel({ showEdit: !!checked })}
+            />
+            <label htmlFor="left-showEdit" className="text-xs">수정</label>
+          </div>
+          <div className="flex items-center gap-1">
+            <Checkbox
+              id="left-showDelete"
+              checked={config.leftPanel?.showDelete ?? true}
+              onCheckedChange={(checked) => updateLeftPanel({ showDelete: !!checked })}
+            />
+            <label htmlFor="left-showDelete" className="text-xs">삭제</label>
+          </div>
+        </div>
+
+        {/* 추가 버튼 상세 설정 */}
+        {config.leftPanel?.showAdd && (
+          <div className="space-y-3 rounded-lg border border-border/50 bg-muted/40 p-3">
+            <h3 className="border-l-2 border-l-primary/40 pl-2 text-xs font-semibold">추가 버튼 설정</h3>
+            <div className="space-y-2">
+              <div className="space-y-1">
+                <Label className="text-[10px]">추가 모드</Label>
+                <Select
+                  value={config.leftPanel?.addButton?.mode || "auto"}
+                  onValueChange={(value: "auto" | "modal") =>
+                    updateLeftPanel({
+                      addButton: { ...config.leftPanel?.addButton, enabled: true, mode: value },
+                    })
+                  }
+                >
+                  <SelectTrigger className="h-7 text-xs">
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    <SelectItem value="auto">자동 (내장 폼)</SelectItem>
+                    <SelectItem value="modal">모달 화면</SelectItem>
+                  </SelectContent>
+                </Select>
+              </div>
+
+              {config.leftPanel?.addButton?.mode === "modal" && (
+                <div className="space-y-1">
+                  <Label className="text-[10px]">추가 모달 화면</Label>
+                  <ScreenSelector
+                    value={config.leftPanel?.addButton?.modalScreenId}
+                    onChange={(screenId) =>
+                      updateLeftPanel({
+                        addButton: { ...config.leftPanel?.addButton, enabled: true, mode: "modal", modalScreenId: screenId },
+                      })
+                    }
+                  />
+                </div>
+              )}
+
+              <div className="space-y-1">
+                <Label className="text-[10px]">버튼 라벨</Label>
+                <Input
+                  value={config.leftPanel?.addButton?.buttonLabel || ""}
+                  onChange={(e) =>
+                    updateLeftPanel({
+                      addButton: {
+                        ...config.leftPanel?.addButton,
+                        enabled: true,
+                        mode: config.leftPanel?.addButton?.mode || "auto",
+                        buttonLabel: e.target.value || undefined,
+                      },
+                    })
+                  }
+                  placeholder="추가"
+                  className="h-7 text-xs"
+                />
+              </div>
+            </div>
+          </div>
+        )}
+
+        {/* 수정 버튼 상세 설정 */}
+        {(config.leftPanel?.showEdit ?? true) && (
+          <div className="space-y-3 rounded-lg border border-border/50 bg-muted/40 p-3">
+            <h3 className="border-l-2 border-l-primary/40 pl-2 text-xs font-semibold">수정 버튼 설정</h3>
+            <div className="space-y-2">
+              <div className="space-y-1">
+                <Label className="text-[10px]">수정 모드</Label>
+                <Select
+                  value={config.leftPanel?.editButton?.mode || "auto"}
+                  onValueChange={(value: "auto" | "modal") =>
+                    updateLeftPanel({
+                      editButton: { ...config.leftPanel?.editButton, enabled: true, mode: value },
+                    })
+                  }
+                >
+                  <SelectTrigger className="h-7 text-xs">
+                    <SelectValue />
+                  </SelectTrigger>
+                  <SelectContent>
+                    <SelectItem value="auto">자동 (인라인)</SelectItem>
+                    <SelectItem value="modal">모달 화면</SelectItem>
+                  </SelectContent>
+                </Select>
+              </div>
+
+              {config.leftPanel?.editButton?.mode === "modal" && (
+                <div className="space-y-1">
+                  <Label className="text-[10px]">수정 모달 화면</Label>
+                  <ScreenSelector
+                    value={config.leftPanel?.editButton?.modalScreenId}
+                    onChange={(screenId) =>
+                      updateLeftPanel({
+                        editButton: { ...config.leftPanel?.editButton, enabled: true, mode: "modal", modalScreenId: screenId },
+                      })
+                    }
+                  />
+                </div>
+              )}
+
+              <div className="space-y-1">
+                <Label className="text-[10px]">버튼 라벨</Label>
+                <Input
+                  value={config.leftPanel?.editButton?.buttonLabel || ""}
+                  onChange={(e) =>
+                    updateLeftPanel({
+                      editButton: {
+                        ...config.leftPanel?.editButton,
+                        enabled: true,
+                        mode: config.leftPanel?.editButton?.mode || "auto",
+                        buttonLabel: e.target.value || undefined,
+                      },
+                    })
+                  }
+                  placeholder="수정"
+                  className="h-7 text-xs"
+                />
+              </div>
+            </div>
+          </div>
+        )}
+      </div>
           </div>
         </DialogContent>
       </Dialog>
@@ -2775,6 +2994,85 @@ export const SplitPanelLayoutConfigPanel: React.FC<SplitPanelLayoutConfigPanelPr
         )}
       </div>
 
+      {/* 🆕 우측 패널 추가 버튼 설정 */}
+      {config.rightPanel?.showAdd && (
+        <div className="space-y-3 rounded-lg border border-border/50 bg-muted/40 p-4">
+          <div className="flex items-center justify-between">
+            <div>
+              <h3 className="border-l-2 border-l-primary/40 pl-2 text-sm font-semibold">추가 버튼 설정</h3>
+              <p className="text-muted-foreground text-xs">우측 리스트의 추가 버튼 동작 방식 설정</p>
+            </div>
+          </div>
+
+          <div className="space-y-3 border-l-2 pl-4">
+            <div>
+              <Label className="text-xs">추가 모드</Label>
+              <Select
+                value={config.rightPanel?.addButton?.mode || "auto"}
+                onValueChange={(value: "auto" | "modal") =>
+                  updateRightPanel({
+                    addButton: {
+                      ...config.rightPanel?.addButton,
+                      mode: value,
+                      enabled: true,
+                    },
+                  })
+                }
+              >
+                <SelectTrigger className="h-8 text-xs">
+                  <SelectValue />
+                </SelectTrigger>
+                <SelectContent>
+                  <SelectItem value="auto">자동 (내장 폼)</SelectItem>
+                  <SelectItem value="modal">모달 화면</SelectItem>
+                </SelectContent>
+              </Select>
+              <p className="text-muted-foreground mt-1 text-[10px]">
+                {config.rightPanel?.addButton?.mode === "modal"
+                  ? "지정한 화면을 모달로 열어 데이터를 추가합니다"
+                  : "내장 폼으로 데이터를 추가합니다"}
+              </p>
+            </div>
+
+            {config.rightPanel?.addButton?.mode === "modal" && (
+              <div>
+                <Label className="text-xs">모달 화면</Label>
+                <ScreenSelector
+                  value={config.rightPanel?.addButton?.modalScreenId}
+                  onChange={(screenId) =>
+                    updateRightPanel({
+                      addButton: {
+                        ...config.rightPanel?.addButton!,
+                        modalScreenId: screenId,
+                      },
+                    })
+                  }
+                />
+              </div>
+            )}
+
+            <div>
+              <Label className="text-xs">버튼 라벨</Label>
+              <Input
+                value={config.rightPanel?.addButton?.buttonLabel || "추가"}
+                onChange={(e) =>
+                  updateRightPanel({
+                    addButton: {
+                      ...config.rightPanel?.addButton!,
+                      buttonLabel: e.target.value,
+                      enabled: true,
+                      mode: config.rightPanel?.addButton?.mode || "auto",
+                    },
+                  })
+                }
+                placeholder="추가"
+                className="h-8 text-xs"
+              />
+            </div>
+          </div>
+        </div>
+      )}
+
       {/* 🆕 우측 패널 삭제 버튼 설정 */}
       <div className="space-y-3 rounded-lg border border-border/50 bg-muted/40 p-4">
         <div className="flex items-center justify-between">

frontend/lib/registry/components/v2-split-panel-layout/types.ts

@@ -115,6 +115,14 @@ export interface AdditionalTabConfig {
     groupByColumns?: string[];
   };
 
+  // 추가 버튼 설정 (모달 화면 연결 지원)
+  addButton?: {
+    enabled: boolean;
+    mode: "auto" | "modal"; // auto: 내장 폼, modal: 커스텀 모달 화면
+    modalScreenId?: number; // 모달로 열 화면 ID (mode: "modal"일 때)
+    buttonLabel?: string; // 버튼 라벨 (기본: "추가")
+  };
+
   deleteButton?: {
     enabled: boolean;
     buttonLabel?: string;
@@ -141,6 +149,23 @@ export interface SplitPanelLayoutConfig {
     showAdd?: boolean;
     showEdit?: boolean; // 수정 버튼
     showDelete?: boolean; // 삭제 버튼
+
+    // 수정 버튼 설정 (모달 화면 연결 지원)
+    editButton?: {
+      enabled: boolean;
+      mode: "auto" | "modal"; // auto: 내장 편집, modal: 커스텀 모달 화면
+      modalScreenId?: number; // 모달로 열 화면 ID (mode: "modal"일 때)
+      buttonLabel?: string; // 버튼 라벨 (기본: "수정")
+    };
+
+    // 추가 버튼 설정 (모달 화면 연결 지원)
+    addButton?: {
+      enabled: boolean;
+      mode: "auto" | "modal"; // auto: 내장 폼, modal: 커스텀 모달 화면
+      modalScreenId?: number; // 모달로 열 화면 ID (mode: "modal"일 때)
+      buttonLabel?: string; // 버튼 라벨 (기본: "추가")
+    };
+
     columns?: Array<{
       name: string;
       label: string;
@@ -307,6 +332,14 @@ export interface SplitPanelLayoutConfig {
       groupByColumns?: string[]; // 🆕 그룹핑 기준 컬럼들 (예: ["customer_id", "item_id"])
     };
 
+    // 🆕 추가 버튼 설정 (모달 화면 연결 지원)
+    addButton?: {
+      enabled: boolean; // 추가 버튼 표시 여부 (기본: true)
+      mode: "auto" | "modal"; // auto: 내장 폼, modal: 커스텀 모달 화면
+      modalScreenId?: number; // 모달로 열 화면 ID (mode: "modal"일 때)
+      buttonLabel?: string; // 버튼 라벨 (기본: "추가")
+    };
+
     // 🆕 삭제 버튼 설정
     deleteButton?: {
       enabled: boolean; // 삭제 버튼 표시 여부 (기본: true)