From 71aaef7acb1ff41f36570795cc9d7cc4107cf1f9 Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 14:19:08 +0900
Subject: [PATCH 01/10] =?UTF-8?q?=EB=A9=94=EB=89=B4=20=EA=B4=80=EB=A6=AC?=
 =?UTF-8?q?=EC=97=90=20=EB=8C=80=EC=8B=9C=EB=B3=B4=EB=93=9C=20=ED=95=A0?=
 =?UTF-8?q?=EB=8B=B9=20=EA=B8=B0=EB=8A=A5=20=EC=B6=94=EA=B0=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend/components/admin/MenuFormModal.tsx | 287 ++++++++++++++------
 1 file changed, 211 insertions(+), 76 deletions(-)

diff --git a/frontend/components/admin/MenuFormModal.tsx b/frontend/components/admin/MenuFormModal.tsx
index f8d80592..ad9edfc4 100644
--- a/frontend/components/admin/MenuFormModal.tsx
+++ b/frontend/components/admin/MenuFormModal.tsx
@@ -47,12 +47,12 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
   uiTexts,
 }) => {
   // console.log("🎯 MenuFormModal 렌더링 - Props:", {
-    // isOpen,
-    // menuId,
-    // parentId,
-    // menuType,
-    // level,
-    // parentCompanyCode,
+  // isOpen,
+  // menuId,
+  // parentId,
+  // menuType,
+  // level,
+  // parentCompanyCode,
   // });
 
   // 다국어 텍스트 가져오기 함수
@@ -75,12 +75,18 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
   });
 
   // 화면 할당 관련 상태
-  const [urlType, setUrlType] = useState<"direct" | "screen">("screen"); // URL 직접 입력 or 화면 할당 (기본값: 화면 할당)
+  const [urlType, setUrlType] = useState<"direct" | "screen" | "dashboard">("screen"); // URL 직접 입력 or 화면 할당 or 대시보드 할당 (기본값: 화면 할당)
   const [selectedScreen, setSelectedScreen] = useState<ScreenDefinition | null>(null);
   const [screens, setScreens] = useState<ScreenDefinition[]>([]);
   const [screenSearchText, setScreenSearchText] = useState("");
   const [isScreenDropdownOpen, setIsScreenDropdownOpen] = useState(false);
 
+  // 대시보드 할당 관련 상태
+  const [selectedDashboard, setSelectedDashboard] = useState<any | null>(null);
+  const [dashboards, setDashboards] = useState<any[]>([]);
+  const [dashboardSearchText, setDashboardSearchText] = useState("");
+  const [isDashboardDropdownOpen, setIsDashboardDropdownOpen] = useState(false);
+
   const [loading, setLoading] = useState(false);
   const [isEdit, setIsEdit] = useState(false);
   const [companies, setCompanies] = useState<Company[]>([]);
@@ -93,21 +99,6 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
     try {
       const response = await screenApi.getScreens({ size: 1000 }); // 모든 화면 가져오기
 
-      // console.log("🔍 화면 목록 로드 디버깅:", {
-        // totalScreens: response.data.length,
-        // firstScreen: response.data[0],
-        // firstScreenFields: response.data[0] ? Object.keys(response.data[0]) : [],
-        // firstScreenValues: response.data[0] ? Object.values(response.data[0]) : [],
-        // allScreenIds: response.data
-          // .map((s) => ({
-            // screenId: s.screenId,
-            // legacyId: s.id,
-            // name: s.screenName,
-            // code: s.screenCode,
-          // }))
-          // .slice(0, 5), // 처음 5개만 출력
-      // });
-
       setScreens(response.data);
       console.log("✅ 화면 목록 로드 완료:", response.data.length);
     } catch (error) {
@@ -116,15 +107,28 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
     }
   };
 
+  // 대시보드 목록 로드
+  const loadDashboards = async () => {
+    try {
+      const { dashboardApi } = await import("@/lib/api/dashboard");
+      const response = await dashboardApi.getMyDashboards();
+      setDashboards(response.dashboards || []);
+      console.log("✅ 대시보드 목록 로드 완료:", response.dashboards?.length || 0);
+    } catch (error) {
+      console.error("❌ 대시보드 목록 로드 실패:", error);
+      toast.error("대시보드 목록을 불러오는데 실패했습니다.");
+    }
+  };
+
   // 화면 선택 시 URL 자동 설정
   const handleScreenSelect = (screen: ScreenDefinition) => {
     // console.log("🖥️ 화면 선택 디버깅:", {
-      // screen,
-      // screenId: screen.screenId,
-      // screenIdType: typeof screen.screenId,
-      // legacyId: screen.id,
-      // allFields: Object.keys(screen),
-      // screenValues: Object.values(screen),
+    // screen,
+    // screenId: screen.screenId,
+    // screenIdType: typeof screen.screenId,
+    // legacyId: screen.id,
+    // allFields: Object.keys(screen),
+    // screenValues: Object.values(screen),
     // });
 
     // ScreenDefinition에서는 screenId 필드를 사용
@@ -155,24 +159,42 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
     }));
 
     // console.log("🖥️ 화면 선택 완료:", {
-      // screenId: screen.screenId,
-      // legacyId: screen.id,
-      // actualScreenId,
-      // screenName: screen.screenName,
-      // menuType: menuType,
-      // formDataMenuType: formData.menuType,
-      // isAdminMenu,
-      // generatedUrl: screenUrl,
+    // screenId: screen.screenId,
+    // legacyId: screen.id,
+    // actualScreenId,
+    // screenName: screen.screenName,
+    // menuType: menuType,
+    // formDataMenuType: formData.menuType,
+    // isAdminMenu,
+    // generatedUrl: screenUrl,
     // });
   };
 
+  // 대시보드 선택 시 URL 자동 설정
+  const handleDashboardSelect = (dashboard: any) => {
+    setSelectedDashboard(dashboard);
+    setIsDashboardDropdownOpen(false);
+
+    // 대시보드 URL 생성
+    let dashboardUrl = `/dashboard/${dashboard.id}`;
+
+    // 현재 메뉴 타입이 관리자인지 확인 (0 또는 "admin")
+    const isAdminMenu = menuType === "0" || menuType === "admin" || formData.menuType === "0";
+    if (isAdminMenu) {
+      dashboardUrl += "?mode=admin";
+    }
+
+    setFormData((prev) => ({ ...prev, menuUrl: dashboardUrl }));
+    toast.success(`대시보드가 선택되었습니다: ${dashboard.title}`);
+  };
+
   // URL 타입 변경 시 처리
-  const handleUrlTypeChange = (type: "direct" | "screen") => {
+  const handleUrlTypeChange = (type: "direct" | "screen" | "dashboard") => {
     // console.log("🔄 URL 타입 변경:", {
-      // from: urlType,
-      // to: type,
-      // currentSelectedScreen: selectedScreen?.screenName,
-      // currentUrl: formData.menuUrl,
+    // from: urlType,
+    // to: type,
+    // currentSelectedScreen: selectedScreen?.screenName,
+    // currentUrl: formData.menuUrl,
     // });
 
     setUrlType(type);
@@ -286,10 +308,10 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
           const screenId = menuUrl.match(/\/screens\/(\d+)/)?.[1];
           if (screenId) {
             // console.log("🔍 기존 메뉴에서 화면 ID 추출:", {
-              // menuUrl,
-              // screenId,
-              // hasAdminParam: menuUrl.includes("mode=admin"),
-              // currentScreensCount: screens.length,
+            // menuUrl,
+            // screenId,
+            // hasAdminParam: menuUrl.includes("mode=admin"),
+            // currentScreensCount: screens.length,
             // });
 
             // 화면 설정 함수
@@ -298,15 +320,15 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
               if (screen) {
                 setSelectedScreen(screen);
                 // console.log("🖥️ 기존 메뉴의 할당된 화면 설정:", {
-                  // screen,
-                  // originalUrl: menuUrl,
-                  // hasAdminParam: menuUrl.includes("mode=admin"),
+                // screen,
+                // originalUrl: menuUrl,
+                // hasAdminParam: menuUrl.includes("mode=admin"),
                 // });
                 return true;
               } else {
                 // console.warn("⚠️ 해당 ID의 화면을 찾을 수 없음:", {
-                  // screenId,
-                  // availableScreens: screens.map((s) => ({ screenId: s.screenId, id: s.id, name: s.screenName })),
+                // screenId,
+                // availableScreens: screens.map((s) => ({ screenId: s.screenId, id: s.id, name: s.screenName })),
                 // });
                 return false;
               }
@@ -325,30 +347,34 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
               }, 500);
             }
           }
+        } else if (menuUrl.startsWith("/dashboard/")) {
+          setUrlType("dashboard");
+          setSelectedScreen(null);
+          // 대시보드 ID 추출 및 선택은 useEffect에서 처리됨
         } else {
           setUrlType("direct");
           setSelectedScreen(null);
         }
 
         // console.log("설정된 폼 데이터:", {
-          // objid: menu.objid || menu.OBJID,
-          // parentObjId: menu.parent_obj_id || menu.PARENT_OBJ_ID || "0",
-          // menuNameKor: menu.menu_name_kor || menu.MENU_NAME_KOR || "",
-          // menuUrl: menu.menu_url || menu.MENU_URL || "",
-          // menuDesc: menu.menu_desc || menu.MENU_DESC || "",
-          // seq: menu.seq || menu.SEQ || 1,
-          // menuType: convertedMenuType,
-          // status: convertedStatus,
-          // companyCode: companyCode,
-          // langKey: langKey,
+        // objid: menu.objid || menu.OBJID,
+        // parentObjId: menu.parent_obj_id || menu.PARENT_OBJ_ID || "0",
+        // menuNameKor: menu.menu_name_kor || menu.MENU_NAME_KOR || "",
+        // menuUrl: menu.menu_url || menu.MENU_URL || "",
+        // menuDesc: menu.menu_desc || menu.MENU_DESC || "",
+        // seq: menu.seq || menu.SEQ || 1,
+        // menuType: convertedMenuType,
+        // status: convertedStatus,
+        // companyCode: companyCode,
+        // langKey: langKey,
         // });
       }
     } catch (error: any) {
       console.error("메뉴 정보 로딩 오류:", error);
       // console.error("오류 상세 정보:", {
-        // message: error?.message,
-        // stack: error?.stack,
-        // response: error?.response,
+      // message: error?.message,
+      // stack: error?.stack,
+      // response: error?.response,
       // });
       toast.error(getText(MENU_MANAGEMENT_KEYS.MESSAGE_ERROR_LOAD_MENU_INFO));
     } finally {
@@ -391,11 +417,11 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
       });
 
       // console.log("메뉴 등록 기본값 설정:", {
-        // parentObjId: parentId || "0",
-        // menuType: defaultMenuType,
-        // status: "ACTIVE",
-        // companyCode: "",
-        // langKey: "",
+      // parentObjId: parentId || "0",
+      // menuType: defaultMenuType,
+      // status: "ACTIVE",
+      // companyCode: "",
+      // langKey: "",
       // });
     }
   }, [menuId, parentId, menuType]);
@@ -430,10 +456,11 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
     }
   }, [isOpen, formData.companyCode]);
 
-  // 화면 목록 로드
+  // 화면 목록 및 대시보드 목록 로드
   useEffect(() => {
     if (isOpen) {
       loadScreens();
+      loadDashboards();
     }
   }, [isOpen]);
 
@@ -449,9 +476,9 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
           if (screen) {
             setSelectedScreen(screen);
             // console.log("✅ 기존 메뉴의 할당된 화면 자동 설정 완료:", {
-              // screenId,
-              // screenName: screen.screenName,
-              // menuUrl,
+            // screenId,
+            // screenName: screen.screenName,
+            // menuUrl,
             // });
           }
         }
@@ -459,6 +486,23 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
     }
   }, [screens, isEdit, formData.menuUrl, urlType, selectedScreen]);
 
+  // 대시보드 목록 로드 완료 후 기존 메뉴의 할당된 대시보드 설정
+  useEffect(() => {
+    if (dashboards.length > 0 && isEdit && formData.menuUrl && urlType === "dashboard") {
+      const menuUrl = formData.menuUrl;
+      if (menuUrl.startsWith("/dashboard/")) {
+        const dashboardId = menuUrl.replace("/dashboard/", "");
+        if (dashboardId && !selectedDashboard) {
+          console.log("🔄 대시보드 목록 로드 완료 - 기존 할당 대시보드 자동 설정");
+          const dashboard = dashboards.find((d) => d.id === dashboardId);
+          if (dashboard) {
+            setSelectedDashboard(dashboard);
+          }
+        }
+      }
+    }
+  }, [dashboards, isEdit, formData.menuUrl, urlType, selectedDashboard]);
+
   // 드롭다운 외부 클릭 시 닫기
   useEffect(() => {
     const handleClickOutside = (event: MouseEvent) => {
@@ -471,9 +515,13 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
         setIsScreenDropdownOpen(false);
         setScreenSearchText("");
       }
+      if (!target.closest(".dashboard-dropdown")) {
+        setIsDashboardDropdownOpen(false);
+        setDashboardSearchText("");
+      }
     };
 
-    if (isLangKeyDropdownOpen || isScreenDropdownOpen) {
+    if (isLangKeyDropdownOpen || isScreenDropdownOpen || isDashboardDropdownOpen) {
       document.addEventListener("mousedown", handleClickOutside);
     }
 
@@ -751,6 +799,12 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
                   화면 할당
                 </Label>
               </div>
+              <div className="flex items-center space-x-2">
+                <RadioGroupItem value="dashboard" id="dashboard" />
+                <Label htmlFor="dashboard" className="cursor-pointer">
+                  대시보드 할당
+                </Label>
+              </div>
               <div className="flex items-center space-x-2">
                 <RadioGroupItem value="direct" id="direct" />
                 <Label htmlFor="direct" className="cursor-pointer">
@@ -826,10 +880,91 @@ export const MenuFormModal: React.FC<MenuFormModalProps> = ({
 
                 {/* 선택된 화면 정보 표시 */}
                 {selectedScreen && (
-                  <div className="rounded-md border bg-accent p-3">
+                  <div className="bg-accent rounded-md border p-3">
                     <div className="text-sm font-medium text-blue-900">{selectedScreen.screenName}</div>
-                    <div className="text-xs text-primary">코드: {selectedScreen.screenCode}</div>
-                    <div className="text-xs text-primary">생성된 URL: {formData.menuUrl}</div>
+                    <div className="text-primary text-xs">코드: {selectedScreen.screenCode}</div>
+                    <div className="text-primary text-xs">생성된 URL: {formData.menuUrl}</div>
+                  </div>
+                )}
+              </div>
+            )}
+
+            {/* 대시보드 할당 */}
+            {urlType === "dashboard" && (
+              <div className="space-y-2">
+                {/* 대시보드 선택 드롭다운 */}
+                <div className="relative">
+                  <Button
+                    type="button"
+                    variant="outline"
+                    className="w-full justify-between"
+                    onClick={() => setIsDashboardDropdownOpen(!isDashboardDropdownOpen)}
+                  >
+                    <span className="truncate">{selectedDashboard ? selectedDashboard.title : "대시보드 선택"}</span>
+                    <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
+                  </Button>
+
+                  {/* 드롭다운 메뉴 */}
+                  {isDashboardDropdownOpen && (
+                    <div className="dashboard-dropdown absolute z-50 mt-1 max-h-60 w-full overflow-hidden rounded-md border bg-white shadow-lg">
+                      {/* 검색창 */}
+                      <div className="border-b p-2">
+                        <div className="relative">
+                          <Search className="absolute top-2.5 left-2 h-4 w-4 text-gray-400" />
+                          <Input
+                            type="text"
+                            placeholder="대시보드 검색..."
+                            value={dashboardSearchText}
+                            onChange={(e) => setDashboardSearchText(e.target.value)}
+                            className="pl-8"
+                          />
+                        </div>
+                      </div>
+
+                      {/* 대시보드 목록 */}
+                      <div className="max-h-48 overflow-y-auto">
+                        {dashboards
+                          .filter(
+                            (dashboard) =>
+                              dashboard.title.toLowerCase().includes(dashboardSearchText.toLowerCase()) ||
+                              (dashboard.description &&
+                                dashboard.description.toLowerCase().includes(dashboardSearchText.toLowerCase())),
+                          )
+                          .map((dashboard) => (
+                            <div
+                              key={dashboard.id}
+                              onClick={() => handleDashboardSelect(dashboard)}
+                              className="cursor-pointer border-b px-3 py-2 last:border-b-0 hover:bg-gray-100"
+                            >
+                              <div className="flex items-center justify-between">
+                                <div>
+                                  <div className="text-sm font-medium">{dashboard.title}</div>
+                                  {dashboard.description && (
+                                    <div className="text-xs text-gray-500">{dashboard.description}</div>
+                                  )}
+                                </div>
+                              </div>
+                            </div>
+                          ))}
+                        {dashboards.filter(
+                          (dashboard) =>
+                            dashboard.title.toLowerCase().includes(dashboardSearchText.toLowerCase()) ||
+                            (dashboard.description &&
+                              dashboard.description.toLowerCase().includes(dashboardSearchText.toLowerCase())),
+                        ).length === 0 && <div className="px-3 py-2 text-sm text-gray-500">검색 결과가 없습니다.</div>}
+                      </div>
+                    </div>
+                  )}
+                </div>
+
+                {/* 선택된 대시보드 정보 표시 */}
+                {selectedDashboard && (
+                  <div className="bg-accent rounded-md border p-3">
+                    <div className="text-sm font-medium text-blue-900">{selectedDashboard.title}</div>
+                    {selectedDashboard.description && (
+                      <div className="text-primary text-xs">설명: {selectedDashboard.description}</div>
+                    )}
+                    <div className="text-primary text-xs">생성된 URL: {formData.menuUrl}</div>
                   </div>
                 )}
               </div>

From 062efac47f4c625f426df47e7452e3e9f478d802 Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 14:53:06 +0900
Subject: [PATCH 02/10] =?UTF-8?q?=EB=8C=80=EC=8B=9C=EB=B3=B4=EB=93=9C?=
 =?UTF-8?q?=EC=97=90=20=ED=99=94=EB=A9=B4=20=ED=95=A0=EB=8B=B9=20(?=
 =?UTF-8?q?=EC=A4=91=EA=B0=84)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../admin/dashboard/DashboardDesigner.tsx     |  98 +++++++-
 .../admin/dashboard/MenuAssignmentModal.tsx   | 210 ++++++++++++++++++
 2 files changed, 299 insertions(+), 9 deletions(-)
 create mode 100644 frontend/components/admin/dashboard/MenuAssignmentModal.tsx

diff --git a/frontend/components/admin/dashboard/DashboardDesigner.tsx b/frontend/components/admin/dashboard/DashboardDesigner.tsx
index 048e5172..0c41ff7c 100644
--- a/frontend/components/admin/dashboard/DashboardDesigner.tsx
+++ b/frontend/components/admin/dashboard/DashboardDesigner.tsx
@@ -6,6 +6,7 @@ import { DashboardCanvas } from "./DashboardCanvas";
 import { DashboardTopMenu } from "./DashboardTopMenu";
 import { ElementConfigModal } from "./ElementConfigModal";
 import { ListWidgetConfigModal } from "./widgets/ListWidgetConfigModal";
+import { MenuAssignmentModal } from "./MenuAssignmentModal";
 import { DashboardElement, ElementType, ElementSubtype } from "./types";
 import { GRID_CONFIG, snapToGrid, snapSizeToGrid, calculateCellSize } from "./gridUtils";
 import { Resolution, RESOLUTIONS, detectScreenResolution } from "./ResolutionSelector";
@@ -33,6 +34,10 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
   const [canvasBackgroundColor, setCanvasBackgroundColor] = useState<string>("#f9fafb");
   const canvasRef = useRef<HTMLDivElement>(null);
 
+  // 메뉴 할당 모달 상태
+  const [menuAssignmentModalOpen, setMenuAssignmentModalOpen] = useState(false);
+  const [savedDashboardInfo, setSavedDashboardInfo] = useState<{ id: string; title: string } | null>(null);
+
   // 화면 해상도 자동 감지
   const [screenResolution] = useState<Resolution>(() => detectScreenResolution());
   const [resolution, setResolution] = useState<Resolution>(screenResolution);
@@ -348,10 +353,12 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
         console.log("✅ 저장된 대시보드:", savedDashboard);
         console.log("✅ 저장된 settings:", (savedDashboard as any).settings);
 
-        alert(`대시보드 "${savedDashboard.title}"이 업데이트되었습니다!`);
-
-        // Next.js 라우터로 뷰어 페이지 이동
-        router.push(`/dashboard/${savedDashboard.id}`);
+        // 메뉴 할당 모달 띄우기 (기존 대시보드 업데이트 시에도)
+        setSavedDashboardInfo({
+          id: savedDashboard.id,
+          title: savedDashboard.title,
+        });
+        setMenuAssignmentModalOpen(true);
       } else {
         // 새 대시보드 생성
         const title = prompt("대시보드 제목을 입력하세요:", "새 대시보드");
@@ -372,11 +379,16 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
 
         savedDashboard = await dashboardApi.createDashboard(dashboardData);
 
-        const viewDashboard = confirm(`대시보드 "${title}"이 저장되었습니다!\n\n지금 확인해보시겠습니까?`);
-        if (viewDashboard) {
-          // Next.js 라우터로 뷰어 페이지 이동
-          router.push(`/dashboard/${savedDashboard.id}`);
-        }
+        // 대시보드 ID 설정 (다음 저장 시 업데이트 모드로 전환)
+        setDashboardId(savedDashboard.id);
+        setDashboardTitle(savedDashboard.title);
+
+        // 메뉴 할당 모달 띄우기
+        setSavedDashboardInfo({
+          id: savedDashboard.id,
+          title: savedDashboard.title,
+        });
+        setMenuAssignmentModalOpen(true);
       }
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : "알 수 없는 오류";
@@ -384,6 +396,58 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
     }
   }, [elements, dashboardId, router, resolution, canvasBackgroundColor]);
 
+  // 메뉴 할당 처리
+  const handleMenuAssignment = useCallback(
+    async (assignToMenu: boolean, menuId?: string, menuType?: "0" | "1") => {
+      if (!savedDashboardInfo) return;
+
+      try {
+        if (assignToMenu && menuId) {
+          // 메뉴 API를 통해 대시보드 URL 할당
+          const { menuApi } = await import("@/lib/api/menu");
+
+          // 대시보드 URL 생성 (관리자 메뉴면 mode=admin 추가)
+          let dashboardUrl = `/dashboard/${savedDashboardInfo.id}`;
+          if (menuType === "0") {
+            dashboardUrl += "?mode=admin";
+          }
+
+          // 메뉴 정보 가져오기
+          const menuResponse = await menuApi.getMenuInfo(menuId);
+          if (menuResponse.success && menuResponse.data) {
+            const menu = menuResponse.data;
+
+            // 메뉴 URL 업데이트
+            await menuApi.updateMenu(menuId, {
+              menuUrl: dashboardUrl,
+              parentObjId: menu.parent_obj_id || menu.PARENT_OBJ_ID || "0",
+              menuNameKor: menu.menu_name_kor || menu.MENU_NAME_KOR || "",
+              menuDesc: menu.menu_desc || menu.MENU_DESC || "",
+              seq: menu.seq || menu.SEQ || 1,
+              menuType: menu.menu_type || menu.MENU_TYPE || "1",
+              status: menu.status || menu.STATUS || "active",
+              companyCode: menu.company_code || menu.COMPANY_CODE || "",
+              langKey: menu.lang_key || menu.LANG_KEY || "",
+            });
+
+            alert(`메뉴 "${menu.menu_name_kor || menu.MENU_NAME_KOR}"에 대시보드가 할당되었습니다!`);
+          }
+        }
+
+        // 모달 닫기
+        setMenuAssignmentModalOpen(false);
+        setSavedDashboardInfo(null);
+
+        // 대시보드 뷰어로 이동
+        router.push(`/dashboard/${savedDashboardInfo.id}`);
+      } catch (error) {
+        console.error("메뉴 할당 오류:", error);
+        alert("메뉴 할당 중 오류가 발생했습니다.");
+      }
+    },
+    [savedDashboardInfo, router],
+  );
+
   // 로딩 중이면 로딩 화면 표시
   if (isLoading) {
     return (
@@ -458,6 +522,22 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
           )}
         </>
       )}
+
+      {/* 메뉴 할당 모달 */}
+      {savedDashboardInfo && (
+        <MenuAssignmentModal
+          isOpen={menuAssignmentModalOpen}
+          onClose={() => {
+            setMenuAssignmentModalOpen(false);
+            setSavedDashboardInfo(null);
+            // 모달을 그냥 닫으면 대시보드 뷰어로 이동
+            router.push(`/dashboard/${savedDashboardInfo.id}`);
+          }}
+          onConfirm={handleMenuAssignment}
+          dashboardId={savedDashboardInfo.id}
+          dashboardTitle={savedDashboardInfo.title}
+        />
+      )}
     </div>
   );
 }
diff --git a/frontend/components/admin/dashboard/MenuAssignmentModal.tsx b/frontend/components/admin/dashboard/MenuAssignmentModal.tsx
new file mode 100644
index 00000000..9220a0c8
--- /dev/null
+++ b/frontend/components/admin/dashboard/MenuAssignmentModal.tsx
@@ -0,0 +1,210 @@
+"use client";
+
+import React, { useState, useEffect } from "react";
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from "@/components/ui/dialog";
+import { Button } from "@/components/ui/button";
+import { Label } from "@/components/ui/label";
+import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select";
+import { toast } from "sonner";
+import { menuApi, MenuItem } from "@/lib/api/menu";
+import { Loader2 } from "lucide-react";
+
+interface MenuAssignmentModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  onConfirm: (assignToMenu: boolean, menuId?: string, menuType?: "0" | "1") => void;
+  dashboardId: string;
+  dashboardTitle: string;
+}
+
+export const MenuAssignmentModal: React.FC<MenuAssignmentModalProps> = ({
+  isOpen,
+  onClose,
+  onConfirm,
+  dashboardId,
+  dashboardTitle,
+}) => {
+  const [assignToMenu, setAssignToMenu] = useState<boolean>(false);
+  const [selectedMenuId, setSelectedMenuId] = useState<string>("");
+  const [selectedMenuType, setSelectedMenuType] = useState<"0" | "1">("0");
+  const [adminMenus, setAdminMenus] = useState<MenuItem[]>([]);
+  const [userMenus, setUserMenus] = useState<MenuItem[]>([]);
+  const [loading, setLoading] = useState(false);
+
+  // 메뉴 목록 로드
+  useEffect(() => {
+    if (isOpen && assignToMenu) {
+      loadMenus();
+    }
+  }, [isOpen, assignToMenu]);
+
+  const loadMenus = async () => {
+    try {
+      setLoading(true);
+      const [adminResponse, userResponse] = await Promise.all([
+        menuApi.getAdminMenus(), // 관리자 메뉴
+        menuApi.getUserMenus(), // 사용자 메뉴
+      ]);
+
+      if (adminResponse.success) {
+        setAdminMenus(adminResponse.data || []);
+      }
+      if (userResponse.success) {
+        setUserMenus(userResponse.data || []);
+      }
+    } catch (error) {
+      console.error("메뉴 목록 로드 실패:", error);
+      toast.error("메뉴 목록을 불러오는데 실패했습니다.");
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  // 메뉴 트리를 평탄화하여 Select 옵션으로 변환
+  const flattenMenus = (menus: MenuItem[], level: number = 0): Array<{ id: string; name: string; level: number }> => {
+    const result: Array<{ id: string; name: string; level: number }> = [];
+
+    menus.forEach((menu) => {
+      const menuId = menu.objid || menu.OBJID || "";
+      const menuName = menu.menu_name_kor || menu.MENU_NAME_KOR || "";
+      const parentId = menu.parent_obj_id || menu.PARENT_OBJ_ID || "0";
+
+      // 메뉴 이름이 있고, 최상위가 아닌 경우에만 추가
+      if (menuName && parentId !== "0") {
+        result.push({
+          id: menuId,
+          name: "  ".repeat(level) + menuName,
+          level,
+        });
+
+        // 하위 메뉴가 있으면 재귀 호출
+        const children = menus.filter((m) => (m.parent_obj_id || m.PARENT_OBJ_ID) === menuId);
+        if (children.length > 0) {
+          result.push(...flattenMenus(children, level + 1));
+        }
+      }
+    });
+
+    return result;
+  };
+
+  const currentMenus = selectedMenuType === "0" ? adminMenus : userMenus;
+  const flatMenus = flattenMenus(currentMenus);
+
+  const handleConfirm = () => {
+    if (assignToMenu && !selectedMenuId) {
+      toast.error("메뉴를 선택해주세요.");
+      return;
+    }
+
+    onConfirm(assignToMenu, selectedMenuId, selectedMenuType);
+  };
+
+  const handleClose = () => {
+    setAssignToMenu(false);
+    setSelectedMenuId("");
+    setSelectedMenuType("0");
+    onClose();
+  };
+
+  return (
+    <Dialog open={isOpen} onOpenChange={handleClose}>
+      <DialogContent className="sm:max-w-[500px]">
+        <DialogHeader>
+          <DialogTitle>대시보드 저장 완료</DialogTitle>
+          <DialogDescription>'{dashboardTitle}' 대시보드가 저장되었습니다.</DialogDescription>
+        </DialogHeader>
+
+        <div className="space-y-4 py-4">
+          <div className="space-y-3">
+            <Label>이 대시보드를 메뉴에 할당하시겠습니까?</Label>
+            <RadioGroup
+              value={assignToMenu ? "yes" : "no"}
+              onValueChange={(value) => setAssignToMenu(value === "yes")}
+              className="flex space-x-4"
+            >
+              <div className="flex items-center space-x-2">
+                <RadioGroupItem value="yes" id="yes" />
+                <Label htmlFor="yes" className="cursor-pointer font-normal">
+                  예, 메뉴에 할당
+                </Label>
+              </div>
+              <div className="flex items-center space-x-2">
+                <RadioGroupItem value="no" id="no" />
+                <Label htmlFor="no" className="cursor-pointer font-normal">
+                  아니오, 나중에
+                </Label>
+              </div>
+            </RadioGroup>
+          </div>
+
+          {assignToMenu && (
+            <>
+              <div className="space-y-2">
+                <Label>메뉴 타입</Label>
+                <RadioGroup
+                  value={selectedMenuType}
+                  onValueChange={(value) => {
+                    setSelectedMenuType(value as "0" | "1");
+                    setSelectedMenuId(""); // 메뉴 타입 변경 시 선택 초기화
+                  }}
+                  className="flex space-x-4"
+                >
+                  <div className="flex items-center space-x-2">
+                    <RadioGroupItem value="0" id="admin" />
+                    <Label htmlFor="admin" className="cursor-pointer font-normal">
+                      관리자 메뉴
+                    </Label>
+                  </div>
+                  <div className="flex items-center space-x-2">
+                    <RadioGroupItem value="1" id="user" />
+                    <Label htmlFor="user" className="cursor-pointer font-normal">
+                      사용자 메뉴
+                    </Label>
+                  </div>
+                </RadioGroup>
+              </div>
+
+              <div className="space-y-2">
+                <Label>할당할 메뉴 선택</Label>
+                {loading ? (
+                  <div className="flex items-center justify-center py-4">
+                    <Loader2 className="h-6 w-6 animate-spin text-gray-400" />
+                  </div>
+                ) : (
+                  <Select value={selectedMenuId} onValueChange={setSelectedMenuId}>
+                    <SelectTrigger>
+                      <SelectValue placeholder="메뉴를 선택하세요" />
+                    </SelectTrigger>
+                    <SelectContent className="max-h-[300px]">
+                      {flatMenus.map((menu) => (
+                        <SelectItem key={menu.id} value={menu.id}>
+                          {menu.name}
+                        </SelectItem>
+                      ))}
+                    </SelectContent>
+                  </Select>
+                )}
+              </div>
+            </>
+          )}
+        </div>
+
+        <DialogFooter>
+          <Button variant="outline" onClick={handleClose}>
+            취소
+          </Button>
+          <Button onClick={handleConfirm}>{assignToMenu ? "메뉴에 할당하고 완료" : "완료"}</Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+};

From 8e2c66e2a46c94f945e9d867251501965bbdb156 Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 15:39:54 +0900
Subject: [PATCH 03/10] =?UTF-8?q?3d=20=EC=A4=91=EA=B0=84=EC=A0=80=EC=9E=A5?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 backend-node/src/app.ts                       |   6 +-
 .../src/controllers/WarehouseController.ts    |  97 +++
 backend-node/src/routes/warehouseRoutes.ts    |  22 +
 backend-node/src/services/WarehouseService.ts | 170 +++++
 .../admin/dashboard/DashboardDesigner.tsx     |   4 +
 .../admin/dashboard/DashboardTopMenu.tsx      |   1 +
 frontend/components/admin/dashboard/types.ts  |   5 +-
 .../dashboard/widgets/Warehouse3DWidget.tsx   | 418 ++++++++++++
 .../components/dashboard/DashboardViewer.tsx  |  11 +
 frontend/package-lock.json                    | 610 +++++++++++++++++-
 frontend/package.json                         |   4 +
 11 files changed, 1339 insertions(+), 9 deletions(-)
 create mode 100644 backend-node/src/controllers/WarehouseController.ts
 create mode 100644 backend-node/src/routes/warehouseRoutes.ts
 create mode 100644 backend-node/src/services/WarehouseService.ts
 create mode 100644 frontend/components/admin/dashboard/widgets/Warehouse3DWidget.tsx

diff --git a/backend-node/src/app.ts b/backend-node/src/app.ts
index ae10a6fe..9483726a 100644
--- a/backend-node/src/app.ts
+++ b/backend-node/src/app.ts
@@ -55,6 +55,7 @@ import riskAlertRoutes from "./routes/riskAlertRoutes"; // 리스크/알림 관
 import todoRoutes from "./routes/todoRoutes"; // To-Do 관리
 import bookingRoutes from "./routes/bookingRoutes"; // 예약 요청 관리
 import mapDataRoutes from "./routes/mapDataRoutes"; // 지도 데이터 관리
+import warehouseRoutes from "./routes/warehouseRoutes"; // 창고 관리
 import { BatchSchedulerService } from "./services/batchSchedulerService";
 // import collectionRoutes from "./routes/collectionRoutes"; // 임시 주석
 // import batchRoutes from "./routes/batchRoutes"; // 임시 주석
@@ -204,6 +205,7 @@ app.use("/api/risk-alerts", riskAlertRoutes); // 리스크/알림 관리
 app.use("/api/todos", todoRoutes); // To-Do 관리
 app.use("/api/bookings", bookingRoutes); // 예약 요청 관리
 app.use("/api/map-data", mapDataRoutes); // 지도 데이터 조회
+app.use("/api/warehouse", warehouseRoutes); // 창고 관리
 // app.use("/api/collections", collectionRoutes); // 임시 주석
 // app.use("/api/batch", batchRoutes); // 임시 주석
 // app.use('/api/users', userRoutes);
@@ -241,7 +243,9 @@ app.listen(PORT, HOST, async () => {
 
   // 리스크/알림 자동 갱신 시작
   try {
-    const { RiskAlertCacheService } = await import('./services/riskAlertCacheService');
+    const { RiskAlertCacheService } = await import(
+      "./services/riskAlertCacheService"
+    );
     const cacheService = RiskAlertCacheService.getInstance();
     cacheService.startAutoRefresh();
     logger.info(`⏰ 리스크/알림 자동 갱신이 시작되었습니다. (10분 간격)`);
diff --git a/backend-node/src/controllers/WarehouseController.ts b/backend-node/src/controllers/WarehouseController.ts
new file mode 100644
index 00000000..1fe140e8
--- /dev/null
+++ b/backend-node/src/controllers/WarehouseController.ts
@@ -0,0 +1,97 @@
+import { Request, Response } from "express";
+import { WarehouseService } from "../services/WarehouseService";
+
+export class WarehouseController {
+  private warehouseService: WarehouseService;
+
+  constructor() {
+    this.warehouseService = new WarehouseService();
+  }
+
+  // 창고 및 자재 데이터 조회
+  getWarehouseData = async (req: Request, res: Response) => {
+    try {
+      const data = await this.warehouseService.getWarehouseData();
+
+      return res.json({
+        success: true,
+        warehouses: data.warehouses,
+        materials: data.materials,
+      });
+    } catch (error: any) {
+      console.error("창고 데이터 조회 오류:", error);
+      return res.status(500).json({
+        success: false,
+        message: "창고 데이터를 불러오는데 실패했습니다.",
+        error: error.message,
+      });
+    }
+  };
+
+  // 특정 창고 정보 조회
+  getWarehouseById = async (req: Request, res: Response) => {
+    try {
+      const { id } = req.params;
+      const warehouse = await this.warehouseService.getWarehouseById(id);
+
+      if (!warehouse) {
+        return res.status(404).json({
+          success: false,
+          message: "창고를 찾을 수 없습니다.",
+        });
+      }
+
+      return res.json({
+        success: true,
+        data: warehouse,
+      });
+    } catch (error: any) {
+      console.error("창고 조회 오류:", error);
+      return res.status(500).json({
+        success: false,
+        message: "창고 정보를 불러오는데 실패했습니다.",
+        error: error.message,
+      });
+    }
+  };
+
+  // 창고별 자재 목록 조회
+  getMaterialsByWarehouse = async (req: Request, res: Response) => {
+    try {
+      const { warehouseId } = req.params;
+      const materials =
+        await this.warehouseService.getMaterialsByWarehouse(warehouseId);
+
+      return res.json({
+        success: true,
+        data: materials,
+      });
+    } catch (error: any) {
+      console.error("자재 목록 조회 오류:", error);
+      return res.status(500).json({
+        success: false,
+        message: "자재 목록을 불러오는데 실패했습니다.",
+        error: error.message,
+      });
+    }
+  };
+
+  // 창고 통계 조회
+  getWarehouseStats = async (req: Request, res: Response) => {
+    try {
+      const stats = await this.warehouseService.getWarehouseStats();
+
+      return res.json({
+        success: true,
+        data: stats,
+      });
+    } catch (error: any) {
+      console.error("창고 통계 조회 오류:", error);
+      return res.status(500).json({
+        success: false,
+        message: "창고 통계를 불러오는데 실패했습니다.",
+        error: error.message,
+      });
+    }
+  };
+}
diff --git a/backend-node/src/routes/warehouseRoutes.ts b/backend-node/src/routes/warehouseRoutes.ts
new file mode 100644
index 00000000..15625a35
--- /dev/null
+++ b/backend-node/src/routes/warehouseRoutes.ts
@@ -0,0 +1,22 @@
+import { Router } from "express";
+import { WarehouseController } from "../controllers/WarehouseController";
+
+const router = Router();
+const warehouseController = new WarehouseController();
+
+// 창고 및 자재 데이터 조회
+router.get("/data", warehouseController.getWarehouseData);
+
+// 특정 창고 정보 조회
+router.get("/:id", warehouseController.getWarehouseById);
+
+// 창고별 자재 목록 조회
+router.get(
+  "/:warehouseId/materials",
+  warehouseController.getMaterialsByWarehouse
+);
+
+// 창고 통계 조회
+router.get("/stats/summary", warehouseController.getWarehouseStats);
+
+export default router;
diff --git a/backend-node/src/services/WarehouseService.ts b/backend-node/src/services/WarehouseService.ts
new file mode 100644
index 00000000..fe0433c7
--- /dev/null
+++ b/backend-node/src/services/WarehouseService.ts
@@ -0,0 +1,170 @@
+import pool from "../database/db";
+
+export class WarehouseService {
+  // 창고 및 자재 데이터 조회
+  async getWarehouseData() {
+    try {
+      // 창고 목록 조회
+      const warehousesResult = await pool.query(`
+        SELECT 
+          id,
+          name,
+          position_x,
+          position_y,
+          position_z,
+          size_x,
+          size_y,
+          size_z,
+          color,
+          capacity,
+          current_usage,
+          status,
+          description,
+          created_at,
+          updated_at
+        FROM warehouse
+        WHERE status = 'active'
+        ORDER BY id
+      `);
+
+      // 자재 목록 조회
+      const materialsResult = await pool.query(`
+        SELECT 
+          id,
+          warehouse_id,
+          name,
+          material_code,
+          quantity,
+          unit,
+          position_x,
+          position_y,
+          position_z,
+          size_x,
+          size_y,
+          size_z,
+          color,
+          status,
+          last_updated,
+          created_at
+        FROM warehouse_material
+        ORDER BY warehouse_id, id
+      `);
+
+      return {
+        warehouses: warehousesResult,
+        materials: materialsResult,
+      };
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  // 특정 창고 정보 조회
+  async getWarehouseById(id: string) {
+    try {
+      const result = await pool.query(
+        `
+        SELECT 
+          id,
+          name,
+          position_x,
+          position_y,
+          position_z,
+          size_x,
+          size_y,
+          size_z,
+          color,
+          capacity,
+          current_usage,
+          status,
+          description,
+          created_at,
+          updated_at
+        FROM warehouse
+        WHERE id = $1
+      `,
+        [id]
+      );
+
+      return result[0] || null;
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  // 창고별 자재 목록 조회
+  async getMaterialsByWarehouse(warehouseId: string) {
+    try {
+      const result = await pool.query(
+        `
+        SELECT 
+          id,
+          warehouse_id,
+          name,
+          material_code,
+          quantity,
+          unit,
+          position_x,
+          position_y,
+          position_z,
+          size_x,
+          size_y,
+          size_z,
+          color,
+          status,
+          last_updated,
+          created_at
+        FROM warehouse_material
+        WHERE warehouse_id = $1
+        ORDER BY id
+      `,
+        [warehouseId]
+      );
+
+      return result;
+    } catch (error) {
+      throw error;
+    }
+  }
+
+  // 창고 통계 조회
+  async getWarehouseStats() {
+    try {
+      const result = await pool.query(`
+        SELECT 
+          COUNT(DISTINCT w.id) as total_warehouses,
+          COUNT(m.id) as total_materials,
+          SUM(w.capacity) as total_capacity,
+          SUM(w.current_usage) as total_usage,
+          ROUND(AVG((w.current_usage::numeric / NULLIF(w.capacity, 0)) * 100), 2) as avg_usage_percent
+        FROM warehouse w
+        LEFT JOIN warehouse_material m ON w.id = m.warehouse_id
+        WHERE w.status = 'active'
+      `);
+
+      // 상태별 자재 수
+      const statusResult = await pool.query(`
+        SELECT 
+          status,
+          COUNT(*) as count
+        FROM warehouse_material
+        GROUP BY status
+      `);
+
+      const statusCounts = statusResult.reduce(
+        (acc: Record<string, number>, row: any) => {
+          acc[row.status] = parseInt(row.count);
+          return acc;
+        },
+        {} as Record<string, number>
+      );
+
+      return {
+        ...result[0],
+        materialsByStatus: statusCounts,
+      };
+    } catch (error) {
+      throw error;
+    }
+  }
+}
diff --git a/frontend/components/admin/dashboard/DashboardDesigner.tsx b/frontend/components/admin/dashboard/DashboardDesigner.tsx
index 0c41ff7c..95eea2f2 100644
--- a/frontend/components/admin/dashboard/DashboardDesigner.tsx
+++ b/frontend/components/admin/dashboard/DashboardDesigner.tsx
@@ -575,6 +575,8 @@ function getElementTitle(type: ElementType, subtype: ElementSubtype): string {
         return "🚚 기사 관리 위젯";
       case "list":
         return "📋 리스트 위젯";
+      case "warehouse-3d":
+        return "🏭 창고 현황 (3D)";
       default:
         return "🔧 위젯";
     }
@@ -615,6 +617,8 @@ function getElementContent(type: ElementType, subtype: ElementSubtype): string {
         return "driver-management";
       case "list":
         return "list-widget";
+      case "warehouse-3d":
+        return "warehouse-3d";
       default:
         return "위젯 내용이 여기에 표시됩니다";
     }
diff --git a/frontend/components/admin/dashboard/DashboardTopMenu.tsx b/frontend/components/admin/dashboard/DashboardTopMenu.tsx
index 1d58988f..446830a8 100644
--- a/frontend/components/admin/dashboard/DashboardTopMenu.tsx
+++ b/frontend/components/admin/dashboard/DashboardTopMenu.tsx
@@ -184,6 +184,7 @@ export function DashboardTopMenu({
               <SelectLabel>데이터 위젯</SelectLabel>
               <SelectItem value="list">리스트 위젯</SelectItem>
               <SelectItem value="map">지도</SelectItem>
+              <SelectItem value="warehouse-3d">창고 현황 (3D)</SelectItem>
             </SelectGroup>
             <SelectGroup>
               <SelectLabel>일반 위젯</SelectLabel>
diff --git a/frontend/components/admin/dashboard/types.ts b/frontend/components/admin/dashboard/types.ts
index cdf70550..90668874 100644
--- a/frontend/components/admin/dashboard/types.ts
+++ b/frontend/components/admin/dashboard/types.ts
@@ -35,7 +35,8 @@ export type ElementSubtype =
   | "booking-alert"
   | "maintenance"
   | "document"
-  | "list"; // 위젯 타입
+  | "list"
+  | "warehouse-3d"; // 위젯 타입
 
 export interface Position {
   x: number;
@@ -139,7 +140,7 @@ export interface ChartConfig {
 
   // 애니메이션
   enableAnimation?: boolean; // 애니메이션 활성화
-  
+
   // 상태 필터링 (커스텀 상태 카드용)
   statusFilter?: string[]; // 표시할 상태 목록 (예: ["driving", "parked"])
   animationDuration?: number; // 애니메이션 시간 (ms)
diff --git a/frontend/components/admin/dashboard/widgets/Warehouse3DWidget.tsx b/frontend/components/admin/dashboard/widgets/Warehouse3DWidget.tsx
new file mode 100644
index 00000000..71d2df0e
--- /dev/null
+++ b/frontend/components/admin/dashboard/widgets/Warehouse3DWidget.tsx
@@ -0,0 +1,418 @@
+"use client";
+
+import React, { useRef, useState, useEffect, Suspense } from "react";
+import { Canvas, useFrame } from "@react-three/fiber";
+import { OrbitControls, Text, Box, Html } from "@react-three/drei";
+import * as THREE from "three";
+import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { Badge } from "@/components/ui/badge";
+import { Loader2, Maximize2, Info } from "lucide-react";
+
+interface WarehouseData {
+  id: string;
+  name: string;
+  position_x: number;
+  position_y: number;
+  position_z: number;
+  size_x: number;
+  size_y: number;
+  size_z: number;
+  color: string;
+  capacity: number;
+  current_usage: number;
+  status: string;
+  description?: string;
+}
+
+interface MaterialData {
+  id: string;
+  warehouse_id: string;
+  name: string;
+  material_code: string;
+  quantity: number;
+  unit: string;
+  position_x: number;
+  position_y: number;
+  position_z: number;
+  size_x: number;
+  size_y: number;
+  size_z: number;
+  color: string;
+  status: string;
+}
+
+interface Warehouse3DWidgetProps {
+  element?: any;
+}
+
+// 창고 3D 박스 컴포넌트
+function WarehouseBox({
+  warehouse,
+  onClick,
+  isSelected,
+}: {
+  warehouse: WarehouseData;
+  onClick: () => void;
+  isSelected: boolean;
+}) {
+  const meshRef = useRef<THREE.Mesh>(null);
+  const [hovered, setHovered] = useState(false);
+
+  useFrame(() => {
+    if (meshRef.current) {
+      if (isSelected) {
+        meshRef.current.scale.lerp(new THREE.Vector3(1.05, 1.05, 1.05), 0.1);
+      } else if (hovered) {
+        meshRef.current.scale.lerp(new THREE.Vector3(1.02, 1.02, 1.02), 0.1);
+      } else {
+        meshRef.current.scale.lerp(new THREE.Vector3(1, 1, 1), 0.1);
+      }
+    }
+  });
+
+  const usagePercentage = (warehouse.current_usage / warehouse.capacity) * 100;
+
+  return (
+    <group position={[warehouse.position_x, warehouse.position_y + warehouse.size_y / 2, warehouse.position_z]}>
+      <mesh
+        ref={meshRef}
+        onClick={(e) => {
+          e.stopPropagation();
+          onClick();
+        }}
+        onPointerOver={() => setHovered(true)}
+        onPointerOut={() => setHovered(false)}
+      >
+        <boxGeometry args={[warehouse.size_x, warehouse.size_y, warehouse.size_z]} />
+        <meshStandardMaterial color={warehouse.color} transparent opacity={0.3} wireframe={false} />
+      </mesh>
+
+      {/* 창고 테두리 */}
+      <lineSegments>
+        <edgesGeometry args={[new THREE.BoxGeometry(warehouse.size_x, warehouse.size_y, warehouse.size_z)]} />
+        <lineBasicMaterial color={isSelected ? "#FFD700" : hovered ? "#FFFFFF" : warehouse.color} linewidth={2} />
+      </lineSegments>
+
+      {/* 창고 이름 라벨 */}
+      <Text position={[0, warehouse.size_y / 2 + 1, 0]} fontSize={1} color="white" anchorX="center" anchorY="middle">
+        {warehouse.name}
+      </Text>
+
+      {/* 사용률 표시 */}
+      <Html position={[0, warehouse.size_y / 2 + 2, 0]} center>
+        <div className="pointer-events-none rounded bg-black/80 px-2 py-1 text-xs text-white">
+          {usagePercentage.toFixed(0)}% 사용중
+        </div>
+      </Html>
+    </group>
+  );
+}
+
+// 자재 3D 박스 컴포넌트
+function MaterialBox({
+  material,
+  onClick,
+  isSelected,
+}: {
+  material: MaterialData;
+  onClick: () => void;
+  isSelected: boolean;
+}) {
+  const meshRef = useRef<THREE.Mesh>(null);
+  const [hovered, setHovered] = useState(false);
+
+  useFrame(() => {
+    if (meshRef.current && (isSelected || hovered)) {
+      meshRef.current.rotation.y += 0.01;
+    }
+  });
+
+  const statusColor =
+    {
+      stocked: material.color,
+      reserved: "#FFA500",
+      urgent: "#FF0000",
+      out_of_stock: "#808080",
+    }[material.status] || material.color;
+
+  return (
+    <group position={[material.position_x, material.position_y + material.size_y / 2, material.position_z]}>
+      <mesh
+        ref={meshRef}
+        onClick={(e) => {
+          e.stopPropagation();
+          onClick();
+        }}
+        onPointerOver={() => setHovered(true)}
+        onPointerOut={() => setHovered(false)}
+      >
+        <boxGeometry args={[material.size_x, material.size_y, material.size_z]} />
+        <meshStandardMaterial color={statusColor} metalness={0.5} roughness={0.2} />
+      </mesh>
+
+      {(hovered || isSelected) && (
+        <Html position={[0, material.size_y / 2 + 0.5, 0]} center>
+          <div className="pointer-events-none rounded bg-black/90 px-2 py-1 text-xs text-white shadow-lg">
+            <div className="font-bold">{material.name}</div>
+            <div className="text-gray-300">
+              {material.quantity} {material.unit}
+            </div>
+          </div>
+        </Html>
+      )}
+    </group>
+  );
+}
+
+// 3D 씬 컴포넌트
+function Scene({
+  warehouses,
+  materials,
+  onSelectWarehouse,
+  onSelectMaterial,
+  selectedWarehouse,
+  selectedMaterial,
+}: {
+  warehouses: WarehouseData[];
+  materials: MaterialData[];
+  onSelectWarehouse: (warehouse: WarehouseData | null) => void;
+  onSelectMaterial: (material: MaterialData | null) => void;
+  selectedWarehouse: WarehouseData | null;
+  selectedMaterial: MaterialData | null;
+}) {
+  return (
+    <>
+      {/* 조명 */}
+      <ambientLight intensity={0.5} />
+      <directionalLight position={[10, 10, 5]} intensity={1} castShadow />
+      <directionalLight position={[-10, 10, -5]} intensity={0.5} />
+
+      {/* 바닥 그리드 */}
+      <gridHelper args={[100, 50, "#444444", "#222222"]} position={[0, 0, 0]} />
+
+      {/* 창고들 */}
+      {warehouses.map((warehouse) => (
+        <WarehouseBox
+          key={warehouse.id}
+          warehouse={warehouse}
+          onClick={() => {
+            if (selectedWarehouse?.id === warehouse.id) {
+              onSelectWarehouse(null);
+            } else {
+              onSelectWarehouse(warehouse);
+              onSelectMaterial(null);
+            }
+          }}
+          isSelected={selectedWarehouse?.id === warehouse.id}
+        />
+      ))}
+
+      {/* 자재들 */}
+      {materials.map((material) => (
+        <MaterialBox
+          key={material.id}
+          material={material}
+          onClick={() => {
+            if (selectedMaterial?.id === material.id) {
+              onSelectMaterial(null);
+            } else {
+              onSelectMaterial(material);
+            }
+          }}
+          isSelected={selectedMaterial?.id === material.id}
+        />
+      ))}
+
+      {/* 카메라 컨트롤 */}
+      <OrbitControls enableDamping dampingFactor={0.05} minDistance={10} maxDistance={100} />
+    </>
+  );
+}
+
+export function Warehouse3DWidget({ element }: Warehouse3DWidgetProps) {
+  const [warehouses, setWarehouses] = useState<WarehouseData[]>([]);
+  const [materials, setMaterials] = useState<MaterialData[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [selectedWarehouse, setSelectedWarehouse] = useState<WarehouseData | null>(null);
+  const [selectedMaterial, setSelectedMaterial] = useState<MaterialData | null>(null);
+  const [isFullscreen, setIsFullscreen] = useState(false);
+
+  useEffect(() => {
+    loadData();
+  }, []);
+
+  const loadData = async () => {
+    try {
+      setLoading(true);
+      // API 호출 (백엔드 API 구현 필요)
+      const response = await fetch("/api/warehouse/data");
+      if (response.ok) {
+        const data = await response.json();
+        setWarehouses(data.warehouses || []);
+        setMaterials(data.materials || []);
+      } else {
+        // 임시 더미 데이터 (개발용)
+        console.log("API 실패, 더미 데이터 사용");
+      }
+    } catch (error) {
+      console.error("창고 데이터 로드 실패:", error);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  if (loading) {
+    return (
+      <Card className="h-full">
+        <CardContent className="flex h-full items-center justify-center">
+          <Loader2 className="h-8 w-8 animate-spin text-gray-400" />
+        </CardContent>
+      </Card>
+    );
+  }
+
+  return (
+    <Card className={`flex h-full flex-col ${isFullscreen ? "fixed inset-0 z-50" : ""}`}>
+      <CardHeader className="flex flex-row items-center justify-between space-y-0 pb-2">
+        <CardTitle className="text-lg font-bold">🏭 창고 현황 (3D)</CardTitle>
+        <div className="flex gap-2">
+          <Badge variant="outline">
+            {warehouses.length}개 창고 | {materials.length}개 자재
+          </Badge>
+          <button onClick={() => setIsFullscreen(!isFullscreen)} className="text-gray-500 hover:text-gray-700">
+            <Maximize2 className="h-4 w-4" />
+          </button>
+        </div>
+      </CardHeader>
+      <CardContent className="flex flex-1 gap-4 p-4">
+        {/* 3D 뷰 */}
+        <div className="flex-1 rounded-lg bg-gray-900">
+          <Canvas camera={{ position: [30, 20, 30], fov: 50 }}>
+            <Suspense fallback={null}>
+              <Scene
+                warehouses={warehouses}
+                materials={materials}
+                onSelectWarehouse={setSelectedWarehouse}
+                onSelectMaterial={setSelectedMaterial}
+                selectedWarehouse={selectedWarehouse}
+                selectedMaterial={selectedMaterial}
+              />
+            </Suspense>
+          </Canvas>
+        </div>
+
+        {/* 정보 패널 */}
+        <div className="w-80 space-y-4 overflow-y-auto">
+          {/* 선택된 창고 정보 */}
+          {selectedWarehouse && (
+            <Card>
+              <CardHeader className="pb-3">
+                <CardTitle className="flex items-center gap-2 text-sm">
+                  <Info className="h-4 w-4" />
+                  창고 정보
+                </CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-2 text-sm">
+                <div>
+                  <span className="font-semibold">이름:</span> {selectedWarehouse.name}
+                </div>
+                <div>
+                  <span className="font-semibold">ID:</span> {selectedWarehouse.id}
+                </div>
+                <div>
+                  <span className="font-semibold">용량:</span> {selectedWarehouse.current_usage} /{" "}
+                  {selectedWarehouse.capacity}
+                </div>
+                <div>
+                  <span className="font-semibold">사용률:</span>{" "}
+                  {((selectedWarehouse.current_usage / selectedWarehouse.capacity) * 100).toFixed(1)}%
+                </div>
+                <div>
+                  <span className="font-semibold">상태:</span>{" "}
+                  <Badge variant={selectedWarehouse.status === "active" ? "default" : "secondary"}>
+                    {selectedWarehouse.status}
+                  </Badge>
+                </div>
+                {selectedWarehouse.description && (
+                  <div>
+                    <span className="font-semibold">설명:</span> {selectedWarehouse.description}
+                  </div>
+                )}
+              </CardContent>
+            </Card>
+          )}
+
+          {/* 선택된 자재 정보 */}
+          {selectedMaterial && (
+            <Card>
+              <CardHeader className="pb-3">
+                <CardTitle className="flex items-center gap-2 text-sm">
+                  <Info className="h-4 w-4" />
+                  자재 정보
+                </CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-2 text-sm">
+                <div>
+                  <span className="font-semibold">이름:</span> {selectedMaterial.name}
+                </div>
+                <div>
+                  <span className="font-semibold">코드:</span> {selectedMaterial.material_code}
+                </div>
+                <div>
+                  <span className="font-semibold">수량:</span> {selectedMaterial.quantity} {selectedMaterial.unit}
+                </div>
+                <div>
+                  <span className="font-semibold">위치:</span>{" "}
+                  {warehouses.find((w) => w.id === selectedMaterial.warehouse_id)?.name}
+                </div>
+                <div>
+                  <span className="font-semibold">상태:</span>{" "}
+                  <Badge
+                    variant={
+                      selectedMaterial.status === "urgent"
+                        ? "destructive"
+                        : selectedMaterial.status === "reserved"
+                          ? "secondary"
+                          : "default"
+                    }
+                  >
+                    {selectedMaterial.status}
+                  </Badge>
+                </div>
+              </CardContent>
+            </Card>
+          )}
+
+          {/* 창고 목록 */}
+          {!selectedWarehouse && !selectedMaterial && (
+            <Card>
+              <CardHeader className="pb-3">
+                <CardTitle className="text-sm">창고 목록</CardTitle>
+              </CardHeader>
+              <CardContent className="space-y-2">
+                {warehouses.map((warehouse) => {
+                  const warehouseMaterials = materials.filter((m) => m.warehouse_id === warehouse.id);
+                  return (
+                    <button
+                      key={warehouse.id}
+                      onClick={() => setSelectedWarehouse(warehouse)}
+                      className="w-full rounded-lg border p-2 text-left transition-colors hover:bg-gray-50"
+                    >
+                      <div className="flex items-center justify-between">
+                        <span className="font-semibold">{warehouse.name}</span>
+                        <Badge variant="outline">{warehouseMaterials.length}개</Badge>
+                      </div>
+                      <div className="mt-1 text-xs text-gray-500">
+                        {((warehouse.current_usage / warehouse.capacity) * 100).toFixed(0)}% 사용중
+                      </div>
+                    </button>
+                  );
+                })}
+              </CardContent>
+            </Card>
+          )}
+        </div>
+      </CardContent>
+    </Card>
+  );
+}
diff --git a/frontend/components/dashboard/DashboardViewer.tsx b/frontend/components/dashboard/DashboardViewer.tsx
index f4f8caea..d0c12ccf 100644
--- a/frontend/components/dashboard/DashboardViewer.tsx
+++ b/frontend/components/dashboard/DashboardViewer.tsx
@@ -38,6 +38,14 @@ const ListWidget = dynamic(
   { ssr: false },
 );
 
+const Warehouse3DWidget = dynamic(
+  () =>
+    import("@/components/admin/dashboard/widgets/Warehouse3DWidget").then((mod) => ({
+      default: mod.Warehouse3DWidget,
+    })),
+  { ssr: false },
+);
+
 /**
  * 위젯 렌더링 함수 - DashboardSidebar의 모든 subtype 처리
  * ViewerElement에서 사용하기 위해 컴포넌트 외부에 정의
@@ -78,6 +86,9 @@ function renderWidget(element: DashboardElement) {
     case "list":
       return <ListWidget element={element} />;
 
+    case "warehouse-3d":
+      return <Warehouse3DWidget element={element} />;
+
     // === 차량 관련 (추가 위젯) ===
     case "vehicle-status":
       return <VehicleStatusWidget />;
diff --git a/frontend/package-lock.json b/frontend/package-lock.json
index 99c48de4..9dbf4f10 100644
--- a/frontend/package-lock.json
+++ b/frontend/package-lock.json
@@ -30,11 +30,14 @@
         "@radix-ui/react-slot": "^1.2.3",
         "@radix-ui/react-switch": "^1.2.6",
         "@radix-ui/react-tabs": "^1.1.13",
+        "@react-three/drei": "^10.7.6",
+        "@react-three/fiber": "^9.4.0",
         "@tanstack/react-query": "^5.86.0",
         "@tanstack/react-table": "^8.21.3",
         "@types/d3": "^7.4.3",
         "@types/leaflet": "^1.9.21",
         "@types/react-window": "^1.8.8",
+        "@types/three": "^0.180.0",
         "@xyflow/react": "^12.8.4",
         "axios": "^1.11.0",
         "class-variance-authority": "^0.7.1",
@@ -64,6 +67,7 @@
         "sheetjs-style": "^0.15.8",
         "sonner": "^2.0.7",
         "tailwind-merge": "^3.3.1",
+        "three": "^0.180.0",
         "uuid": "^13.0.0",
         "xlsx": "^0.18.5",
         "zod": "^4.1.5"
@@ -280,6 +284,12 @@
       "integrity": "sha512-P5LUNhtbj6YfI3iJjw5EL9eUAG6OitD0W3fWQcpQjDRc/QIsL0tRNuO1PcDvPccWL1fSTXXdE1ds+l95DV/OFA==",
       "license": "MIT"
     },
+    "node_modules/@dimforge/rapier3d-compat": {
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/@dimforge/rapier3d-compat/-/rapier3d-compat-0.12.0.tgz",
+      "integrity": "sha512-uekIGetywIgopfD97oDL5PfeezkFpNhwlzlaEYNOA0N6ghdsOvh/HYjSMek5Q2O1PYvRSDFcqFVJl4r4ZBwOow==",
+      "license": "Apache-2.0"
+    },
     "node_modules/@dnd-kit/accessibility": {
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/@dnd-kit/accessibility/-/accessibility-3.1.1.tgz",
@@ -1100,6 +1110,24 @@
         "@jridgewell/sourcemap-codec": "^1.4.14"
       }
     },
+    "node_modules/@mediapipe/tasks-vision": {
+      "version": "0.10.17",
+      "resolved": "https://registry.npmjs.org/@mediapipe/tasks-vision/-/tasks-vision-0.10.17.tgz",
+      "integrity": "sha512-CZWV/q6TTe8ta61cZXjfnnHsfWIdFhms03M9T7Cnd5y2mdpylJM0rF1qRq+wsQVRMLz1OYPVEBU9ph2Bx8cxrg==",
+      "license": "Apache-2.0"
+    },
+    "node_modules/@monogrid/gainmap-js": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/@monogrid/gainmap-js/-/gainmap-js-3.1.0.tgz",
+      "integrity": "sha512-Obb0/gEd/HReTlg8ttaYk+0m62gQJmCblMOjHSMHRrBP2zdfKMHLCRbh/6ex9fSUJMKdjjIEiohwkbGD3wj2Nw==",
+      "license": "MIT",
+      "dependencies": {
+        "promise-worker-transferable": "^1.0.4"
+      },
+      "peerDependencies": {
+        "three": ">= 0.159.0"
+      }
+    },
     "node_modules/@napi-rs/wasm-runtime": {
       "version": "0.2.12",
       "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-0.2.12.tgz",
@@ -2495,6 +2523,160 @@
         "react-dom": "^19.0.0"
       }
     },
+    "node_modules/@react-three/drei": {
+      "version": "10.7.6",
+      "resolved": "https://registry.npmjs.org/@react-three/drei/-/drei-10.7.6.tgz",
+      "integrity": "sha512-ZSFwRlRaa4zjtB7yHO6Q9xQGuyDCzE7whXBhum92JslcMRC3aouivp0rAzszcVymIoJx6PXmibyP+xr+zKdwLg==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.26.0",
+        "@mediapipe/tasks-vision": "0.10.17",
+        "@monogrid/gainmap-js": "^3.0.6",
+        "@use-gesture/react": "^10.3.1",
+        "camera-controls": "^3.1.0",
+        "cross-env": "^7.0.3",
+        "detect-gpu": "^5.0.56",
+        "glsl-noise": "^0.0.0",
+        "hls.js": "^1.5.17",
+        "maath": "^0.10.8",
+        "meshline": "^3.3.1",
+        "stats-gl": "^2.2.8",
+        "stats.js": "^0.17.0",
+        "suspend-react": "^0.1.3",
+        "three-mesh-bvh": "^0.8.3",
+        "three-stdlib": "^2.35.6",
+        "troika-three-text": "^0.52.4",
+        "tunnel-rat": "^0.1.2",
+        "use-sync-external-store": "^1.4.0",
+        "utility-types": "^3.11.0",
+        "zustand": "^5.0.1"
+      },
+      "peerDependencies": {
+        "@react-three/fiber": "^9.0.0",
+        "react": "^19",
+        "react-dom": "^19",
+        "three": ">=0.159"
+      },
+      "peerDependenciesMeta": {
+        "react-dom": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@react-three/drei/node_modules/zustand": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/zustand/-/zustand-5.0.8.tgz",
+      "integrity": "sha512-gyPKpIaxY9XcO2vSMrLbiER7QMAMGOQZVRdJ6Zi782jkbzZygq5GI9nG8g+sMgitRtndwaBSl7uiqC49o1SSiw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.20.0"
+      },
+      "peerDependencies": {
+        "@types/react": ">=18.0.0",
+        "immer": ">=9.0.6",
+        "react": ">=18.0.0",
+        "use-sync-external-store": ">=1.2.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        },
+        "immer": {
+          "optional": true
+        },
+        "react": {
+          "optional": true
+        },
+        "use-sync-external-store": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@react-three/fiber": {
+      "version": "9.4.0",
+      "resolved": "https://registry.npmjs.org/@react-three/fiber/-/fiber-9.4.0.tgz",
+      "integrity": "sha512-k4iu1R6e5D54918V4sqmISUkI5OgTw3v7/sDRKEC632Wd5g2WBtUS5gyG63X0GJO/HZUj1tsjSXfyzwrUHZl1g==",
+      "license": "MIT",
+      "dependencies": {
+        "@babel/runtime": "^7.17.8",
+        "@types/react-reconciler": "^0.32.0",
+        "@types/webxr": "*",
+        "base64-js": "^1.5.1",
+        "buffer": "^6.0.3",
+        "its-fine": "^2.0.0",
+        "react-reconciler": "^0.31.0",
+        "react-use-measure": "^2.1.7",
+        "scheduler": "^0.25.0",
+        "suspend-react": "^0.1.3",
+        "use-sync-external-store": "^1.4.0",
+        "zustand": "^5.0.3"
+      },
+      "peerDependencies": {
+        "expo": ">=43.0",
+        "expo-asset": ">=8.4",
+        "expo-file-system": ">=11.0",
+        "expo-gl": ">=11.0",
+        "react": "^19.0.0",
+        "react-dom": "^19.0.0",
+        "react-native": ">=0.78",
+        "three": ">=0.156"
+      },
+      "peerDependenciesMeta": {
+        "expo": {
+          "optional": true
+        },
+        "expo-asset": {
+          "optional": true
+        },
+        "expo-file-system": {
+          "optional": true
+        },
+        "expo-gl": {
+          "optional": true
+        },
+        "react-dom": {
+          "optional": true
+        },
+        "react-native": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@react-three/fiber/node_modules/scheduler": {
+      "version": "0.25.0",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.25.0.tgz",
+      "integrity": "sha512-xFVuu11jh+xcO7JOAGJNOXld8/TcEHK/4CituBUeUb5hqxJLj9YuemAEuvm9gQ/+pgXYfbQuqAkiYu+u7YEsNA==",
+      "license": "MIT"
+    },
+    "node_modules/@react-three/fiber/node_modules/zustand": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/zustand/-/zustand-5.0.8.tgz",
+      "integrity": "sha512-gyPKpIaxY9XcO2vSMrLbiER7QMAMGOQZVRdJ6Zi782jkbzZygq5GI9nG8g+sMgitRtndwaBSl7uiqC49o1SSiw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.20.0"
+      },
+      "peerDependencies": {
+        "@types/react": ">=18.0.0",
+        "immer": ">=9.0.6",
+        "react": ">=18.0.0",
+        "use-sync-external-store": ">=1.2.0"
+      },
+      "peerDependenciesMeta": {
+        "@types/react": {
+          "optional": true
+        },
+        "immer": {
+          "optional": true
+        },
+        "react": {
+          "optional": true
+        },
+        "use-sync-external-store": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/@reactflow/background": {
       "version": "11.3.9",
       "resolved": "https://registry.npmjs.org/@reactflow/background/-/background-11.3.9.tgz",
@@ -3022,6 +3204,12 @@
         "url": "https://github.com/sponsors/tannerlinsley"
       }
     },
+    "node_modules/@tweenjs/tween.js": {
+      "version": "23.1.3",
+      "resolved": "https://registry.npmjs.org/@tweenjs/tween.js/-/tween.js-23.1.3.tgz",
+      "integrity": "sha512-vJmvvwFxYuGnF2axRtPYocag6Clbb5YS7kLL+SO/TeVFzHqDIWrNKYtcsPMibjDx9O+bu+psAy9NKfWklassUA==",
+      "license": "MIT"
+    },
     "node_modules/@tybys/wasm-util": {
       "version": "0.10.1",
       "resolved": "https://registry.npmjs.org/@tybys/wasm-util/-/wasm-util-0.10.1.tgz",
@@ -3286,6 +3474,12 @@
         "@types/d3-selection": "*"
       }
     },
+    "node_modules/@types/draco3d": {
+      "version": "1.4.10",
+      "resolved": "https://registry.npmjs.org/@types/draco3d/-/draco3d-1.4.10.tgz",
+      "integrity": "sha512-AX22jp8Y7wwaBgAixaSvkoG4M/+PlAcm3Qs4OW8yT9DM4xUpWKeFhLueTAyZF39pviAdcDdeJoACapiAceqNcw==",
+      "license": "MIT"
+    },
     "node_modules/@types/estree": {
       "version": "1.0.8",
       "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
@@ -3332,6 +3526,12 @@
         "undici-types": "~6.21.0"
       }
     },
+    "node_modules/@types/offscreencanvas": {
+      "version": "2019.7.3",
+      "resolved": "https://registry.npmjs.org/@types/offscreencanvas/-/offscreencanvas-2019.7.3.tgz",
+      "integrity": "sha512-ieXiYmgSRXUDeOntE1InxjWyvEelZGP63M+cGuquuRLuIKKT1osnkXjxev9B7d1nXSug5vpunx+gNlbVxMlC9A==",
+      "license": "MIT"
+    },
     "node_modules/@types/react": {
       "version": "19.1.13",
       "resolved": "https://registry.npmjs.org/@types/react/-/react-19.1.13.tgz",
@@ -3351,6 +3551,15 @@
         "@types/react": "^19.0.0"
       }
     },
+    "node_modules/@types/react-reconciler": {
+      "version": "0.32.2",
+      "resolved": "https://registry.npmjs.org/@types/react-reconciler/-/react-reconciler-0.32.2.tgz",
+      "integrity": "sha512-gjcm6O0aUknhYaogEl8t5pecPfiOTD8VQkbjOhgbZas/E6qGY+veW9iuJU/7p4Y1E0EuQ0mArga7VEOUWSlVRA==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@types/react": "*"
+      }
+    },
     "node_modules/@types/react-window": {
       "version": "1.8.8",
       "resolved": "https://registry.npmjs.org/@types/react-window/-/react-window-1.8.8.tgz",
@@ -3360,6 +3569,27 @@
         "@types/react": "*"
       }
     },
+    "node_modules/@types/stats.js": {
+      "version": "0.17.4",
+      "resolved": "https://registry.npmjs.org/@types/stats.js/-/stats.js-0.17.4.tgz",
+      "integrity": "sha512-jIBvWWShCvlBqBNIZt0KAshWpvSjhkwkEu4ZUcASoAvhmrgAUI2t1dXrjSL4xXVLB4FznPrIsX3nKXFl/Dt4vA==",
+      "license": "MIT"
+    },
+    "node_modules/@types/three": {
+      "version": "0.180.0",
+      "resolved": "https://registry.npmjs.org/@types/three/-/three-0.180.0.tgz",
+      "integrity": "sha512-ykFtgCqNnY0IPvDro7h+9ZeLY+qjgUWv+qEvUt84grhenO60Hqd4hScHE7VTB9nOQ/3QM8lkbNE+4vKjEpUxKg==",
+      "license": "MIT",
+      "dependencies": {
+        "@dimforge/rapier3d-compat": "~0.12.0",
+        "@tweenjs/tween.js": "~23.1.3",
+        "@types/stats.js": "*",
+        "@types/webxr": "*",
+        "@webgpu/types": "*",
+        "fflate": "~0.8.2",
+        "meshoptimizer": "~0.22.0"
+      }
+    },
     "node_modules/@types/trusted-types": {
       "version": "2.0.7",
       "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
@@ -3380,6 +3610,12 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/@types/webxr": {
+      "version": "0.5.24",
+      "resolved": "https://registry.npmjs.org/@types/webxr/-/webxr-0.5.24.tgz",
+      "integrity": "sha512-h8fgEd/DpoS9CBrjEQXR+dIDraopAEfu4wYVNY2tEPwk60stPWhvZMf4Foo5FakuQ7HFZoa8WceaWFervK2Ovg==",
+      "license": "MIT"
+    },
     "node_modules/@typescript-eslint/eslint-plugin": {
       "version": "8.44.1",
       "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-8.44.1.tgz",
@@ -3937,6 +4173,30 @@
         "win32"
       ]
     },
+    "node_modules/@use-gesture/core": {
+      "version": "10.3.1",
+      "resolved": "https://registry.npmjs.org/@use-gesture/core/-/core-10.3.1.tgz",
+      "integrity": "sha512-WcINiDt8WjqBdUXye25anHiNxPc0VOrlT8F6LLkU6cycrOGUDyY/yyFmsg3k8i5OLvv25llc0QC45GhR/C8llw==",
+      "license": "MIT"
+    },
+    "node_modules/@use-gesture/react": {
+      "version": "10.3.1",
+      "resolved": "https://registry.npmjs.org/@use-gesture/react/-/react-10.3.1.tgz",
+      "integrity": "sha512-Yy19y6O2GJq8f7CHf7L0nxL8bf4PZCPaVOCgJrusOeFHY1LvHgYXnmnXg6N5iwAnbgbZCDjo60SiM6IPJi9C5g==",
+      "license": "MIT",
+      "dependencies": {
+        "@use-gesture/core": "10.3.1"
+      },
+      "peerDependencies": {
+        "react": ">= 16.8.0"
+      }
+    },
+    "node_modules/@webgpu/types": {
+      "version": "0.1.66",
+      "resolved": "https://registry.npmjs.org/@webgpu/types/-/types-0.1.66.tgz",
+      "integrity": "sha512-YA2hLrwLpDsRueNDXIMqN9NTzD6bCDkuXbOSe0heS+f8YE8usA6Gbv1prj81pzVHrbaAma7zObnIC+I6/sXJgA==",
+      "license": "BSD-3-Clause"
+    },
     "node_modules/@xmldom/xmldom": {
       "version": "0.8.11",
       "resolved": "https://registry.npmjs.org/@xmldom/xmldom/-/xmldom-0.8.11.tgz",
@@ -4384,6 +4644,30 @@
         "node": ">=8"
       }
     },
+    "node_modules/buffer": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz",
+      "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.3.1",
+        "ieee754": "^1.2.1"
+      }
+    },
     "node_modules/c12": {
       "version": "3.1.0",
       "resolved": "https://registry.npmjs.org/c12/-/c12-3.1.0.tgz",
@@ -4472,6 +4756,19 @@
         "node": ">=6"
       }
     },
+    "node_modules/camera-controls": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/camera-controls/-/camera-controls-3.1.0.tgz",
+      "integrity": "sha512-w5oULNpijgTRH0ARFJJ0R5ct1nUM3R3WP7/b8A6j9uTGpRfnsypc/RBMPQV8JQDPayUe37p/TZZY1PcUr4czOQ==",
+      "license": "MIT",
+      "engines": {
+        "node": ">=20.11.0",
+        "npm": ">=10.8.2"
+      },
+      "peerDependencies": {
+        "three": ">=0.126.1"
+      }
+    },
     "node_modules/caniuse-lite": {
       "version": "1.0.30001745",
       "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001745.tgz",
@@ -4718,11 +5015,28 @@
         "node": ">=0.8"
       }
     },
+    "node_modules/cross-env": {
+      "version": "7.0.3",
+      "resolved": "https://registry.npmjs.org/cross-env/-/cross-env-7.0.3.tgz",
+      "integrity": "sha512-+/HKd6EgcQCJGh2PSjZuUitQBQynKor4wrFbRg4DtAgS1aWO+gU52xpH7M9ScGgXSYmAVS9bIJ8EzuaGw0oNAw==",
+      "license": "MIT",
+      "dependencies": {
+        "cross-spawn": "^7.0.1"
+      },
+      "bin": {
+        "cross-env": "src/bin/cross-env.js",
+        "cross-env-shell": "src/bin/cross-env-shell.js"
+      },
+      "engines": {
+        "node": ">=10.14",
+        "npm": ">=6",
+        "yarn": ">=1"
+      }
+    },
     "node_modules/cross-spawn": {
       "version": "7.0.6",
       "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
       "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "path-key": "^3.1.0",
@@ -5380,6 +5694,15 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/detect-gpu": {
+      "version": "5.0.70",
+      "resolved": "https://registry.npmjs.org/detect-gpu/-/detect-gpu-5.0.70.tgz",
+      "integrity": "sha512-bqerEP1Ese6nt3rFkwPnGbsUF9a4q+gMmpTVVOEzoCyeCc+y7/RvJnQZJx1JwhgQI5Ntg0Kgat8Uu7XpBqnz1w==",
+      "license": "MIT",
+      "dependencies": {
+        "webgl-constants": "^1.1.1"
+      }
+    },
     "node_modules/detect-libc": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.1.tgz",
@@ -5516,6 +5839,12 @@
         "url": "https://dotenvx.com"
       }
     },
+    "node_modules/draco3d": {
+      "version": "1.5.7",
+      "resolved": "https://registry.npmjs.org/draco3d/-/draco3d-1.5.7.tgz",
+      "integrity": "sha512-m6WCKt/erDXcw+70IJXnG7M3awwQPAsZvJGX5zY7beBqpELw6RDGkYVU0W43AFxye4pDZ5i2Lbyc/NNGqwjUVQ==",
+      "license": "Apache-2.0"
+    },
     "node_modules/duck": {
       "version": "0.1.12",
       "resolved": "https://registry.npmjs.org/duck/-/duck-0.1.12.tgz",
@@ -6374,6 +6703,12 @@
         "reusify": "^1.0.4"
       }
     },
+    "node_modules/fflate": {
+      "version": "0.8.2",
+      "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.8.2.tgz",
+      "integrity": "sha512-cPJU47OaAoCbg0pBvzsgpTPhmhqI5eJjh/JIu8tPj5q+T7iLvW/JAYUqmE7KOB4R1ZyEhzBaIQpQpardBF5z8A==",
+      "license": "MIT"
+    },
     "node_modules/file-entry-cache": {
       "version": "8.0.0",
       "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz",
@@ -6677,6 +7012,12 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/glsl-noise": {
+      "version": "0.0.0",
+      "resolved": "https://registry.npmjs.org/glsl-noise/-/glsl-noise-0.0.0.tgz",
+      "integrity": "sha512-b/ZCF6amfAUb7dJM/MxRs7AetQEahYzJ8PtgfrmEdtw6uyGOr+ZSGtgjFm6mfsBkxJ4d2W7kg+Nlqzqvn3Bc0w==",
+      "license": "MIT"
+    },
     "node_modules/goober": {
       "version": "2.1.16",
       "resolved": "https://registry.npmjs.org/goober/-/goober-2.1.16.tgz",
@@ -6813,6 +7154,12 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/hls.js": {
+      "version": "1.6.13",
+      "resolved": "https://registry.npmjs.org/hls.js/-/hls.js-1.6.13.tgz",
+      "integrity": "sha512-hNEzjZNHf5bFrUNvdS4/1RjIanuJ6szpWNfTaX5I6WfGynWXGT7K/YQLYtemSvFExzeMdgdE4SsyVLJbd5PcZA==",
+      "license": "Apache-2.0"
+    },
     "node_modules/hoist-non-react-statics": {
       "version": "3.3.2",
       "resolved": "https://registry.npmjs.org/hoist-non-react-statics/-/hoist-non-react-statics-3.3.2.tgz",
@@ -6872,6 +7219,26 @@
         "node": ">=0.10.0"
       }
     },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
     "node_modules/ignore": {
       "version": "5.3.2",
       "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
@@ -7217,6 +7584,12 @@
       "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==",
       "license": "MIT"
     },
+    "node_modules/is-promise": {
+      "version": "2.2.2",
+      "resolved": "https://registry.npmjs.org/is-promise/-/is-promise-2.2.2.tgz",
+      "integrity": "sha512-+lP4/6lKUBfQjZ2pdxThZvLUAafmZb8OAxFb8XXtiQmS35INgr85hdOGoEs124ez1FCnZJt6jau/T+alh58QFQ==",
+      "license": "MIT"
+    },
     "node_modules/is-regex": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/is-regex/-/is-regex-1.2.1.tgz",
@@ -7373,7 +7746,6 @@
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
       "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
-      "dev": true,
       "license": "ISC"
     },
     "node_modules/isomorphic-dompurify": {
@@ -7407,6 +7779,27 @@
         "node": ">= 0.4"
       }
     },
+    "node_modules/its-fine": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/its-fine/-/its-fine-2.0.0.tgz",
+      "integrity": "sha512-KLViCmWx94zOvpLwSlsx6yOCeMhZYaxrJV87Po5k/FoZzcPSahvK5qJ7fYhS61sZi5ikmh2S3Hz55A2l3U69ng==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/react-reconciler": "^0.28.9"
+      },
+      "peerDependencies": {
+        "react": "^19.0.0"
+      }
+    },
+    "node_modules/its-fine/node_modules/@types/react-reconciler": {
+      "version": "0.28.9",
+      "resolved": "https://registry.npmjs.org/@types/react-reconciler/-/react-reconciler-0.28.9.tgz",
+      "integrity": "sha512-HHM3nxyUZ3zAylX8ZEyrDNd2XZOnQ0D5XfunJF5FLQnZbHHYq4UWvW1QfelQNXv1ICNkwYhfxjwfnqivYB6bFg==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@types/react": "*"
+      }
+    },
     "node_modules/jiti": {
       "version": "2.6.0",
       "resolved": "https://registry.npmjs.org/jiti/-/jiti-2.6.0.tgz",
@@ -7901,6 +8294,16 @@
         "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0"
       }
     },
+    "node_modules/maath": {
+      "version": "0.10.8",
+      "resolved": "https://registry.npmjs.org/maath/-/maath-0.10.8.tgz",
+      "integrity": "sha512-tRvbDF0Pgqz+9XUa4jjfgAQ8/aPKmQdWXilFu2tMy4GWj4NOsx99HlULO4IeREfbO3a0sA145DZYyvXPkybm0g==",
+      "license": "MIT",
+      "peerDependencies": {
+        "@types/three": ">=0.134.0",
+        "three": ">=0.134.0"
+      }
+    },
     "node_modules/magic-string": {
       "version": "0.30.19",
       "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.19.tgz",
@@ -7969,6 +8372,21 @@
         "node": ">= 8"
       }
     },
+    "node_modules/meshline": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/meshline/-/meshline-3.3.1.tgz",
+      "integrity": "sha512-/TQj+JdZkeSUOl5Mk2J7eLcYTLiQm2IDzmlSvYm7ov15anEcDJ92GHqqazxTSreeNgfnYu24kiEvvv0WlbCdFQ==",
+      "license": "MIT",
+      "peerDependencies": {
+        "three": ">=0.137"
+      }
+    },
+    "node_modules/meshoptimizer": {
+      "version": "0.22.0",
+      "resolved": "https://registry.npmjs.org/meshoptimizer/-/meshoptimizer-0.22.0.tgz",
+      "integrity": "sha512-IebiK79sqIy+E4EgOr+CAw+Ke8hAspXKzBd0JdgEmPHiAwmvEj2S4h1rfvo+o/BnfEYd/jAOg5IeeIjzlzSnDg==",
+      "license": "MIT"
+    },
     "node_modules/micromatch": {
       "version": "4.0.8",
       "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
@@ -8468,7 +8886,6 @@
       "version": "3.1.1",
       "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
       "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=8"
@@ -8564,6 +8981,12 @@
         "node": "^10 || ^12 || >=14"
       }
     },
+    "node_modules/potpack": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/potpack/-/potpack-1.0.2.tgz",
+      "integrity": "sha512-choctRBIV9EMT9WGAZHn3V7t0Z2pMQyl0EZE6pFc/6ml3ssw7Dlf/oAOvFwjm1HVsqfQN8GfeFyJ+d8tRzqueQ==",
+      "license": "ISC"
+    },
     "node_modules/prelude-ls": {
       "version": "1.2.1",
       "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz",
@@ -8734,6 +9157,16 @@
       "integrity": "sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==",
       "license": "MIT"
     },
+    "node_modules/promise-worker-transferable": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/promise-worker-transferable/-/promise-worker-transferable-1.0.4.tgz",
+      "integrity": "sha512-bN+0ehEnrXfxV2ZQvU2PetO0n4gqBD4ulq3MI1WOPLgr7/Mg9yRQkX5+0v1vagr74ZTsl7XtzlaYDo2EuCeYJw==",
+      "license": "Apache-2.0",
+      "dependencies": {
+        "is-promise": "^2.1.0",
+        "lie": "^3.0.2"
+      }
+    },
     "node_modules/prop-types": {
       "version": "15.8.1",
       "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz",
@@ -8944,6 +9377,27 @@
         "react-dom": "^19.0.0"
       }
     },
+    "node_modules/react-reconciler": {
+      "version": "0.31.0",
+      "resolved": "https://registry.npmjs.org/react-reconciler/-/react-reconciler-0.31.0.tgz",
+      "integrity": "sha512-7Ob7Z+URmesIsIVRjnLoDGwBEG/tVitidU0nMsqX/eeJaLY89RISO/10ERe0MqmzuKUUB1rmY+h1itMbUHg9BQ==",
+      "license": "MIT",
+      "dependencies": {
+        "scheduler": "^0.25.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      },
+      "peerDependencies": {
+        "react": "^19.0.0"
+      }
+    },
+    "node_modules/react-reconciler/node_modules/scheduler": {
+      "version": "0.25.0",
+      "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.25.0.tgz",
+      "integrity": "sha512-xFVuu11jh+xcO7JOAGJNOXld8/TcEHK/4CituBUeUb5hqxJLj9YuemAEuvm9gQ/+pgXYfbQuqAkiYu+u7YEsNA==",
+      "license": "MIT"
+    },
     "node_modules/react-redux": {
       "version": "9.2.0",
       "resolved": "https://registry.npmjs.org/react-redux/-/react-redux-9.2.0.tgz",
@@ -9046,6 +9500,21 @@
         }
       }
     },
+    "node_modules/react-use-measure": {
+      "version": "2.1.7",
+      "resolved": "https://registry.npmjs.org/react-use-measure/-/react-use-measure-2.1.7.tgz",
+      "integrity": "sha512-KrvcAo13I/60HpwGO5jpW7E9DfusKyLPLvuHlUyP5zqnmAPhNc6qTRjUQrdTADl0lpPpDVU2/Gg51UlOGHXbdg==",
+      "license": "MIT",
+      "peerDependencies": {
+        "react": ">=16.13",
+        "react-dom": ">=16.13"
+      },
+      "peerDependenciesMeta": {
+        "react-dom": {
+          "optional": true
+        }
+      }
+    },
     "node_modules/react-window": {
       "version": "2.1.1",
       "resolved": "https://registry.npmjs.org/react-window/-/react-window-2.1.1.tgz",
@@ -9510,7 +9979,6 @@
       "version": "2.0.0",
       "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
       "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
-      "dev": true,
       "license": "MIT",
       "dependencies": {
         "shebang-regex": "^3.0.0"
@@ -9523,7 +9991,6 @@
       "version": "3.0.0",
       "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
       "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
-      "dev": true,
       "license": "MIT",
       "engines": {
         "node": ">=8"
@@ -9674,6 +10141,32 @@
       "dev": true,
       "license": "MIT"
     },
+    "node_modules/stats-gl": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/stats-gl/-/stats-gl-2.4.2.tgz",
+      "integrity": "sha512-g5O9B0hm9CvnM36+v7SFl39T7hmAlv541tU81ME8YeSb3i1CIP5/QdDeSB3A0la0bKNHpxpwxOVRo2wFTYEosQ==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/three": "*",
+        "three": "^0.170.0"
+      },
+      "peerDependencies": {
+        "@types/three": "*",
+        "three": "*"
+      }
+    },
+    "node_modules/stats-gl/node_modules/three": {
+      "version": "0.170.0",
+      "resolved": "https://registry.npmjs.org/three/-/three-0.170.0.tgz",
+      "integrity": "sha512-FQK+LEpYc0fBD+J8g6oSEyyNzjp+Q7Ks1C568WWaoMRLW+TkNNWmenWeGgJjV105Gd+p/2ql1ZcjYvNiPZBhuQ==",
+      "license": "MIT"
+    },
+    "node_modules/stats.js": {
+      "version": "0.17.0",
+      "resolved": "https://registry.npmjs.org/stats.js/-/stats.js-0.17.0.tgz",
+      "integrity": "sha512-hNKz8phvYLPEcRkeG1rsGmV5ChMjKDAWU7/OJJdDErPBNChQXxCo3WZurGpnWc6gZhAzEPFad1aVgyOANH1sMw==",
+      "license": "MIT"
+    },
     "node_modules/stop-iteration-iterator": {
       "version": "1.1.0",
       "resolved": "https://registry.npmjs.org/stop-iteration-iterator/-/stop-iteration-iterator-1.1.0.tgz",
@@ -9882,6 +10375,15 @@
         "url": "https://github.com/sponsors/ljharb"
       }
     },
+    "node_modules/suspend-react": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/suspend-react/-/suspend-react-0.1.3.tgz",
+      "integrity": "sha512-aqldKgX9aZqpoDp3e8/BZ8Dm7x1pJl+qI3ZKxDN0i/IQTWUwBx/ManmlVJ3wowqbno6c2bmiIfs+Um6LbsjJyQ==",
+      "license": "MIT",
+      "peerDependencies": {
+        "react": ">=17.0"
+      }
+    },
     "node_modules/symbol-tree": {
       "version": "3.2.4",
       "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
@@ -9952,6 +10454,44 @@
         "node": ">=18"
       }
     },
+    "node_modules/three": {
+      "version": "0.180.0",
+      "resolved": "https://registry.npmjs.org/three/-/three-0.180.0.tgz",
+      "integrity": "sha512-o+qycAMZrh+TsE01GqWUxUIKR1AL0S8pq7zDkYOQw8GqfX8b8VoCKYUoHbhiX5j+7hr8XsuHDVU6+gkQJQKg9w==",
+      "license": "MIT"
+    },
+    "node_modules/three-mesh-bvh": {
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/three-mesh-bvh/-/three-mesh-bvh-0.8.3.tgz",
+      "integrity": "sha512-4G5lBaF+g2auKX3P0yqx+MJC6oVt6sB5k+CchS6Ob0qvH0YIhuUk1eYr7ktsIpY+albCqE80/FVQGV190PmiAg==",
+      "license": "MIT",
+      "peerDependencies": {
+        "three": ">= 0.159.0"
+      }
+    },
+    "node_modules/three-stdlib": {
+      "version": "2.36.0",
+      "resolved": "https://registry.npmjs.org/three-stdlib/-/three-stdlib-2.36.0.tgz",
+      "integrity": "sha512-kv0Byb++AXztEGsULgMAs8U2jgUdz6HPpAB/wDJnLiLlaWQX2APHhiTJIN7rqW+Of0eRgcp7jn05U1BsCP3xBA==",
+      "license": "MIT",
+      "dependencies": {
+        "@types/draco3d": "^1.4.0",
+        "@types/offscreencanvas": "^2019.6.4",
+        "@types/webxr": "^0.5.2",
+        "draco3d": "^1.4.1",
+        "fflate": "^0.6.9",
+        "potpack": "^1.0.1"
+      },
+      "peerDependencies": {
+        "three": ">=0.128.0"
+      }
+    },
+    "node_modules/three-stdlib/node_modules/fflate": {
+      "version": "0.6.10",
+      "resolved": "https://registry.npmjs.org/fflate/-/fflate-0.6.10.tgz",
+      "integrity": "sha512-IQrh3lEPM93wVCEczc9SaAOvkmcoQn/G8Bo1e8ZPlY3X3bnAxWaBdvTdvM1hP62iZp0BXWDy4vTAy4fF0+Dlpg==",
+      "license": "MIT"
+    },
     "node_modules/tiny-invariant": {
       "version": "1.3.3",
       "resolved": "https://registry.npmjs.org/tiny-invariant/-/tiny-invariant-1.3.3.tgz",
@@ -10068,6 +10608,36 @@
         "node": ">=20"
       }
     },
+    "node_modules/troika-three-text": {
+      "version": "0.52.4",
+      "resolved": "https://registry.npmjs.org/troika-three-text/-/troika-three-text-0.52.4.tgz",
+      "integrity": "sha512-V50EwcYGruV5rUZ9F4aNsrytGdKcXKALjEtQXIOBfhVoZU9VAqZNIoGQ3TMiooVqFAbR1w15T+f+8gkzoFzawg==",
+      "license": "MIT",
+      "dependencies": {
+        "bidi-js": "^1.0.2",
+        "troika-three-utils": "^0.52.4",
+        "troika-worker-utils": "^0.52.0",
+        "webgl-sdf-generator": "1.1.1"
+      },
+      "peerDependencies": {
+        "three": ">=0.125.0"
+      }
+    },
+    "node_modules/troika-three-utils": {
+      "version": "0.52.4",
+      "resolved": "https://registry.npmjs.org/troika-three-utils/-/troika-three-utils-0.52.4.tgz",
+      "integrity": "sha512-NORAStSVa/BDiG52Mfudk4j1FG4jC4ILutB3foPnfGbOeIs9+G5vZLa0pnmnaftZUGm4UwSoqEpWdqvC7zms3A==",
+      "license": "MIT",
+      "peerDependencies": {
+        "three": ">=0.125.0"
+      }
+    },
+    "node_modules/troika-worker-utils": {
+      "version": "0.52.0",
+      "resolved": "https://registry.npmjs.org/troika-worker-utils/-/troika-worker-utils-0.52.0.tgz",
+      "integrity": "sha512-W1CpvTHykaPH5brv5VHLfQo9D1OYuo0cSBEUQFFT/nBUzM8iD6Lq2/tgG/f1OelbAS1WtaTPQzE5uM49egnngw==",
+      "license": "MIT"
+    },
     "node_modules/ts-api-utils": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/ts-api-utils/-/ts-api-utils-2.1.0.tgz",
@@ -10100,6 +10670,15 @@
       "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
       "license": "0BSD"
     },
+    "node_modules/tunnel-rat": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/tunnel-rat/-/tunnel-rat-0.1.2.tgz",
+      "integrity": "sha512-lR5VHmkPhzdhrM092lI2nACsLO4QubF0/yoOhzX7c+wIpbN1GjHNzCc91QlpxBi+cnx8vVJ+Ur6vL5cEoQPFpQ==",
+      "license": "MIT",
+      "dependencies": {
+        "zustand": "^4.3.2"
+      }
+    },
     "node_modules/tw-animate-css": {
       "version": "1.4.0",
       "resolved": "https://registry.npmjs.org/tw-animate-css/-/tw-animate-css-1.4.0.tgz",
@@ -10350,6 +10929,15 @@
       "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
       "license": "MIT"
     },
+    "node_modules/utility-types": {
+      "version": "3.11.0",
+      "resolved": "https://registry.npmjs.org/utility-types/-/utility-types-3.11.0.tgz",
+      "integrity": "sha512-6Z7Ma2aVEWisaL6TvBCy7P8rm2LQoPv6dJ7ecIaIixHcwfbJ0x7mWdbcwlIM5IGQxPZSFYeqRCqlOOeKoJYMkw==",
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
     "node_modules/uuid": {
       "version": "13.0.0",
       "resolved": "https://registry.npmjs.org/uuid/-/uuid-13.0.0.tgz",
@@ -10397,6 +10985,17 @@
         "node": ">=18"
       }
     },
+    "node_modules/webgl-constants": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/webgl-constants/-/webgl-constants-1.1.1.tgz",
+      "integrity": "sha512-LkBXKjU5r9vAW7Gcu3T5u+5cvSvh5WwINdr0C+9jpzVB41cjQAP5ePArDtk/WHYdVj0GefCgM73BA7FlIiNtdg=="
+    },
+    "node_modules/webgl-sdf-generator": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/webgl-sdf-generator/-/webgl-sdf-generator-1.1.1.tgz",
+      "integrity": "sha512-9Z0JcMTFxeE+b2x1LJTdnaT8rT8aEp7MVxkNwoycNmJWwPdzoXzMh0BjJSh/AEFP+KPYZUli814h8bJZFIZ2jA==",
+      "license": "MIT"
+    },
     "node_modules/webidl-conversions": {
       "version": "8.0.0",
       "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-8.0.0.tgz",
@@ -10444,7 +11043,6 @@
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
       "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
-      "dev": true,
       "license": "ISC",
       "dependencies": {
         "isexe": "^2.0.0"
diff --git a/frontend/package.json b/frontend/package.json
index bc9e8d1d..522ccd29 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -38,11 +38,14 @@
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-switch": "^1.2.6",
     "@radix-ui/react-tabs": "^1.1.13",
+    "@react-three/drei": "^10.7.6",
+    "@react-three/fiber": "^9.4.0",
     "@tanstack/react-query": "^5.86.0",
     "@tanstack/react-table": "^8.21.3",
     "@types/d3": "^7.4.3",
     "@types/leaflet": "^1.9.21",
     "@types/react-window": "^1.8.8",
+    "@types/three": "^0.180.0",
     "@xyflow/react": "^12.8.4",
     "axios": "^1.11.0",
     "class-variance-authority": "^0.7.1",
@@ -72,6 +75,7 @@
     "sheetjs-style": "^0.15.8",
     "sonner": "^2.0.7",
     "tailwind-merge": "^3.3.1",
+    "three": "^0.180.0",
     "uuid": "^13.0.0",
     "xlsx": "^0.18.5",
     "zod": "^4.1.5"

From 5093d336c0f54b7b6f68b33f1d60d30d129166a9 Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 16:43:04 +0900
Subject: [PATCH 04/10] =?UTF-8?q?=EB=8C=80=EC=8B=9C=EB=B3=B4=EB=93=9C?=
 =?UTF-8?q?=EC=97=90=20=ED=99=94=EB=A9=B4=20=ED=95=A0=EB=8B=B9=20=EA=B5=AC?=
 =?UTF-8?q?=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../admin/dashboard/DashboardDesigner.tsx     | 254 +++++++-------
 .../admin/dashboard/DashboardSaveModal.tsx    | 321 ++++++++++++++++++
 .../admin/dashboard/ElementConfigModal.tsx    |  13 +-
 3 files changed, 457 insertions(+), 131 deletions(-)
 create mode 100644 frontend/components/admin/dashboard/DashboardSaveModal.tsx

diff --git a/frontend/components/admin/dashboard/DashboardDesigner.tsx b/frontend/components/admin/dashboard/DashboardDesigner.tsx
index 95eea2f2..7f19bbc4 100644
--- a/frontend/components/admin/dashboard/DashboardDesigner.tsx
+++ b/frontend/components/admin/dashboard/DashboardDesigner.tsx
@@ -6,10 +6,14 @@ import { DashboardCanvas } from "./DashboardCanvas";
 import { DashboardTopMenu } from "./DashboardTopMenu";
 import { ElementConfigModal } from "./ElementConfigModal";
 import { ListWidgetConfigModal } from "./widgets/ListWidgetConfigModal";
-import { MenuAssignmentModal } from "./MenuAssignmentModal";
+import { DashboardSaveModal } from "./DashboardSaveModal";
 import { DashboardElement, ElementType, ElementSubtype } from "./types";
 import { GRID_CONFIG, snapToGrid, snapSizeToGrid, calculateCellSize } from "./gridUtils";
 import { Resolution, RESOLUTIONS, detectScreenResolution } from "./ResolutionSelector";
+import { useMenu } from "@/contexts/MenuContext";
+import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle } from "@/components/ui/dialog";
+import { Button } from "@/components/ui/button";
+import { CheckCircle2 } from "lucide-react";
 
 interface DashboardDesignerProps {
   dashboardId?: string;
@@ -24,6 +28,7 @@ interface DashboardDesignerProps {
  */
 export default function DashboardDesigner({ dashboardId: initialDashboardId }: DashboardDesignerProps = {}) {
   const router = useRouter();
+  const { refreshMenus } = useMenu();
   const [elements, setElements] = useState<DashboardElement[]>([]);
   const [selectedElement, setSelectedElement] = useState<string | null>(null);
   const [elementCounter, setElementCounter] = useState(0);
@@ -34,9 +39,10 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
   const [canvasBackgroundColor, setCanvasBackgroundColor] = useState<string>("#f9fafb");
   const canvasRef = useRef<HTMLDivElement>(null);
 
-  // 메뉴 할당 모달 상태
-  const [menuAssignmentModalOpen, setMenuAssignmentModalOpen] = useState(false);
-  const [savedDashboardInfo, setSavedDashboardInfo] = useState<{ id: string; title: string } | null>(null);
+  // 저장 모달 상태
+  const [saveModalOpen, setSaveModalOpen] = useState(false);
+  const [dashboardDescription, setDashboardDescription] = useState<string>("");
+  const [successModalOpen, setSuccessModalOpen] = useState(false);
 
   // 화면 해상도 자동 감지
   const [screenResolution] = useState<Resolution>(() => detectScreenResolution());
@@ -308,117 +314,93 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
   );
 
   // 레이아웃 저장
-  const saveLayout = useCallback(async () => {
+  const saveLayout = useCallback(() => {
     if (elements.length === 0) {
       alert("저장할 요소가 없습니다. 차트나 위젯을 추가해주세요.");
       return;
     }
 
-    try {
-      // 실제 API 호출
-      const { dashboardApi } = await import("@/lib/api/dashboard");
-
-      const elementsData = elements.map((el) => ({
-        id: el.id,
-        type: el.type,
-        subtype: el.subtype,
-        position: el.position,
-        size: el.size,
-        title: el.title,
-        content: el.content,
-        dataSource: el.dataSource,
-        chartConfig: el.chartConfig,
-      }));
-
-      let savedDashboard;
-
-      if (dashboardId) {
-        // 기존 대시보드 업데이트
-        console.log("💾 저장 시작 - 현재 resolution 상태:", resolution);
-        console.log("💾 저장 시작 - 현재 배경색 상태:", canvasBackgroundColor);
-
-        const updateData = {
-          elements: elementsData,
-          settings: {
-            resolution,
-            backgroundColor: canvasBackgroundColor,
-          },
-        };
-
-        console.log("💾 저장할 데이터:", updateData);
-        console.log("💾 저장할 settings:", updateData.settings);
-
-        savedDashboard = await dashboardApi.updateDashboard(dashboardId, updateData);
-
-        console.log("✅ 저장된 대시보드:", savedDashboard);
-        console.log("✅ 저장된 settings:", (savedDashboard as any).settings);
-
-        // 메뉴 할당 모달 띄우기 (기존 대시보드 업데이트 시에도)
-        setSavedDashboardInfo({
-          id: savedDashboard.id,
-          title: savedDashboard.title,
-        });
-        setMenuAssignmentModalOpen(true);
-      } else {
-        // 새 대시보드 생성
-        const title = prompt("대시보드 제목을 입력하세요:", "새 대시보드");
-        if (!title) return;
-
-        const description = prompt("대시보드 설명을 입력하세요 (선택사항):", "");
-
-        const dashboardData = {
-          title,
-          description: description || undefined,
-          isPublic: false,
-          elements: elementsData,
-          settings: {
-            resolution,
-            backgroundColor: canvasBackgroundColor,
-          },
-        };
-
-        savedDashboard = await dashboardApi.createDashboard(dashboardData);
-
-        // 대시보드 ID 설정 (다음 저장 시 업데이트 모드로 전환)
-        setDashboardId(savedDashboard.id);
-        setDashboardTitle(savedDashboard.title);
-
-        // 메뉴 할당 모달 띄우기
-        setSavedDashboardInfo({
-          id: savedDashboard.id,
-          title: savedDashboard.title,
-        });
-        setMenuAssignmentModalOpen(true);
-      }
-    } catch (error) {
-      const errorMessage = error instanceof Error ? error.message : "알 수 없는 오류";
-      alert(`대시보드 저장 중 오류가 발생했습니다.\n\n오류: ${errorMessage}\n\n관리자에게 문의하세요.`);
-    }
-  }, [elements, dashboardId, router, resolution, canvasBackgroundColor]);
-
-  // 메뉴 할당 처리
-  const handleMenuAssignment = useCallback(
-    async (assignToMenu: boolean, menuId?: string, menuType?: "0" | "1") => {
-      if (!savedDashboardInfo) return;
+    // 저장 모달 열기
+    setSaveModalOpen(true);
+  }, [elements]);
 
+  // 저장 처리
+  const handleSave = useCallback(
+    async (data: {
+      title: string;
+      description: string;
+      assignToMenu: boolean;
+      menuType?: "admin" | "user";
+      menuId?: string;
+    }) => {
       try {
-        if (assignToMenu && menuId) {
-          // 메뉴 API를 통해 대시보드 URL 할당
+        const { dashboardApi } = await import("@/lib/api/dashboard");
+
+        const elementsData = elements.map((el) => ({
+          id: el.id,
+          type: el.type,
+          subtype: el.subtype,
+          position: el.position,
+          size: el.size,
+          title: el.title,
+          content: el.content,
+          dataSource: el.dataSource,
+          chartConfig: el.chartConfig,
+          listConfig: el.listConfig,
+        }));
+
+        let savedDashboard;
+
+        if (dashboardId) {
+          // 기존 대시보드 업데이트
+          const updateData = {
+            title: data.title,
+            description: data.description || undefined,
+            elements: elementsData,
+            settings: {
+              resolution,
+              backgroundColor: canvasBackgroundColor,
+            },
+          };
+
+          savedDashboard = await dashboardApi.updateDashboard(dashboardId, updateData);
+        } else {
+          // 새 대시보드 생성
+          const dashboardData = {
+            title: data.title,
+            description: data.description || undefined,
+            isPublic: false,
+            elements: elementsData,
+            settings: {
+              resolution,
+              backgroundColor: canvasBackgroundColor,
+            },
+          };
+
+          savedDashboard = await dashboardApi.createDashboard(dashboardData);
+          setDashboardId(savedDashboard.id);
+        }
+
+        setDashboardTitle(savedDashboard.title);
+        setDashboardDescription(data.description);
+
+        // 메뉴 할당 처리
+        if (data.assignToMenu && data.menuId) {
           const { menuApi } = await import("@/lib/api/menu");
 
           // 대시보드 URL 생성 (관리자 메뉴면 mode=admin 추가)
-          let dashboardUrl = `/dashboard/${savedDashboardInfo.id}`;
-          if (menuType === "0") {
+          let dashboardUrl = `/dashboard/${savedDashboard.id}`;
+          if (data.menuType === "admin") {
             dashboardUrl += "?mode=admin";
           }
 
           // 메뉴 정보 가져오기
-          const menuResponse = await menuApi.getMenuInfo(menuId);
+          const menuResponse = await menuApi.getMenuInfo(data.menuId);
+
           if (menuResponse.success && menuResponse.data) {
             const menu = menuResponse.data;
 
-            // 메뉴 URL 업데이트
-            await menuApi.updateMenu(menuId, {
+            const updateData = {
               menuUrl: dashboardUrl,
               parentObjId: menu.parent_obj_id || menu.PARENT_OBJ_ID || "0",
               menuNameKor: menu.menu_name_kor || menu.MENU_NAME_KOR || "",
@@ -428,24 +410,25 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
               status: menu.status || menu.STATUS || "active",
               companyCode: menu.company_code || menu.COMPANY_CODE || "",
               langKey: menu.lang_key || menu.LANG_KEY || "",
-            });
+            };
 
-            alert(`메뉴 "${menu.menu_name_kor || menu.MENU_NAME_KOR}"에 대시보드가 할당되었습니다!`);
+            // 메뉴 URL 업데이트
+            await menuApi.updateMenu(data.menuId, updateData);
+
+            // 메뉴 목록 새로고침
+            await refreshMenus();
           }
         }
 
-        // 모달 닫기
-        setMenuAssignmentModalOpen(false);
-        setSavedDashboardInfo(null);
-
-        // 대시보드 뷰어로 이동
-        router.push(`/dashboard/${savedDashboardInfo.id}`);
+        // 성공 모달 표시
+        setSuccessModalOpen(true);
       } catch (error) {
-        console.error("메뉴 할당 오류:", error);
-        alert("메뉴 할당 중 오류가 발생했습니다.");
+        const errorMessage = error instanceof Error ? error.message : "알 수 없는 오류";
+        alert(`대시보드 저장 중 오류가 발생했습니다.\n\n오류: ${errorMessage}`);
+        throw error;
       }
     },
-    [savedDashboardInfo, router],
+    [elements, dashboardId, resolution, canvasBackgroundColor, router],
   );
 
   // 로딩 중이면 로딩 화면 표시
@@ -523,21 +506,44 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
         </>
       )}
 
-      {/* 메뉴 할당 모달 */}
-      {savedDashboardInfo && (
-        <MenuAssignmentModal
-          isOpen={menuAssignmentModalOpen}
-          onClose={() => {
-            setMenuAssignmentModalOpen(false);
-            setSavedDashboardInfo(null);
-            // 모달을 그냥 닫으면 대시보드 뷰어로 이동
-            router.push(`/dashboard/${savedDashboardInfo.id}`);
-          }}
-          onConfirm={handleMenuAssignment}
-          dashboardId={savedDashboardInfo.id}
-          dashboardTitle={savedDashboardInfo.title}
-        />
-      )}
+      {/* 저장 모달 */}
+      <DashboardSaveModal
+        isOpen={saveModalOpen}
+        onClose={() => setSaveModalOpen(false)}
+        onSave={handleSave}
+        initialTitle={dashboardTitle}
+        initialDescription={dashboardDescription}
+        isEditing={!!dashboardId}
+      />
+
+      {/* 저장 성공 모달 */}
+      <Dialog
+        open={successModalOpen}
+        onOpenChange={() => {
+          setSuccessModalOpen(false);
+          router.push("/admin/dashboard");
+        }}
+      >
+        <DialogContent className="sm:max-w-md">
+          <DialogHeader>
+            <div className="mx-auto flex h-12 w-12 items-center justify-center rounded-full bg-green-100">
+              <CheckCircle2 className="h-6 w-6 text-green-600" />
+            </div>
+            <DialogTitle className="text-center">저장 완료</DialogTitle>
+            <DialogDescription className="text-center">대시보드가 성공적으로 저장되었습니다.</DialogDescription>
+          </DialogHeader>
+          <div className="flex justify-center pt-4">
+            <Button
+              onClick={() => {
+                setSuccessModalOpen(false);
+                router.push("/admin/dashboard");
+              }}
+            >
+              확인
+            </Button>
+          </div>
+        </DialogContent>
+      </Dialog>
     </div>
   );
 }
diff --git a/frontend/components/admin/dashboard/DashboardSaveModal.tsx b/frontend/components/admin/dashboard/DashboardSaveModal.tsx
new file mode 100644
index 00000000..34837384
--- /dev/null
+++ b/frontend/components/admin/dashboard/DashboardSaveModal.tsx
@@ -0,0 +1,321 @@
+"use client";
+
+import { useState, useEffect } from "react";
+import { Dialog, DialogContent, DialogHeader, DialogTitle, DialogFooter } from "@/components/ui/dialog";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Textarea } from "@/components/ui/textarea";
+import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group";
+import {
+  Select,
+  SelectContent,
+  SelectItem,
+  SelectTrigger,
+  SelectValue,
+  SelectGroup,
+  SelectLabel,
+} from "@/components/ui/select";
+import { Loader2, Save } from "lucide-react";
+import { menuApi } from "@/lib/api/menu";
+
+interface MenuItem {
+  id: string;
+  name: string;
+  url?: string;
+  parent_id?: string;
+  children?: MenuItem[];
+}
+
+interface DashboardSaveModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  onSave: (data: {
+    title: string;
+    description: string;
+    assignToMenu: boolean;
+    menuType?: "admin" | "user";
+    menuId?: string;
+  }) => Promise<void>;
+  initialTitle?: string;
+  initialDescription?: string;
+  isEditing?: boolean;
+}
+
+export function DashboardSaveModal({
+  isOpen,
+  onClose,
+  onSave,
+  initialTitle = "",
+  initialDescription = "",
+  isEditing = false,
+}: DashboardSaveModalProps) {
+  const [title, setTitle] = useState(initialTitle);
+  const [description, setDescription] = useState(initialDescription);
+  const [assignToMenu, setAssignToMenu] = useState(false);
+  const [menuType, setMenuType] = useState<"admin" | "user">("admin");
+  const [selectedMenuId, setSelectedMenuId] = useState<string>("");
+  const [adminMenus, setAdminMenus] = useState<MenuItem[]>([]);
+  const [userMenus, setUserMenus] = useState<MenuItem[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [loadingMenus, setLoadingMenus] = useState(false);
+
+  useEffect(() => {
+    if (isOpen) {
+      setTitle(initialTitle);
+      setDescription(initialDescription);
+      setAssignToMenu(false);
+      setMenuType("admin");
+      setSelectedMenuId("");
+      loadMenus();
+    }
+  }, [isOpen, initialTitle, initialDescription]);
+
+  const loadMenus = async () => {
+    setLoadingMenus(true);
+    try {
+      const [adminData, userData] = await Promise.all([menuApi.getAdminMenus(), menuApi.getUserMenus()]);
+
+      // API 응답이 배열인지 확인하고 처리
+      const adminMenuList = Array.isArray(adminData) ? adminData : adminData?.data || [];
+      const userMenuList = Array.isArray(userData) ? userData : userData?.data || [];
+
+      setAdminMenus(adminMenuList);
+      setUserMenus(userMenuList);
+    } catch (error) {
+      console.error("메뉴 목록 로드 실패:", error);
+      setAdminMenus([]);
+      setUserMenus([]);
+    } finally {
+      setLoadingMenus(false);
+    }
+  };
+
+  const flattenMenus = (
+    menus: MenuItem[],
+    prefix = "",
+    parentPath = "",
+  ): { id: string; label: string; uniqueKey: string }[] => {
+    if (!Array.isArray(menus)) {
+      return [];
+    }
+
+    const result: { id: string; label: string; uniqueKey: string }[] = [];
+    menus.forEach((menu, index) => {
+      // 메뉴 ID 추출 (objid 또는 id)
+      const menuId = (menu as any).objid || menu.id || "";
+      const uniqueKey = `${parentPath}-${menuId}-${index}`;
+
+      // 메뉴 이름 추출
+      const menuName =
+        menu.name ||
+        (menu as any).menu_name_kor ||
+        (menu as any).MENU_NAME_KOR ||
+        (menu as any).menuNameKor ||
+        (menu as any).title ||
+        "이름없음";
+
+      // lev 필드로 레벨 확인 (lev > 1인 메뉴만 추가)
+      const menuLevel = (menu as any).lev || 0;
+
+      if (menuLevel > 1) {
+        result.push({
+          id: menuId,
+          label: prefix + menuName,
+          uniqueKey,
+        });
+      }
+
+      // 하위 메뉴가 있으면 재귀 호출
+      if (menu.children && Array.isArray(menu.children) && menu.children.length > 0) {
+        result.push(...flattenMenus(menu.children, prefix + menuName + " > ", uniqueKey));
+      }
+    });
+
+    return result;
+  };
+
+  const handleSave = async () => {
+    if (!title.trim()) {
+      alert("대시보드 이름을 입력해주세요.");
+      return;
+    }
+
+    if (assignToMenu && !selectedMenuId) {
+      alert("메뉴를 선택해주세요.");
+      return;
+    }
+
+    setLoading(true);
+    try {
+      await onSave({
+        title: title.trim(),
+        description: description.trim(),
+        assignToMenu,
+        menuType: assignToMenu ? menuType : undefined,
+        menuId: assignToMenu ? selectedMenuId : undefined,
+      });
+      onClose();
+    } catch (error) {
+      console.error("저장 실패:", error);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  const currentMenus = menuType === "admin" ? adminMenus : userMenus;
+  const flatMenus = flattenMenus(currentMenus);
+
+  return (
+    <Dialog open={isOpen} onOpenChange={onClose}>
+      <DialogContent className="max-h-[90vh] max-w-2xl overflow-y-auto">
+        <DialogHeader>
+          <DialogTitle>{isEditing ? "대시보드 수정" : "대시보드 저장"}</DialogTitle>
+        </DialogHeader>
+
+        <div className="space-y-6 py-4">
+          {/* 대시보드 이름 */}
+          <div className="space-y-2">
+            <Label htmlFor="title">
+              대시보드 이름 <span className="text-red-500">*</span>
+            </Label>
+            <Input
+              id="title"
+              value={title}
+              onChange={(e) => setTitle(e.target.value)}
+              placeholder="예: 생산 현황 대시보드"
+              className="w-full"
+            />
+          </div>
+
+          {/* 대시보드 설명 */}
+          <div className="space-y-2">
+            <Label htmlFor="description">설명</Label>
+            <Textarea
+              id="description"
+              value={description}
+              onChange={(e) => setDescription(e.target.value)}
+              placeholder="대시보드에 대한 간단한 설명을 입력하세요"
+              rows={3}
+              className="w-full resize-none"
+            />
+          </div>
+
+          {/* 구분선 */}
+          <div className="border-t pt-4">
+            <h3 className="mb-3 text-sm font-semibold">메뉴 할당</h3>
+
+            {/* 메뉴 할당 여부 */}
+            <div className="space-y-4">
+              <RadioGroup
+                value={assignToMenu ? "yes" : "no"}
+                onValueChange={(value) => setAssignToMenu(value === "yes")}
+              >
+                <div className="flex items-center space-x-2">
+                  <RadioGroupItem value="no" id="assign-no" />
+                  <Label htmlFor="assign-no" className="cursor-pointer">
+                    메뉴에 할당하지 않음
+                  </Label>
+                </div>
+                <div className="flex items-center space-x-2">
+                  <RadioGroupItem value="yes" id="assign-yes" />
+                  <Label htmlFor="assign-yes" className="cursor-pointer">
+                    메뉴에 할당
+                  </Label>
+                </div>
+              </RadioGroup>
+
+              {/* 메뉴 할당 옵션 */}
+              {assignToMenu && (
+                <div className="ml-6 space-y-4 border-l-2 border-gray-200 pl-4">
+                  {/* 메뉴 타입 선택 */}
+                  <div className="space-y-2">
+                    <Label>메뉴 타입</Label>
+                    <RadioGroup value={menuType} onValueChange={(value) => setMenuType(value as "admin" | "user")}>
+                      <div className="flex items-center space-x-2">
+                        <RadioGroupItem value="admin" id="menu-admin" />
+                        <Label htmlFor="menu-admin" className="cursor-pointer">
+                          관리자 메뉴
+                        </Label>
+                      </div>
+                      <div className="flex items-center space-x-2">
+                        <RadioGroupItem value="user" id="menu-user" />
+                        <Label htmlFor="menu-user" className="cursor-pointer">
+                          사용자 메뉴
+                        </Label>
+                      </div>
+                    </RadioGroup>
+                  </div>
+
+                  {/* 메뉴 선택 */}
+                  <div className="space-y-2">
+                    <Label>메뉴 선택</Label>
+                    {loadingMenus ? (
+                      <div className="flex items-center justify-center py-4">
+                        <Loader2 className="h-5 w-5 animate-spin text-gray-400" />
+                        <span className="ml-2 text-sm text-gray-500">메뉴 목록 로딩 중...</span>
+                      </div>
+                    ) : (
+                      <div className="space-y-2">
+                        <Select value={selectedMenuId} onValueChange={setSelectedMenuId}>
+                          <SelectTrigger className="w-full">
+                            <SelectValue placeholder="메뉴를 선택하세요" />
+                          </SelectTrigger>
+                          <SelectContent className="z-[99999]">
+                            <SelectGroup>
+                              <SelectLabel>{menuType === "admin" ? "관리자 메뉴" : "사용자 메뉴"}</SelectLabel>
+                              {flatMenus.length === 0 ? (
+                                <div className="px-2 py-3 text-sm text-gray-500">사용 가능한 메뉴가 없습니다.</div>
+                              ) : (
+                                flatMenus.map((menu) => (
+                                  <SelectItem key={menu.uniqueKey} value={menu.id}>
+                                    {menu.label}
+                                  </SelectItem>
+                                ))
+                              )}
+                            </SelectGroup>
+                          </SelectContent>
+                        </Select>
+                        {selectedMenuId && (
+                          <div className="rounded-md bg-gray-50 p-2 text-sm text-gray-700">
+                            선택된 메뉴:{" "}
+                            <span className="font-medium">{flatMenus.find((m) => m.id === selectedMenuId)?.label}</span>
+                          </div>
+                        )}
+                      </div>
+                    )}
+                    {assignToMenu && selectedMenuId && (
+                      <p className="mt-1 text-xs text-gray-500">
+                        선택한 메뉴의 URL이 이 대시보드로 자동 설정됩니다.
+                        {menuType === "admin" && " (관리자 모드 파라미터 포함)"}
+                      </p>
+                    )}
+                  </div>
+                </div>
+              )}
+            </div>
+          </div>
+        </div>
+
+        <DialogFooter>
+          <Button variant="outline" onClick={onClose} disabled={loading}>
+            취소
+          </Button>
+          <Button onClick={handleSave} disabled={loading}>
+            {loading ? (
+              <>
+                <Loader2 className="mr-2 h-4 w-4 animate-spin" />
+                저장 중...
+              </>
+            ) : (
+              <>
+                <Save className="mr-2 h-4 w-4" />
+                저장
+              </>
+            )}
+          </Button>
+        </DialogFooter>
+      </DialogContent>
+    </Dialog>
+  );
+}
diff --git a/frontend/components/admin/dashboard/ElementConfigModal.tsx b/frontend/components/admin/dashboard/ElementConfigModal.tsx
index aa074317..ef2f1e1c 100644
--- a/frontend/components/admin/dashboard/ElementConfigModal.tsx
+++ b/frontend/components/admin/dashboard/ElementConfigModal.tsx
@@ -153,7 +153,8 @@ export function ElementConfigModal({ element, isOpen, onClose, onSave }: Element
   // customTitle이 변경되었는지 확인
   const isTitleChanged = customTitle.trim() !== (element.customTitle || "");
 
-  const canSave = isTitleChanged || // 제목만 변경해도 저장 가능
+  const canSave =
+    isTitleChanged || // 제목만 변경해도 저장 가능
     (isSimpleWidget
       ? // 간단한 위젯: 2단계에서 쿼리 테스트 후 저장 가능
         currentStep === 2 && queryResult && queryResult.rows.length > 0
@@ -201,18 +202,16 @@ export function ElementConfigModal({ element, isOpen, onClose, onSave }: Element
               <X className="h-5 w-5" />
             </Button>
           </div>
-          
+
           {/* 커스텀 제목 입력 */}
           <div className="mt-4">
-            <label className="block text-sm font-medium text-gray-700 mb-1">
-              위젯 제목 (선택사항)
-            </label>
+            <label className="mb-1 block text-sm font-medium text-gray-700">위젯 제목 (선택사항)</label>
             <input
               type="text"
               value={customTitle}
               onChange={(e) => setCustomTitle(e.target.value)}
-              placeholder={`예: 정비 일정 목록, 창고 위치 현황 등 (비워두면 자동 생성)`}
-              className="w-full rounded-md border border-gray-300 px-3 py-2 text-sm focus:border-primary focus:outline-none focus:ring-1 focus:ring-primary"
+              placeholder={"예: 정비 일정 목록, 창고 위치 현황 등 (비워두면 자동 생성)"}
+              className="focus:border-primary focus:ring-primary w-full rounded-md border border-gray-300 px-3 py-2 text-sm focus:ring-1 focus:outline-none"
             />
             <p className="mt-1 text-xs text-gray-500">
               💡 비워두면 테이블명으로 자동 생성됩니다 (예: "maintenance_schedules 목록")

From abed34ce9a70bdc9fce3c4b66f81c72998b1f454 Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 16:51:24 +0900
Subject: [PATCH 05/10] =?UTF-8?q?alert=20=EB=AA=A8=EB=8B=AC=20=EC=B2=98?=
 =?UTF-8?q?=EB=A6=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../admin/dashboard/DashboardDesigner.tsx     | 84 +++++++++++--------
 .../admin/dashboard/DashboardTopMenu.tsx      | 12 +--
 2 files changed, 51 insertions(+), 45 deletions(-)

diff --git a/frontend/components/admin/dashboard/DashboardDesigner.tsx b/frontend/components/admin/dashboard/DashboardDesigner.tsx
index 7f19bbc4..a9164370 100644
--- a/frontend/components/admin/dashboard/DashboardDesigner.tsx
+++ b/frontend/components/admin/dashboard/DashboardDesigner.tsx
@@ -12,6 +12,16 @@ import { GRID_CONFIG, snapToGrid, snapSizeToGrid, calculateCellSize } from "./gr
 import { Resolution, RESOLUTIONS, detectScreenResolution } from "./ResolutionSelector";
 import { useMenu } from "@/contexts/MenuContext";
 import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle } from "@/components/ui/dialog";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/components/ui/alert-dialog";
 import { Button } from "@/components/ui/button";
 import { CheckCircle2 } from "lucide-react";
 
@@ -43,6 +53,7 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
   const [saveModalOpen, setSaveModalOpen] = useState(false);
   const [dashboardDescription, setDashboardDescription] = useState<string>("");
   const [successModalOpen, setSuccessModalOpen] = useState(false);
+  const [clearConfirmOpen, setClearConfirmOpen] = useState(false);
 
   // 화면 해상도 자동 감지
   const [screenResolution] = useState<Resolution>(() => detectScreenResolution());
@@ -51,17 +62,12 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
   // resolution 변경 감지 및 요소 자동 조정
   const handleResolutionChange = useCallback(
     (newResolution: Resolution) => {
-      console.log("🎯 해상도 변경 요청:", newResolution);
       setResolution((prev) => {
-        console.log("🎯 이전 해상도:", prev);
-
         // 이전 해상도와 새 해상도의 캔버스 너비 비율 계산
         const oldConfig = RESOLUTIONS[prev];
         const newConfig = RESOLUTIONS[newResolution];
         const widthRatio = newConfig.width / oldConfig.width;
 
-        console.log("📐 너비 비율:", widthRatio, `(${oldConfig.width}px → ${newConfig.width}px)`);
-
         // 요소들의 위치와 크기를 비율에 맞춰 조정
         if (widthRatio !== 1 && elements.length > 0) {
           // 새 해상도의 셀 크기 계산
@@ -91,7 +97,6 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
             };
           });
 
-          console.log("✨ 요소 위치/크기 자동 조정 (그리드 스냅 적용):", adjustedElements.length, "개");
           setElements(adjustedElements);
         }
 
@@ -131,34 +136,21 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
   const loadDashboard = async (id: string) => {
     setIsLoading(true);
     try {
-      // console.log('🔄 대시보드 로딩:', id);
-
       const { dashboardApi } = await import("@/lib/api/dashboard");
       const dashboard = await dashboardApi.getDashboard(id);
 
-      // console.log('✅ 대시보드 로딩 완료:', dashboard);
-
       // 대시보드 정보 설정
       setDashboardId(dashboard.id);
       setDashboardTitle(dashboard.title);
 
       // 저장된 설정 복원
-      console.log("🔍 로드된 대시보드:", dashboard);
-      console.log("📦 저장된 settings:", (dashboard as any).settings);
-      console.log("🎯 settings 타입:", typeof (dashboard as any).settings);
-      console.log("🔍 resolution 값:", (dashboard as any).settings?.resolution);
-
-      if ((dashboard as any).settings?.resolution) {
-        const savedResolution = (dashboard as any).settings.resolution as Resolution;
-        console.log("✅ 저장된 해상도 복원:", savedResolution);
-        setResolution(savedResolution);
-      } else {
-        console.log("⚠️ 저장된 해상도 없음");
+      const settings = (dashboard as { settings?: { resolution?: Resolution; backgroundColor?: string } }).settings;
+      if (settings?.resolution) {
+        setResolution(settings.resolution);
       }
 
-      if ((dashboard as any).settings?.backgroundColor) {
-        console.log("✅ 저장된 배경색 복원:", (dashboard as any).settings.backgroundColor);
-        setCanvasBackgroundColor((dashboard as any).settings.backgroundColor);
+      if (settings?.backgroundColor) {
+        setCanvasBackgroundColor(settings.backgroundColor);
       }
 
       // 요소들 설정
@@ -177,7 +169,6 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
         setElementCounter(maxId);
       }
     } catch (error) {
-      // console.error('❌ 대시보드 로딩 오류:', error);
       alert(
         "대시보드를 불러오는 중 오류가 발생했습니다.\n\n" +
           (error instanceof Error ? error.message : "알 수 없는 오류"),
@@ -239,7 +230,7 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
       setElementCounter((prev) => prev + 1);
       setSelectedElement(newElement.id);
     },
-    [elementCounter, canvasConfig.width],
+    [elementCounter, canvasConfig],
   );
 
   // 메뉴에서 요소 추가 시 (캔버스 중앙에 배치)
@@ -257,7 +248,7 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
 
       createElement(type, subtype, centerX, centerY);
     },
-    [canvasConfig.width, canvasConfig.height, createElement],
+    [canvasConfig, createElement],
   );
 
   // 요소 업데이트
@@ -276,13 +267,17 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
     [selectedElement],
   );
 
-  // 전체 삭제
+  // 전체 삭제 확인 모달 열기
   const clearCanvas = useCallback(() => {
-    if (window.confirm("모든 요소를 삭제하시겠습니까?")) {
-      setElements([]);
-      setSelectedElement(null);
-      setElementCounter(0);
-    }
+    setClearConfirmOpen(true);
+  }, []);
+
+  // 실제 초기화 실행
+  const handleClearConfirm = useCallback(() => {
+    setElements([]);
+    setSelectedElement(null);
+    setElementCounter(0);
+    setClearConfirmOpen(false);
   }, []);
 
   // 요소 설정 모달 열기
@@ -428,7 +423,7 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
         throw error;
       }
     },
-    [elements, dashboardId, resolution, canvasBackgroundColor, router],
+    [elements, dashboardId, resolution, canvasBackgroundColor, refreshMenus],
   );
 
   // 로딩 중이면 로딩 화면 표시
@@ -450,7 +445,6 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
       <DashboardTopMenu
         onSaveLayout={saveLayout}
         onClearCanvas={clearCanvas}
-        onViewDashboard={dashboardId ? () => router.push(`/dashboard/${dashboardId}`) : undefined}
         dashboardTitle={dashboardTitle}
         onAddElement={addElementFromMenu}
         resolution={resolution}
@@ -544,6 +538,26 @@ export default function DashboardDesigner({ dashboardId: initialDashboardId }: D
           </div>
         </DialogContent>
       </Dialog>
+
+      {/* 초기화 확인 모달 */}
+      <AlertDialog open={clearConfirmOpen} onOpenChange={setClearConfirmOpen}>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>캔버스 초기화</AlertDialogTitle>
+            <AlertDialogDescription>
+              모든 요소가 삭제됩니다. 이 작업은 되돌릴 수 없습니다.
+              <br />
+              계속하시겠습니까?
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>취소</AlertDialogCancel>
+            <AlertDialogAction onClick={handleClearConfirm} className="bg-red-600 hover:bg-red-700">
+              초기화
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
     </div>
   );
 }
diff --git a/frontend/components/admin/dashboard/DashboardTopMenu.tsx b/frontend/components/admin/dashboard/DashboardTopMenu.tsx
index 446830a8..7c58078f 100644
--- a/frontend/components/admin/dashboard/DashboardTopMenu.tsx
+++ b/frontend/components/admin/dashboard/DashboardTopMenu.tsx
@@ -11,7 +11,7 @@ import {
   SelectTrigger,
   SelectValue,
 } from "@/components/ui/select";
-import { Save, Trash2, Eye, Palette } from "lucide-react";
+import { Save, Trash2, Palette } from "lucide-react";
 import { ElementType, ElementSubtype } from "./types";
 import { ResolutionSelector, Resolution } from "./ResolutionSelector";
 import { Input } from "@/components/ui/input";
@@ -20,7 +20,6 @@ import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover
 interface DashboardTopMenuProps {
   onSaveLayout: () => void;
   onClearCanvas: () => void;
-  onViewDashboard?: () => void;
   dashboardTitle?: string;
   onAddElement?: (type: ElementType, subtype: ElementSubtype) => void;
   resolution?: Resolution;
@@ -33,12 +32,11 @@ interface DashboardTopMenuProps {
 /**
  * 대시보드 편집 화면 상단 메뉴바
  * - 차트/위젯 선택 (셀렉트박스)
- * - 저장/초기화/보기 버튼
+ * - 저장/초기화 버튼
  */
 export function DashboardTopMenu({
   onSaveLayout,
   onClearCanvas,
-  onViewDashboard,
   dashboardTitle,
   onAddElement,
   resolution = "fhd",
@@ -211,12 +209,6 @@ export function DashboardTopMenu({
 
       {/* 우측: 액션 버튼 */}
       <div className="flex items-center gap-2">
-        {onViewDashboard && (
-          <Button variant="outline" size="sm" onClick={onViewDashboard} className="gap-2">
-            <Eye className="h-4 w-4" />
-            미리보기
-          </Button>
-        )}
         <Button variant="outline" size="sm" onClick={onClearCanvas} className="gap-2 text-red-600 hover:text-red-700">
           <Trash2 className="h-4 w-4" />
           초기화

From cb224be93e1b8f526ef024667517a859b4833e7d Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 16:54:09 +0900
Subject: [PATCH 06/10] =?UTF-8?q?=EB=8C=80=EC=8B=9C=EB=B3=B4=EB=93=9C=20?=
 =?UTF-8?q?=ED=99=94=EB=A9=B4=20=ED=97=A4=EB=8D=94=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../(main)/dashboard/[dashboardId]/page.tsx   | 59 +------------------
 1 file changed, 2 insertions(+), 57 deletions(-)

diff --git a/frontend/app/(main)/dashboard/[dashboardId]/page.tsx b/frontend/app/(main)/dashboard/[dashboardId]/page.tsx
index 0705d77b..a9271967 100644
--- a/frontend/app/(main)/dashboard/[dashboardId]/page.tsx
+++ b/frontend/app/(main)/dashboard/[dashboardId]/page.tsx
@@ -101,63 +101,8 @@ export default function DashboardViewPage({ params }: DashboardViewPageProps) {
 
   return (
     <div className="h-screen bg-gray-50">
-      {/* 대시보드 헤더 */}
-      <div className="border-b border-gray-200 bg-white px-6 py-4">
-        <div className="flex items-center justify-between">
-          <div>
-            <h1 className="text-2xl font-bold text-gray-800">{dashboard.title}</h1>
-            {dashboard.description && <p className="mt-1 text-sm text-gray-600">{dashboard.description}</p>}
-          </div>
-
-          <div className="flex items-center gap-3">
-            {/* 새로고침 버튼 */}
-            <button
-              onClick={loadDashboard}
-              className="rounded-lg border border-gray-300 px-3 py-2 text-gray-600 hover:bg-gray-50 hover:text-gray-800"
-              title="새로고침"
-            >
-              🔄
-            </button>
-
-            {/* 전체화면 버튼 */}
-            <button
-              onClick={() => {
-                if (document.fullscreenElement) {
-                  document.exitFullscreen();
-                } else {
-                  document.documentElement.requestFullscreen();
-                }
-              }}
-              className="rounded-lg border border-gray-300 px-3 py-2 text-gray-600 hover:bg-gray-50 hover:text-gray-800"
-              title="전체화면"
-            >
-              ⛶
-            </button>
-
-            {/* 편집 버튼 */}
-            <button
-              onClick={() => {
-                router.push(`/admin/dashboard?load=${resolvedParams.dashboardId}`);
-              }}
-              className="rounded-lg bg-blue-500 px-4 py-2 text-white hover:bg-blue-600"
-            >
-              편집
-            </button>
-          </div>
-        </div>
-
-        {/* 메타 정보 */}
-        <div className="mt-2 flex items-center gap-4 text-xs text-gray-500">
-          <span>생성: {new Date(dashboard.createdAt).toLocaleString()}</span>
-          <span>수정: {new Date(dashboard.updatedAt).toLocaleString()}</span>
-          <span>요소: {dashboard.elements.length}개</span>
-        </div>
-      </div>
-
-      {/* 대시보드 뷰어 */}
-      <div className="h-[calc(100vh-120px)]">
-        <DashboardViewer elements={dashboard.elements} dashboardId={dashboard.id} />
-      </div>
+      {/* 대시보드 뷰어 - 전체 화면 */}
+      <DashboardViewer elements={dashboard.elements} dashboardId={dashboard.id} />
     </div>
   );
 }

From 2ff0d77e62339ea37b7135df714aa7fc234a7071 Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 17:17:18 +0900
Subject: [PATCH 07/10] =?UTF-8?q?=EC=98=A4=EB=A5=98=20=ED=95=B4=EA=B2=B0?=
 =?UTF-8?q?=20=EB=B0=8F=20=EB=A7=88=EC=A7=80=EB=A7=89=20=EC=97=85=EB=8D=B0?=
 =?UTF-8?q?=EC=9D=B4=ED=8A=B8=20=EC=82=AD=EC=A0=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../(main)/dashboard/[dashboardId]/page.tsx   |   6 +-
 .../components/dashboard/DashboardViewer.tsx  | 153 +++++-------------
 2 files changed, 44 insertions(+), 115 deletions(-)

diff --git a/frontend/app/(main)/dashboard/[dashboardId]/page.tsx b/frontend/app/(main)/dashboard/[dashboardId]/page.tsx
index a9271967..cb6defd6 100644
--- a/frontend/app/(main)/dashboard/[dashboardId]/page.tsx
+++ b/frontend/app/(main)/dashboard/[dashboardId]/page.tsx
@@ -27,6 +27,10 @@ export default function DashboardViewPage({ params }: DashboardViewPageProps) {
     elements: DashboardElement[];
     createdAt: string;
     updatedAt: string;
+    settings?: {
+      resolution?: string;
+      backgroundColor?: string;
+    };
   } | null>(null);
   const [isLoading, setIsLoading] = useState(true);
   const [error, setError] = useState<string | null>(null);
@@ -102,7 +106,7 @@ export default function DashboardViewPage({ params }: DashboardViewPageProps) {
   return (
     <div className="h-screen bg-gray-50">
       {/* 대시보드 뷰어 - 전체 화면 */}
-      <DashboardViewer elements={dashboard.elements} dashboardId={dashboard.id} />
+      <DashboardViewer elements={dashboard.elements} resolution={dashboard.settings?.resolution || "fhd"} />
     </div>
   );
 }
diff --git a/frontend/components/dashboard/DashboardViewer.tsx b/frontend/components/dashboard/DashboardViewer.tsx
index d0c12ccf..d5790779 100644
--- a/frontend/components/dashboard/DashboardViewer.tsx
+++ b/frontend/components/dashboard/DashboardViewer.tsx
@@ -1,12 +1,12 @@
 "use client";
 
-import React, { useState, useEffect, useCallback } from "react";
+import React, { useState, useEffect, useCallback, useMemo } from "react";
 import { DashboardElement, QueryResult } from "@/components/admin/dashboard/types";
 import { ChartRenderer } from "@/components/admin/dashboard/charts/ChartRenderer";
+import { RESOLUTIONS, Resolution } from "@/components/admin/dashboard/ResolutionSelector";
 import dynamic from "next/dynamic";
 
 // 위젯 동적 import - 모든 위젯
-const ListSummaryWidget = dynamic(() => import("./widgets/ListSummaryWidget"), { ssr: false });
 const MapSummaryWidget = dynamic(() => import("./widgets/MapSummaryWidget"), { ssr: false });
 const StatusSummaryWidget = dynamic(() => import("./widgets/StatusSummaryWidget"), { ssr: false });
 const RiskAlertWidget = dynamic(() => import("./widgets/RiskAlertWidget"), { ssr: false });
@@ -65,8 +65,6 @@ function renderWidget(element: DashboardElement) {
       return <ClockWidget element={element} />;
     case "map-summary":
       return <MapSummaryWidget element={element} />;
-    case "list-summary":
-      return <ListSummaryWidget element={element} />;
     case "risk-alert":
       return <RiskAlertWidget element={element} />;
     case "calendar":
@@ -80,7 +78,7 @@ function renderWidget(element: DashboardElement) {
     case "booking-alert":
       return <BookingAlertWidget element={element} />;
     case "maintenance":
-      return <MaintenanceWidget element={element} />;
+      return <MaintenanceWidget />;
     case "document":
       return <DocumentWidget element={element} />;
     case "list":
@@ -91,23 +89,23 @@ function renderWidget(element: DashboardElement) {
 
     // === 차량 관련 (추가 위젯) ===
     case "vehicle-status":
-      return <VehicleStatusWidget />;
+      return <VehicleStatusWidget element={element} />;
     case "vehicle-list":
-      return <VehicleListWidget />;
+      return <VehicleListWidget element={element} />;
     case "vehicle-map":
       return <VehicleMapOnlyWidget element={element} />;
 
     // === 배송 관련 (추가 위젯) ===
     case "delivery-status":
-      return <DeliveryStatusWidget />;
+      return <DeliveryStatusWidget element={element} />;
     case "delivery-status-summary":
-      return <DeliveryStatusSummaryWidget />;
+      return <DeliveryStatusSummaryWidget element={element} />;
     case "delivery-today-stats":
-      return <DeliveryTodayStatsWidget />;
+      return <DeliveryTodayStatsWidget element={element} />;
     case "cargo-list":
-      return <CargoListWidget />;
+      return <CargoListWidget element={element} />;
     case "customer-issues":
-      return <CustomerIssuesWidget />;
+      return <CustomerIssuesWidget element={element} />;
 
     // === 기본 fallback ===
     default:
@@ -124,20 +122,33 @@ function renderWidget(element: DashboardElement) {
 
 interface DashboardViewerProps {
   elements: DashboardElement[];
-  dashboardId: string;
   refreshInterval?: number; // 전체 대시보드 새로고침 간격 (ms)
+  resolution?: string; // 대시보드 해상도
 }
 
 /**
  * 대시보드 뷰어 컴포넌트
  * - 저장된 대시보드를 읽기 전용으로 표시
  * - 실시간 데이터 업데이트
- * - 반응형 레이아웃
+ * - 편집 화면과 동일한 레이아웃 (중앙 정렬, 고정 크기)
  */
-export function DashboardViewer({ elements, dashboardId, refreshInterval }: DashboardViewerProps) {
+export function DashboardViewer({ elements, refreshInterval, resolution = "fhd" }: DashboardViewerProps) {
   const [elementData, setElementData] = useState<Record<string, QueryResult>>({});
   const [loadingElements, setLoadingElements] = useState<Set<string>>(new Set());
-  const [lastRefresh, setLastRefresh] = useState<Date>(new Date());
+
+  // 캔버스 설정 계산
+  const canvasConfig = useMemo(() => {
+    return RESOLUTIONS[resolution as Resolution] || RESOLUTIONS.fhd;
+  }, [resolution]);
+
+  // 캔버스 높이 동적 계산
+  const canvasHeight = useMemo(() => {
+    if (elements.length === 0) {
+      return canvasConfig.height;
+    }
+    const maxBottomY = Math.max(...elements.map((el) => el.position.y + el.size.height));
+    return Math.max(canvasConfig.height, maxBottomY + 100);
+  }, [elements, canvasConfig.height]);
 
   // 개별 요소 데이터 로딩
   const loadElementData = useCallback(async (element: DashboardElement) => {
@@ -191,7 +202,7 @@ export function DashboardViewer({ elements, dashboardId, refreshInterval }: Dash
           [element.id]: data,
         }));
       }
-    } catch (error) {
+    } catch {
       // 에러 발생 시 무시 (차트는 빈 상태로 표시됨)
     } finally {
       setLoadingElements((prev) => {
@@ -204,8 +215,6 @@ export function DashboardViewer({ elements, dashboardId, refreshInterval }: Dash
 
   // 모든 요소 데이터 로딩
   const loadAllData = useCallback(async () => {
-    setLastRefresh(new Date());
-
     const chartElements = elements.filter((el) => el.type === "chart" && el.dataSource?.query);
 
     // 병렬로 모든 차트 데이터 로딩
@@ -241,17 +250,17 @@ export function DashboardViewer({ elements, dashboardId, refreshInterval }: Dash
   }
 
   return (
-    <div className="relative h-full w-full overflow-auto bg-gray-100">
-      {/* 새로고침 상태 표시 */}
-      <div className="text-muted-foreground absolute top-4 right-4 z-10 rounded-lg bg-white px-3 py-2 text-xs shadow-sm">
-        마지막 업데이트: {lastRefresh.toLocaleTimeString()}
-        {Array.from(loadingElements).length > 0 && (
-          <span className="text-primary ml-2">({Array.from(loadingElements).length}개 로딩 중...)</span>
-        )}
-      </div>
-
-      {/* 대시보드 요소들 */}
-      <div className="relative" style={{ minHeight: "100%" }}>
+    <div className="flex h-full items-start justify-center overflow-auto bg-gray-100 p-8">
+      {/* 고정 크기 캔버스 (편집 화면과 동일한 레이아웃) */}
+      <div
+        className="relative overflow-hidden rounded-lg"
+        style={{
+          width: `${canvasConfig.width}px`,
+          minHeight: `${canvasConfig.height}px`,
+          height: `${canvasHeight}px`,
+        }}
+      >
+        {/* 대시보드 요소들 */}
         {elements.map((element) => (
           <ViewerElement
             key={element.id}
@@ -333,87 +342,3 @@ function ViewerElement({ element, data, isLoading, onRefresh }: ViewerElementPro
     </div>
   );
 }
-
-/**
- * 샘플 쿼리 결과 생성 함수 (뷰어용)
- */
-function generateSampleQueryResult(query: string, chartType: string): QueryResult {
-  // 시간에 따라 약간씩 다른 데이터 생성 (실시간 업데이트 시뮬레이션)
-  const timeVariation = Math.sin(Date.now() / 10000) * 0.1 + 1;
-
-  const isMonthly = query.toLowerCase().includes("month");
-  const isSales = query.toLowerCase().includes("sales") || query.toLowerCase().includes("매출");
-  const isUsers = query.toLowerCase().includes("users") || query.toLowerCase().includes("사용자");
-  const isProducts = query.toLowerCase().includes("product") || query.toLowerCase().includes("상품");
-  const isWeekly = query.toLowerCase().includes("week");
-
-  let columns: string[];
-  let rows: Record<string, any>[];
-
-  if (isMonthly && isSales) {
-    columns = ["month", "sales", "order_count"];
-    rows = [
-      { month: "2024-01", sales: Math.round(1200000 * timeVariation), order_count: Math.round(45 * timeVariation) },
-      { month: "2024-02", sales: Math.round(1350000 * timeVariation), order_count: Math.round(52 * timeVariation) },
-      { month: "2024-03", sales: Math.round(1180000 * timeVariation), order_count: Math.round(41 * timeVariation) },
-      { month: "2024-04", sales: Math.round(1420000 * timeVariation), order_count: Math.round(58 * timeVariation) },
-      { month: "2024-05", sales: Math.round(1680000 * timeVariation), order_count: Math.round(67 * timeVariation) },
-      { month: "2024-06", sales: Math.round(1540000 * timeVariation), order_count: Math.round(61 * timeVariation) },
-    ];
-  } else if (isWeekly && isUsers) {
-    columns = ["week", "new_users"];
-    rows = [
-      { week: "2024-W10", new_users: Math.round(23 * timeVariation) },
-      { week: "2024-W11", new_users: Math.round(31 * timeVariation) },
-      { week: "2024-W12", new_users: Math.round(28 * timeVariation) },
-      { week: "2024-W13", new_users: Math.round(35 * timeVariation) },
-      { week: "2024-W14", new_users: Math.round(42 * timeVariation) },
-      { week: "2024-W15", new_users: Math.round(38 * timeVariation) },
-    ];
-  } else if (isProducts) {
-    columns = ["product_name", "total_sold", "revenue"];
-    rows = [
-      {
-        product_name: "스마트폰",
-        total_sold: Math.round(156 * timeVariation),
-        revenue: Math.round(234000000 * timeVariation),
-      },
-      {
-        product_name: "노트북",
-        total_sold: Math.round(89 * timeVariation),
-        revenue: Math.round(178000000 * timeVariation),
-      },
-      {
-        product_name: "태블릿",
-        total_sold: Math.round(134 * timeVariation),
-        revenue: Math.round(67000000 * timeVariation),
-      },
-      {
-        product_name: "이어폰",
-        total_sold: Math.round(267 * timeVariation),
-        revenue: Math.round(26700000 * timeVariation),
-      },
-      {
-        product_name: "스마트워치",
-        total_sold: Math.round(98 * timeVariation),
-        revenue: Math.round(49000000 * timeVariation),
-      },
-    ];
-  } else {
-    columns = ["category", "value", "count"];
-    rows = [
-      { category: "A", value: Math.round(100 * timeVariation), count: Math.round(10 * timeVariation) },
-      { category: "B", value: Math.round(150 * timeVariation), count: Math.round(15 * timeVariation) },
-      { category: "C", value: Math.round(120 * timeVariation), count: Math.round(12 * timeVariation) },
-      { category: "D", value: Math.round(180 * timeVariation), count: Math.round(18 * timeVariation) },
-      { category: "E", value: Math.round(90 * timeVariation), count: Math.round(9 * timeVariation) },
-    ];
-  }
-
-  return {
-    columns,
-    rows,
-    totalRows: rows.length,
-    executionTime: Math.floor(Math.random() * 100) + 50,
-  };
-}

From 317b4ed1e74c62de24c961d156e9310e86eab494 Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 17:22:14 +0900
Subject: [PATCH 08/10] =?UTF-8?q?=EB=B3=B4=EA=B8=B0=20=EA=B8=B0=EB=8A=A5?=
 =?UTF-8?q?=20=EC=A0=9C=EA=B1=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend/app/(main)/admin/dashboard/page.tsx | 6 +-----
 1 file changed, 1 insertion(+), 5 deletions(-)

diff --git a/frontend/app/(main)/admin/dashboard/page.tsx b/frontend/app/(main)/admin/dashboard/page.tsx
index cde559ee..6adc326e 100644
--- a/frontend/app/(main)/admin/dashboard/page.tsx
+++ b/frontend/app/(main)/admin/dashboard/page.tsx
@@ -15,7 +15,7 @@ import {
   DropdownMenuItem,
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
-import { Plus, Search, MoreVertical, Edit, Trash2, Copy, Eye } from "lucide-react";
+import { Plus, Search, MoreVertical, Edit, Trash2, Copy } from "lucide-react";
 
 /**
  * 대시보드 관리 페이지
@@ -178,10 +178,6 @@ export default function DashboardListPage() {
                           </Button>
                         </DropdownMenuTrigger>
                         <DropdownMenuContent align="end">
-                          <DropdownMenuItem onClick={() => router.push(`/dashboard/${dashboard.id}`)} className="gap-2">
-                            <Eye className="h-4 w-4" />
-                            보기
-                          </DropdownMenuItem>
                           <DropdownMenuItem
                             onClick={() => router.push(`/admin/dashboard/edit/${dashboard.id}`)}
                             className="gap-2"

From 7155f7634548bef7cfb4e7bd30db7b23395cd8ef Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 17:27:03 +0900
Subject: [PATCH 09/10] =?UTF-8?q?=EB=8C=80=EC=8B=9C=EB=B3=B4=EB=93=9C=20?=
 =?UTF-8?q?=EB=B3=B5=EC=A0=9C=20=EA=B8=B0=EB=8A=A5=20=EA=B5=AC=ED=98=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend/app/(main)/admin/dashboard/page.tsx | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/frontend/app/(main)/admin/dashboard/page.tsx b/frontend/app/(main)/admin/dashboard/page.tsx
index 6adc326e..e43153de 100644
--- a/frontend/app/(main)/admin/dashboard/page.tsx
+++ b/frontend/app/(main)/admin/dashboard/page.tsx
@@ -67,13 +67,17 @@ export default function DashboardListPage() {
   // 대시보드 복사
   const handleCopy = async (dashboard: Dashboard) => {
     try {
+      // 전체 대시보드 정보(요소 포함)를 가져오기
+      const fullDashboard = await dashboardApi.getDashboard(dashboard.id);
+
       const newDashboard = await dashboardApi.createDashboard({
-        title: `${dashboard.title} (복사본)`,
-        description: dashboard.description,
-        elements: dashboard.elements || [],
+        title: `${fullDashboard.title} (복사본)`,
+        description: fullDashboard.description,
+        elements: fullDashboard.elements || [],
         isPublic: false,
-        tags: dashboard.tags,
-        category: dashboard.category,
+        tags: fullDashboard.tags,
+        category: fullDashboard.category,
+        settings: (fullDashboard as any).settings, // 해상도와 배경색 설정도 복사
       });
       alert("대시보드가 복사되었습니다.");
       loadDashboards();

From 7241d1b91f057137096d82621ac6edfd14ce4811 Mon Sep 17 00:00:00 2001
From: dohyeons <ddhhss0603@gmail.com>
Date: Thu, 16 Oct 2025 18:09:46 +0900
Subject: [PATCH 10/10] =?UTF-8?q?=EB=AA=A8=EB=8B=AC=ED=99=94(=EC=82=AD?=
 =?UTF-8?q?=EC=A0=9C,=20=EB=B3=B5=EC=82=AC)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 frontend/app/(main)/admin/dashboard/page.tsx | 85 +++++++++++++++++---
 1 file changed, 73 insertions(+), 12 deletions(-)

diff --git a/frontend/app/(main)/admin/dashboard/page.tsx b/frontend/app/(main)/admin/dashboard/page.tsx
index e43153de..d1ca6125 100644
--- a/frontend/app/(main)/admin/dashboard/page.tsx
+++ b/frontend/app/(main)/admin/dashboard/page.tsx
@@ -15,7 +15,18 @@ import {
   DropdownMenuItem,
   DropdownMenuTrigger,
 } from "@/components/ui/dropdown-menu";
-import { Plus, Search, MoreVertical, Edit, Trash2, Copy } from "lucide-react";
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from "@/components/ui/alert-dialog";
+import { Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle } from "@/components/ui/dialog";
+import { Plus, Search, MoreVertical, Edit, Trash2, Copy, CheckCircle2 } from "lucide-react";
 
 /**
  * 대시보드 관리 페이지
@@ -29,6 +40,12 @@ export default function DashboardListPage() {
   const [searchTerm, setSearchTerm] = useState("");
   const [error, setError] = useState<string | null>(null);
 
+  // 모달 상태
+  const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
+  const [deleteTarget, setDeleteTarget] = useState<{ id: string; title: string } | null>(null);
+  const [successDialogOpen, setSuccessDialogOpen] = useState(false);
+  const [successMessage, setSuccessMessage] = useState("");
+
   // 대시보드 목록 로드
   const loadDashboards = async () => {
     try {
@@ -48,19 +65,27 @@ export default function DashboardListPage() {
     loadDashboards();
   }, [searchTerm]);
 
-  // 대시보드 삭제
-  const handleDelete = async (id: string, title: string) => {
-    if (!confirm(`"${title}" 대시보드를 삭제하시겠습니까?`)) {
-      return;
-    }
+  // 대시보드 삭제 확인 모달 열기
+  const handleDeleteClick = (id: string, title: string) => {
+    setDeleteTarget({ id, title });
+    setDeleteDialogOpen(true);
+  };
+
+  // 대시보드 삭제 실행
+  const handleDeleteConfirm = async () => {
+    if (!deleteTarget) return;
 
     try {
-      await dashboardApi.deleteDashboard(id);
-      alert("대시보드가 삭제되었습니다.");
+      await dashboardApi.deleteDashboard(deleteTarget.id);
+      setDeleteDialogOpen(false);
+      setDeleteTarget(null);
+      setSuccessMessage("대시보드가 삭제되었습니다.");
+      setSuccessDialogOpen(true);
       loadDashboards();
     } catch (err) {
       console.error("Failed to delete dashboard:", err);
-      alert("대시보드 삭제에 실패했습니다.");
+      setDeleteDialogOpen(false);
+      setError("대시보드 삭제에 실패했습니다.");
     }
   };
 
@@ -79,11 +104,12 @@ export default function DashboardListPage() {
         category: fullDashboard.category,
         settings: (fullDashboard as any).settings, // 해상도와 배경색 설정도 복사
       });
-      alert("대시보드가 복사되었습니다.");
+      setSuccessMessage("대시보드가 복사되었습니다.");
+      setSuccessDialogOpen(true);
       loadDashboards();
     } catch (err) {
       console.error("Failed to copy dashboard:", err);
-      alert("대시보드 복사에 실패했습니다.");
+      setError("대시보드 복사에 실패했습니다.");
     }
   };
 
@@ -194,7 +220,7 @@ export default function DashboardListPage() {
                             복사
                           </DropdownMenuItem>
                           <DropdownMenuItem
-                            onClick={() => handleDelete(dashboard.id, dashboard.title)}
+                            onClick={() => handleDeleteClick(dashboard.id, dashboard.title)}
                             className="gap-2 text-red-600 focus:text-red-600"
                           >
                             <Trash2 className="h-4 w-4" />
@@ -210,6 +236,41 @@ export default function DashboardListPage() {
           </Card>
         )}
       </div>
+
+      {/* 삭제 확인 모달 */}
+      <AlertDialog open={deleteDialogOpen} onOpenChange={setDeleteDialogOpen}>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>대시보드 삭제</AlertDialogTitle>
+            <AlertDialogDescription>
+              &quot;{deleteTarget?.title}&quot; 대시보드를 삭제하시겠습니까?
+              <br />이 작업은 되돌릴 수 없습니다.
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>취소</AlertDialogCancel>
+            <AlertDialogAction onClick={handleDeleteConfirm} className="bg-red-600 hover:bg-red-700">
+              삭제
+            </AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+
+      {/* 성공 모달 */}
+      <Dialog open={successDialogOpen} onOpenChange={setSuccessDialogOpen}>
+        <DialogContent className="sm:max-w-md">
+          <DialogHeader>
+            <div className="mx-auto flex h-12 w-12 items-center justify-center rounded-full bg-green-100">
+              <CheckCircle2 className="h-6 w-6 text-green-600" />
+            </div>
+            <DialogTitle className="text-center">완료</DialogTitle>
+            <DialogDescription className="text-center">{successMessage}</DialogDescription>
+          </DialogHeader>
+          <div className="flex justify-center pt-4">
+            <Button onClick={() => setSuccessDialogOpen(false)}>확인</Button>
+          </div>
+        </DialogContent>
+      </Dialog>
     </div>
   );
 }