Feat/user dashboard

app/(dashboard)/user/dashboard/api-keys/page.tsx

@@ -0,0 +1,50 @@
+"use client";
+
+import React, { useState } from "react";
+import ApiKeysList from "@/components/user/dashboard/api-keys/ApiKeysList";
+import ErrorGuide from "@/components/user/dashboard/api-keys/ErrorGuide";
+
+export default function ApiKeysPage() {
+  const [activeTab, setActiveTab] = useState("keys"); // keys, guide, errors
+
+  return (
+    <div className="space-y-6">
+      <div>
+        <h1 className="text-2xl font-bold">API 키 관리</h1>
+        <p className="text-[#5E99D6] mt-1">
+          결제 시스템에 연동하기 위한 API 키를 관리합니다.
+        </p>
+      </div>
+
+      {/* 탭 메뉴 */}
+      <div className="border-b border-[#CDE5FF]">
+        <div className="flex space-x-4">
+          <button
+            className={`px-4 py-2 ${
+              activeTab === "keys"
+                ? "border-b-2 border-[#0067AC] text-[#0067AC] font-medium"
+                : "text-[#5E99D6]"
+            }`}
+            onClick={() => setActiveTab("keys")}
+          >
+            API 키 목록
+          </button>
+          <button
+            className={`px-4 py-2 ${
+              activeTab === "errors"
+                ? "border-b-2 border-[#0067AC] text-[#0067AC] font-medium"
+                : "text-[#5E99D6]"
+            }`}
+            onClick={() => setActiveTab("errors")}
+          >
+            에러 가이드
+          </button>
+        </div>
+      </div>
+
+      {/* 탭 컨텐츠 */}
+      {activeTab === "keys" && <ApiKeysList />}
+      {activeTab === "errors" && <ErrorGuide />}
+    </div>
+  );
+}

app/(dashboard)/user/dashboard/layout.tsx

@@ -0,0 +1,206 @@
+"use client";
+
+import React, { type ReactNode, useState } from "react";
+import Link from "next/link";
+import { usePathname } from "next/navigation";
+import { ChevronDown, History, Home, KeyIcon, LogOut, Menu, Settings, User, X } from "lucide-react";
+import { cn } from "@/lib/utils";
+
+interface UserDashboardLayoutProps {
+  children: ReactNode;
+}
+
+export default function UserDashboardLayout({ children }: UserDashboardLayoutProps) {
+  const [isSidebarOpen, setIsSidebarOpen] = useState(false);
+  const [isDropdownOpen, setIsDropdownOpen] = useState(false);
+  const pathname = usePathname();
+
+  // 사용자 경로 정의
+  const userRoutes = [
+    {
+      name: "대시보드",
+      path: "/user/dashboard",
+      icon: <Home className="h-5 w-5" />,
+    },
+    {
+      name: "API 키 관리",
+      path: "/user/dashboard/api-keys",
+      icon: <KeyIcon className="h-5 w-5" />,
+    },
+    {
+      name: "트랜잭션 로그",
+      path: "/user/dashboard/transactions",
+      icon: <History className="h-5 w-5" />,
+    },
+  ];
+
+  const routes = userRoutes;
+
+  return (
+    <div className="flex min-h-screen flex-col">
+      <header className="sticky top-0 z-30 flex h-16 items-center gap-4 border-b bg-white px-4 md:px-6">
+        {isSidebarOpen ? (
+          <div
+            className="fixed inset-0 bg-black/50 z-40"
+            onClick={() => setIsSidebarOpen(false)}
+          />
+        ) : null}
+
+        {/* 모바일 메뉴 버튼 */}
+        <button
+          className="inline-flex items-center justify-center rounded-md border border-[#CDE5FF] bg-transparent hover:bg-[#F6FBFF] text-[#101010] h-10 w-10 md:hidden"
+          onClick={() => setIsSidebarOpen(true)}
+        >
+          <Menu className="h-5 w-5" />
+          <span className="sr-only">메뉴 토글</span>
+        </button>
+
+        {/* 모바일 사이드바 */}
+        {isSidebarOpen && (
+          <div className="fixed inset-y-0 left-0 z-50 w-72 bg-white shadow-xl p-0">
+            <div className="flex h-16 items-center border-b px-6">
+              <Link
+                href="/dashboard"
+                className="flex items-center gap-2 font-semibold"
+                onClick={() => setIsSidebarOpen(false)}
+              >
+                <span className="text-[#0067AC] font-bold text-xl">
+                  PayGate
+                </span>
+              </Link>
+              <button
+                className="inline-flex items-center justify-center rounded-md bg-transparent hover:bg-[#F6FBFF] text-[#101010] h-10 w-10 ml-auto"
+                onClick={() => setIsSidebarOpen(false)}
+              >
+                <X className="h-5 w-5" />
+              </button>
+            </div>
+            <nav className="grid gap-2 p-4">
+              {routes.map((route) => (
+                <Link
+                  key={route.path}
+                  href={route.path}
+                  onClick={() => setIsSidebarOpen(false)}
+                  className={cn(
+                    "flex items-center gap-3 rounded-lg px-3 py-2 hover:bg-[#F6FBFF] transition-colors",
+                    pathname === route.path
+                      ? "bg-[#F6FBFF] text-[#0067AC]"
+                      : "text-[#5E99D6]"
+                  )}
+                >
+                  {route.icon}
+                  <span>{route.name}</span>
+                </Link>
+              ))}
+            </nav>
+          </div>
+        )}
+
+        {/* 브랜드 로고/이름 */}
+        <Link href="/dashboard" className="hidden md:flex items-center gap-2">
+          <span className="text-[#0067AC] font-bold text-xl">PayGate</span>
+        </Link>
+
+        {/* 헤더 오른쪽 섹션 */}
+        <div className="ml-auto flex items-center gap-4">
+
+          {/* 사용자 드롭다운 */}
+          <div className="relative">
+            <button
+              className="inline-flex items-center justify-center rounded-md bg-transparent hover:bg-[#F6FBFF] text-[#101010] h-8 px-3 text-sm gap-2"
+              onClick={() => setIsDropdownOpen(!isDropdownOpen)}
+            >
+              <div className="flex h-8 w-8 items-center justify-center rounded-full bg-[#5E99D6] text-white">
+                <span className="text-sm font-medium">김</span>
+              </div>
+              <div className="hidden md:flex flex-col items-start text-sm">
+                <span>김사용자</span>
+              </div>
+              <ChevronDown className="h-4 w-4 text-[#5E99D6]" />
+            </button>
+
+            {isDropdownOpen && (
+              <div className="absolute top-full mt-1 right-0 z-50 min-w-[200px] rounded-md border border-[#CDE5FF] bg-white p-2 shadow-md">
+                <div className="px-2 py-1 text-sm font-medium">내 계정</div>
+                <div className="my-1 h-px bg-[#CDE5FF]"></div>
+                <button
+                  className="flex w-full items-center rounded-sm px-2 py-1 text-sm hover:bg-[#F6FBFF]"
+                  onClick={() => setIsDropdownOpen(false)}
+                >
+                  <User className="mr-2 h-4 w-4" />
+                  <span>프로필</span>
+                </button>
+                <button
+                  className="flex w-full items-center rounded-sm px-2 py-1 text-sm hover:bg-[#F6FBFF]"
+                  onClick={() => setIsDropdownOpen(false)}
+                >
+                  <Settings className="mr-2 h-4 w-4" />
+                  <span>설정</span>
+                </button>
+                <div className="my-1 h-px bg-[#CDE5FF]"></div>
+                <button
+                  className="flex w-full items-center rounded-sm px-2 py-1 text-sm hover:bg-[#F6FBFF]"
+                  onClick={() => setIsDropdownOpen(false)}
+                >
+                  <LogOut className="mr-2 h-4 w-4" />
+                  <span>로그아웃</span>
+                </button>
+              </div>
+            )}
+          </div>
+        </div>
+      </header>
+
+      <div className="flex flex-1">
+        {/* 데스크톱 사이드바 */}
+        <aside className="hidden w-64 shrink-0 border-r md:block sticky top-16 h-[calc(100vh-4rem)]">
+          <div className="flex h-full flex-col p-4 overflow-y-auto">
+            <nav className="grid gap-2 text-sm flex-grow-0">
+              {routes.map((route) => (
+                <Link
+                  key={route.path}
+                  href={route.path}
+                  className={cn(
+                    "flex items-center gap-3 rounded-lg px-3 py-2 hover:bg-[#F6FBFF] transition-colors",
+                    pathname === route.path
+                      ? "bg-[#F6FBFF] text-[#0067AC]"
+                      : "text-[#5E99D6]"
+                  )}
+                >
+                  {route.icon}
+                  <span>{route.name}</span>
+                </Link>
+              ))}
+            </nav>
+            <div className="flex-grow"></div>
+            <div className="pt-4">
+              <div className="rounded-lg border border-[#CDE5FF] bg-white p-4">
+                <div className="flex items-center gap-4">
+                  <div className="flex h-8 w-8 items-center justify-center rounded-full bg-[#0067AC]">
+                    <span className="text-xs font-bold text-white">?</span>
+                  </div>
+                  <div>
+                    <div className="text-sm font-medium">
+                      도움이 필요하신가요?
+                    </div>
+                    <div className="text-xs text-[#5E99D6]">
+                      고객센터에 문의하세요
+                    </div>
+                  </div>
+                </div>
+                <button className="mt-4 w-full inline-flex items-center justify-center rounded-md border border-[#CDE5FF] bg-transparent hover:bg-[#F6FBFF] text-[#101010] h-8 px-3 text-sm">
+                  고객센터
+                </button>
+              </div>
+            </div>
+          </div>
+        </aside>
+
+        {/* 메인 콘텐츠 */}
+        <main className="flex-1 overflow-y-auto p-4 bg-[#F6FBFF]">
+          {children}
+        </main>
+      </div>
+    </div>
+  );
+}

app/api/admin/api-keys/route.ts

@@ -1,56 +1,6 @@
 import { NextRequest, NextResponse } from "next/server";
 import { BaseResponse, Page } from "@/types/api";
-
-/**
- * ApiKey 목록 조회 API의 개별 ApiKey DTO
- */
-export interface ApiKeyResponseDto {
-  /**
-   * API 키 ID
-   */
-  id: number;
-
-  /**
-   * 가맹점 ID
-   */
-  merchantId: number;
-
-  /**
-   * 가맹점 이름
-   */
-  merchantName: string;
-
-  /**
-   * API 키 이름
-   */
-  name: string;
-
-  /**
-   * 액세스 키
-   */
-  accessKey: string;
-
-  /**
-   * 액세스 키 활성화 여부
-   */
-  active: boolean;
-
-  /**
-   * 발급 시각
-   */
-  issuedAt: string;
-
-  /**
-   * 만료 시각
-   */
-  expiresAt: string | null;
-
-  /**
-   * 마지막 사용 시각
-   */
-  lastUsed: string | null;
-
-}
+import { ApiKeyResponseDto } from "@/types/api";
 
 /**
  * API 키 목록 조회 API (관리자용)

app/api/user/api-keys/route.ts

@@ -0,0 +1,77 @@
+import { NextRequest, NextResponse } from "next/server";
+import { BaseResponse, Page } from "@/types/api";
+import { ApiKeyResponseDto } from "@/types/api";
+
+/**
+ * API 키 목록 조회 API (가맹점용)
+ *
+ * @param req - API 키 목록 조회 요청 정보
+ * @returns API 키 목록과 페이징 정보가 포함된 응답
+ */
+export async function GET(req: NextRequest): Promise<NextResponse> {
+  try {
+    const { searchParams } = new URL(req.url);
+
+    // 페이지네이션 파라미터 추출
+    const page = searchParams.get("page") || "0";
+    const size = searchParams.get("size") || "10";
+    const sort = searchParams.get("sort") || "id,desc";
+
+    // API 키 목록 조회 URL
+    const url = `${process.env.NEXT_PUBLIC_API_URL}/api/api-keys?page=${page}&size=${size}&sort=${sort}`;
+
+    // 인증 토큰 가져오기
+    const authToken = req.headers.get("Authorization")?.replace("Bearer ", "");
+
+    // 인증 토큰이 없는 경우
+    if (!authToken) {
+      return NextResponse.json(
+        {
+          success: false,
+          message: "인증 토큰이 없습니다. 로그인 후 다시 시도해주세요.",
+        },
+        { status: 401 }
+      );
+    }
+
+    // 백엔드 API 호출
+    const response = await fetch(url, {
+      headers: {
+        Authorization: `Bearer ${authToken}`,
+        "Content-Type": "application/json",
+      },
+    });
+
+    // 응답 상태가 성공이 아닌 경우 처리
+    if (!response.ok) {
+      const errorData: BaseResponse<void> = await response.json();
+      return NextResponse.json(
+        {
+          success: false,
+          message: errorData.message || "API 키 목록 조회 실패",
+        },
+        { status: response.status }
+      );
+    }
+
+    // 정상적인 응답인 경우
+    const data: BaseResponse<Page<ApiKeyResponseDto>> = await response.json();
+    return NextResponse.json(data);
+
+  } catch (error: unknown) {
+    console.error("API 키 목록 조회 중 오류 발생:", error);
+
+    let errorMessage = "알 수 없는 오류가 발생했습니다.";
+    if (error instanceof Error) {
+      errorMessage = error.message;
+    }
+
+    return NextResponse.json(
+      {
+        success: false,
+        message: `API 키 목록 조회 중 오류: ${errorMessage}`,
+      },
+      { status: 500 }
+    );
+  }
+}