[cm] feat: 대시보드 페이지 dnd 적용

apps/cm/package.json

@@ -12,6 +12,9 @@
     "@common/assets": "workspace:*",
     "@common/components": "workspace:*",
     "@common/config": "workspace:*",
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
     "@fontsource-variable/noto-sans-kr": "^5.2.5",
     "@frontend-opensource/use-react-hooks": "^1.1.4",
     "@fullcalendar/core": "^6.1.17",

apps/cm/src/pages/dashboard/lib/hooks/use-dnd-sensors.ts

@@ -0,0 +1,16 @@
+import {
+  KeyboardSensor,
+  PointerSensor,
+  useSensor,
+  useSensors,
+} from "@dnd-kit/core";
+import { sortableKeyboardCoordinates } from "@dnd-kit/sortable";
+
+export function useDndSensors() {
+  return useSensors(
+    useSensor(PointerSensor),
+    useSensor(KeyboardSensor, {
+      coordinateGetter: sortableKeyboardCoordinates,
+    }),
+  );
+}

apps/cm/src/pages/dashboard/lib/hooks/use-panel-order.ts

@@ -0,0 +1,56 @@
+import { useState } from "react";
+import { arrayMove } from "@dnd-kit/sortable";
+import type { DragEndEvent } from "@dnd-kit/core";
+import type { PanelItem } from "../../model/types";
+
+interface UsePanelOrderProps {
+  initialPanels: PanelItem[];
+  storageKey: string;
+}
+
+export function usePanelOrder({
+  initialPanels,
+  storageKey,
+}: UsePanelOrderProps) {
+  const [panels, setPanels] = useState<PanelItem[]>(() => {
+    if (typeof window !== "undefined") {
+      const saved = localStorage.getItem(storageKey);
+      if (saved) {
+        try {
+          const savedIds = JSON.parse(saved);
+          const restoredPanels = savedIds
+            .map((id: string) => initialPanels.find((p) => p.id === id))
+            .filter(Boolean);
+          if (restoredPanels.length === initialPanels.length) {
+            return restoredPanels;
+          }
+        } catch {
+          return initialPanels;
+        }
+      }
+    }
+    return initialPanels;
+  });
+
+  const handleDragEnd = (event: DragEndEvent) => {
+    const { active, over } = event;
+
+    if (over && active.id !== over.id) {
+      setPanels((items) => {
+        const oldIndex = items.findIndex((item) => item.id === active.id);
+        const newIndex = items.findIndex((item) => item.id === over.id);
+        const newItems = arrayMove(items, oldIndex, newIndex);
+
+        // localStorage에 저장
+        localStorage.setItem(
+          storageKey,
+          JSON.stringify(newItems.map((item) => item.id)),
+        );
+
+        return newItems;
+      });
+    }
+  };
+
+  return { panels, handleDragEnd };
+}

apps/cm/src/pages/dashboard/model/panel-config.tsx

@@ -0,0 +1,71 @@
+import FoFcltCntRt from "@/pages/dashboard/ui/fo-fclt-cnt-rt";
+import SnPplStatus from "@/pages/dashboard/ui/sn-ppl-status";
+import ReuseChart from "@/pages/dashboard/ui/reuse-chart";
+import FoWqltInflEffl from "@/pages/dashboard/ui/fo-wqlt-Infl-effl";
+import SnOldPpl from "@/pages/dashboard/ui/sn-old-ppl";
+import ReuseStatus from "@/pages/dashboard/ui/reuse-status";
+import SupportList from "@/pages/dashboard/ui/support-list";
+import DataStatusList from "@/pages/dashboard/ui/datastatus-list";
+import NoticeList from "@/pages/dashboard/ui/notice-list";
+import BannerList from "@/pages/dashboard/ui/banner-list";
+import type { PanelItem } from "./types";
+
+export function getInitialTopPanels(): PanelItem[] {
+  return [
+    {
+      id: "panel-1",
+      component: <FoFcltCntRt />,
+      className: "",
+    },
+    {
+      id: "panel-2",
+      component: <SnPplStatus />,
+      className: "",
+    },
+    {
+      id: "panel-3",
+      component: <ReuseChart />,
+      className: "",
+    },
+    {
+      id: "panel-4",
+      component: <FoWqltInflEffl />,
+      className: "",
+    },
+    {
+      id: "panel-5",
+      component: <SnOldPpl />,
+      className: "",
+    },
+    {
+      id: "panel-6",
+      component: <ReuseStatus />,
+      className: "",
+    },
+  ];
+}
+
+export function getInitialBottomPanels(): PanelItem[] {
+  return [
+    {
+      id: "panel-7",
+      component: <SupportList />,
+      className: "",
+    },
+    {
+      id: "panel-8",
+      component: <DataStatusList />,
+      className: "",
+    },
+    {
+      id: "panel-9",
+      component: <NoticeList />,
+      className: "",
+    },
+    {
+      id: "panel-10",
+      component: <BannerList />,
+      className: "",
+    },
+  ];
+}

apps/cm/src/pages/dashboard/model/types.ts

@@ -0,0 +1,7 @@
+export interface PanelItem {
+  id: string;
+  component: React.ReactNode;
+  className?: string;
+}
+
+export type PanelType = "top" | "bottom";

apps/cm/src/pages/dashboard/ui/dashboard-page.tsx

@@ -6,6 +6,8 @@ import { tokenManager } from "@/entities/auth/lib/token-manager";
 import { client } from "@/shared/api";
 import { ENDPOINT } from "@/shared/config";
 import { KoreaBasinMap } from "../lib/korea-basin-map";
+import { useDndSensors } from "../lib/hooks/use-dnd-sensors";
+import { usePanelOrder } from "../lib/hooks/use-panel-order";
 import {
   Chart as ChartJS,
   CategoryScale,
@@ -18,18 +20,15 @@ import {
   Tooltip,
   ArcElement,
 } from "chart.js";
-import SnPplStatus from "./sn-ppl-status";
-import SnOldPpl from "./sn-old-ppl";
-import FoFcltCntRt from "./fo-fclt-cnt-rt";
-import FoWqltInflEffl from "./fo-wqlt-Infl-effl";
-import ReuseChart from "./reuse-chart";
-import ReuseStatus from "./reuse-status";
-import NoticeList from "./notice-list";
-import BannerList from "./banner-list";
-import SupportList from "./support-list";
-import DataStatusList from "./datastatus-list";
+import { DndContext, closestCenter } from "@dnd-kit/core";
+import { SortableContext, rectSortingStrategy } from "@dnd-kit/sortable";
+import {
+  getInitialTopPanels,
+  getInitialBottomPanels,
+} from "../model/panel-config";
 import MyPostList from "./mypost-list";
 import ScheduleList from "./schedule-list";
+import { SortablePanel } from "./sortable-panel";
 
 // Chart.js 등록
 ChartJS.register(
@@ -41,7 +40,7 @@ ChartJS.register(
   Filler,
   Legend,
   Tooltip,
-  ArcElement
+  ArcElement,
 );
 
 interface UserInfo {
@@ -54,7 +53,23 @@ interface UserInfo {
 function DashboardPage() {
   const [userInfo, setUserInfo] = useState<UserInfo | null>(null);
   const [error, setError] = useState("");
-  const router = useRouter();  
+  const router = useRouter();
+
+  // dnd-kit 센서 설정
+  const sensors = useDndSensors();
+
+  // 패널 순서 관리
+  const { panels: topPanels, handleDragEnd: handleTopDragEnd } = usePanelOrder({
+    initialPanels: getInitialTopPanels(),
+    storageKey: "dashboard-top-panels-order",
+  });
+
+  const { panels: bottomPanels, handleDragEnd: handleBottomDragEnd } =
+    usePanelOrder({
+      initialPanels: getInitialBottomPanels(),
+      storageKey: "dashboard-bottom-panels-order",
+    });
+
   useEffect(() => {
     const fetchUserInfo = async () => {
       console.log("fetchUserInfo called");
@@ -115,96 +130,129 @@ function DashboardPage() {
   return (
     <div className="p-2 sm:p-4 md:p-6">
       <div className="flex flex-col gap-1">
-        {/* 첫번째 라인 */}
-        <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-4 xl:grid-cols-8 gap-1">
-          {/* 첫번쨰 열 */}
-          <div className="col-span-1 md:col-span-1 lg:col-span-1 xl:col-span-2 h-250 !p-0">
-            {/* 전국 하수처리시설 개소수 및 가동률 */}
-            <FoFcltCntRt />
-
-            {/* 오수관로 및 우수관로 현황 */}
-            <SnPplStatus />
-
-            {/* 하수처리수 재이용 (m³) */}
-            <ReuseChart />
-          </div>
-
-          {/* 두번쨰 열 */}
-          <div className="col-span-1 md:col-span-1 lg:col-span-1 xl:col-span-2 h-250 !p-0">
-            {/* 수계별 유입ㆍ방류수질 분석 */}
-            <FoWqltInflEffl />
-
-            {/* 노후하수관로현황 */}
-            <SnOldPpl />
-
-            {/* 물재이용 현황 (재이용량, m³) */}
-            <ReuseStatus />
-          </div>
-
-          {/* 지도영역 */}
-          <div className="col-span-1 md:col-span-2 lg:col-span-1 xl:col-span-3">
-            <KoreaBasinMap />
-          </div>
-
-          {/* 사용자 정보 카드 */}
-          <div className="col-span-1 md:col-span-2 lg:col-span-1 xl:col-span-1 !p-0">
-            {error && <div className="mb-4 text-red-500">{error}</div>}
-            {userInfo ? (
-            <div className="card card_border login_info_box" style={{ minHeight: "150px", height: "auto" }}>
-              <div className="login_header" style={{ paddingLeft: "10px", paddingRight: "10px" }}>
-                <div className="login_avatar">
-                  <Image 
-                    src="/images/icon_loginID.png" 
-                    alt="프로필" 
-                    width={40}
-                    height={40}
-                    onError={(e) => {
-                      const target = e.target as HTMLImageElement;
-                      target.src = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='40' height='40' viewBox='0 0 40 40'%3E%3Ccircle cx='20' cy='20' r='18' fill='%23e1e5e9'/%3E%3Ctext x='20' y='26' font-size='20' text-anchor='middle' fill='%23999'%3E%3F%3C/text%3E%3C/svg%3E";
-                    }} 
-                  />
+        {/* 첫번째 라인 - 좌측 6개 패널(2x3) + 우측 지도/사용자 정보 */}
+        <div className="flex flex-col gap-1 lg:flex-row">
+          {/* 좌측: 드래그 가능한 6개 패널 (2x3 그리드, 화면의 50%) */}
+          <div className="w-full lg:w-1/2">
+            <DndContext
+              sensors={sensors}
+              collisionDetection={closestCenter}
+              onDragEnd={handleTopDragEnd}
+            >
+              <SortableContext
+                items={topPanels.map((p) => p.id)}
+                strategy={rectSortingStrategy}
+              >
+                <div className="grid grid-cols-2 gap-1">
+                  {topPanels.map((panel) => (
+                    <SortablePanel
+                      key={panel.id}
+                      id={panel.id}
+                      className={panel.className}
+                    >
+                      {panel.component}
+                    </SortablePanel>
+                  ))}
                 </div>
-                <div className="login_user_info">
-                  <div className="user_name">{userInfo.userName || "-"}</div>
-                  <div className="user_status">온라인</div>
-                  <div className="user_status text-xs sm:text-sm">
-                    <b>2FA 활성화:</b>{" "}
-                    {userInfo.twoFactorEnabled ? "예" : "아니오"}
+              </SortableContext>
+            </DndContext>
+          </div>
+
+          {/* 우측: 고정된 지도와 사용자 정보 (화면의 50%) */}
+          <div className="flex w-full gap-1 lg:w-1/2">
+            {/* 지도영역 - 고정 (드래그 불가) */}
+            <div className="flex-1">
+              <KoreaBasinMap />
+            </div>
+
+            {/* 사용자 정보 카드 - 고정 (드래그 불가) */}
+            <div className="flex w-full flex-col gap-1 !p-0 lg:w-[300px]">
+              {error && <div className="mb-4 text-red-500">{error}</div>}
+              {userInfo ? (
+                <div
+                  className="card card_border login_info_box"
+                  style={{ minHeight: "150px", height: "auto" }}
+                >
+                  <div
+                    className="login_header"
+                    style={{ paddingLeft: "10px", paddingRight: "10px" }}
+                  >
+                    <div className="login_avatar">
+                      <Image
+                        src="/images/icon_loginID.png"
+                        alt="프로필"
+                        width={40}
+                        height={40}
+                        onError={(e) => {
+                          const target = e.target as HTMLImageElement;
+                          target.src =
+                            "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='40' height='40' viewBox='0 0 40 40'%3E%3Ccircle cx='20' cy='20' r='18' fill='%23e1e5e9'/%3E%3Ctext x='20' y='26' font-size='20' text-anchor='middle' fill='%23999'%3E%3F%3C/text%3E%3C/svg%3E";
+                        }}
+                      />
+                    </div>
+                    <div className="login_user_info">
+                      <div className="user_name">
+                        {userInfo.userName || "-"}
+                      </div>
+                      <div className="user_status">온라인</div>
+                      <div className="user_status text-xs sm:text-sm">
+                        <b>2FA 활성화:</b>{" "}
+                        {userInfo.twoFactorEnabled ? "예" : "아니오"}
+                      </div>
+                    </div>
+                  </div>
+                  <div
+                    className="login_actions"
+                    style={{ paddingLeft: "10px", paddingRight: "10px" }}
+                  >
+                    <button
+                      className="login_btn text-xs sm:text-sm"
+                      onClick={handleLogout}
+                    >
+                      로그아웃
+                    </button>
+                    <button
+                      className="signup_btn text-xs sm:text-sm"
+                      onClick={handleChangePassword}
+                    >
+                      마이페이지
+                    </button>
                   </div>
                 </div>
-              </div>
-                <div className="login_actions" style={{ paddingLeft: "10px", paddingRight: "10px" }}>
-                  <button className="login_btn text-xs sm:text-sm" onClick={handleLogout}>로그아웃</button>
-                  <button className="signup_btn text-xs sm:text-sm" onClick={handleChangePassword}>마이페이지</button>
-              </div>
+              ) : (
+                !error && <div>사용자 정보를 불러오는 중...</div>
+              )}
+
+              <ScheduleList />
+
+              <MyPostList />
             </div>
-            ) : (
-              !error && <div>사용자 정보를 불러오는 중...</div>
-            )}
-            
-            <ScheduleList />
-            
-            <MyPostList />
-          </div>          
-        </div>
-
-        {/* 두번째 라인 */}
-        <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-4 gap-1">
-          <div className="card card-border" style={{ height: "250px" }}>
-            <SupportList />
-          </div>
-          <div className="card card-border" style={{ height: "250px" }}>
-            <DataStatusList />
-          </div>
-          <div className="card card-border" style={{ height: "250px" }}>
-            <NoticeList />
-          </div>
-
-          {/* 배너 영역 */}
-          <div className="card card-border" style={{ height: "250px" }}>
-            <BannerList />
           </div>
         </div>
+
+        {/* 두번째 라인 - 드래그 가능한 4개 패널 */}
+        <DndContext
+          sensors={sensors}
+          collisionDetection={closestCenter}
+          onDragEnd={handleBottomDragEnd}
+        >
+          <SortableContext
+            items={bottomPanels.map((p) => p.id)}
+            strategy={rectSortingStrategy}
+          >
+            <div className="grid grid-cols-1 gap-1 sm:grid-cols-2 lg:grid-cols-4">
+              {bottomPanels.map((panel) => (
+                <SortablePanel
+                  key={panel.id}
+                  id={panel.id}
+                  className="card card-border"
+                >
+                  <div style={{ height: "250px" }}>{panel.component}</div>
+                </SortablePanel>
+              ))}
+            </div>
+          </SortableContext>
+        </DndContext>
       </div>
     </div>
   );

apps/cm/src/pages/dashboard/ui/sortable-panel.tsx

@@ -0,0 +1,38 @@
+import { useSortable } from "@dnd-kit/sortable";
+import { CSS } from "@dnd-kit/utilities";
+
+interface SortablePanelProps {
+  id: string;
+  children: React.ReactNode;
+  className?: string;
+}
+
+export function SortablePanel({ id, children, className }: SortablePanelProps) {
+  const {
+    attributes,
+    listeners,
+    setNodeRef,
+    transform,
+    transition,
+    isDragging,
+  } = useSortable({ id });
+
+  const style = {
+    transform: CSS.Transform.toString(transform),
+    transition,
+    opacity: isDragging ? 0.5 : 1,
+    cursor: isDragging ? "grabbing" : "grab",
+  };
+
+  return (
+    <div
+      ref={setNodeRef}
+      style={style}
+      {...attributes}
+      {...listeners}
+      className={className}
+    >
+      {children}
+    </div>
+  );
+}