디자인 변경

2026-02-11 15:27:03 +09:00
parent 95291e6922
commit f650d51f68
15 changed files with 667 additions and 505 deletions
--- a/app/api/kis/revoke/route.ts
+++ b/app/api/kis/revoke/route.ts
@@ -1,35 +1,32 @@
 import type { DashboardKisRevokeResponse } from "@/features/dashboard/types/dashboard.types";
-import type { KisCredentialInput } from "@/lib/kis/config";
-import { hasKisConfig, normalizeTradingEnv } from "@/lib/kis/config";
+import { normalizeTradingEnv } from "@/lib/kis/config";
+import {
+  parseKisCredentialRequest,
+  validateKisCredentialInput,
+} from "@/lib/kis/request";
 import { revokeKisAccessToken } from "@/lib/kis/token";
 import { NextRequest, NextResponse } from "next/server";

 /**
 * @file app/api/kis/revoke/route.ts
- * @description 사용자 입력 KIS API 키 기반 접근토큰 폐기 라우트
+ * @description 사용자 입력 KIS API 키로 액세스 토큰을 폐기합니다.
 */

 /**
- * KIS API 접근토큰 폐기
- * @param request appKey/appSecret/tradingEnv JSON 본문
- * @returns 폐기 성공/실패 정보
- * @see features/dashboard/components/dashboard-main.tsx handleRevokeKis - 접근 폐기 버튼 클릭 이벤트
+ * @description KIS 액세스 토큰 폐기
+ * @see features/dashboard/components/auth/KisAuthForm.tsx
 */
 export async function POST(request: NextRequest) {
-  const body = (await request.json()) as Partial<DashboardKisRevokeRequest>;
+  const credentials = await parseKisCredentialRequest(request);
+  const tradingEnv = normalizeTradingEnv(credentials.tradingEnv);

-  const credentials: KisCredentialInput = {
-    appKey: body.appKey?.trim(),
-    appSecret: body.appSecret?.trim(),
-    tradingEnv: normalizeTradingEnv(body.tradingEnv),
-  };
-
-  if (!hasKisConfig(credentials)) {
+  const invalidMessage = validateKisCredentialInput(credentials);
+  if (invalidMessage) {
    return NextResponse.json(
      {
        ok: false,
-        tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
-        message: "앱 키와 앱 시크릿을 모두 입력해 주세요.",
+        tradingEnv,
+        message: invalidMessage,
      } satisfies DashboardKisRevokeResponse,
      { status: 400 },
    );
@@ -40,25 +37,22 @@ export async function POST(request: NextRequest) {

    return NextResponse.json({
      ok: true,
-      tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+      tradingEnv,
      message,
    } satisfies DashboardKisRevokeResponse);
  } catch (error) {
-    const message = error instanceof Error ? error.message : "API 키 접근 폐기 중 오류가 발생했습니다.";
+    const message =
+      error instanceof Error
+        ? error.message
+        : "API 토큰 폐기 중 오류가 발생했습니다.";

    return NextResponse.json(
      {
        ok: false,
-        tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+        tradingEnv,
        message,
      } satisfies DashboardKisRevokeResponse,
      { status: 401 },
    );
  }
 }
-
-interface DashboardKisRevokeRequest {
-  appKey: string;
-  appSecret: string;
-  tradingEnv: "real" | "mock";
-}
--- a/app/api/kis/validate/route.ts
+++ b/app/api/kis/validate/route.ts
@@ -1,65 +1,58 @@
-import type { DashboardKisValidateResponse } from "@/features/dashboard/types/dashboard.types";
-import type { KisCredentialInput } from "@/lib/kis/config";
-import { hasKisConfig, normalizeTradingEnv } from "@/lib/kis/config";
+import type { DashboardKisValidateResponse } from "@/features/dashboard/types/dashboard.types";
+import { normalizeTradingEnv } from "@/lib/kis/config";
+import {
+  parseKisCredentialRequest,
+  validateKisCredentialInput,
+} from "@/lib/kis/request";
 import { getKisAccessToken } from "@/lib/kis/token";
 import { NextRequest, NextResponse } from "next/server";

 /**
 * @file app/api/kis/validate/route.ts
- * @description 사용자 입력 KIS API 키 검증 라우트
+ * @description 사용자 입력 KIS API 키를 검증합니다.
 */

 /**
- * KIS API 키 검증
- * @param request appKey/appSecret/tradingEnv JSON 본문
- * @returns 검증 성공/실패 정보
- * @see features/dashboard/components/dashboard-main.tsx handleValidateKis - 검증 버튼 클릭 시 호출
+ * @description 액세스 토큰 발급 성공 여부로 API 키를 검증합니다.
+ * @see features/dashboard/components/auth/KisAuthForm.tsx
 */
 export async function POST(request: NextRequest) {
-  const body = (await request.json()) as Partial<DashboardKisValidateRequest>;
+  const credentials = await parseKisCredentialRequest(request);
+  const tradingEnv = normalizeTradingEnv(credentials.tradingEnv);

-  const credentials: KisCredentialInput = {
-    appKey: body.appKey?.trim(),
-    appSecret: body.appSecret?.trim(),
-    tradingEnv: normalizeTradingEnv(body.tradingEnv),
-  };
-
-  if (!hasKisConfig(credentials)) {
+  const invalidMessage = validateKisCredentialInput(credentials);
+  if (invalidMessage) {
    return NextResponse.json(
      {
        ok: false,
-        tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
-        message: "앱 키와 앱 시크릿을 모두 입력해 주세요.",
+        tradingEnv,
+        message: invalidMessage,
      } satisfies DashboardKisValidateResponse,
      { status: 400 },
    );
  }

  try {
-    // 검증 단계는 토큰 발급 성공 여부만 확인합니다.
    await getKisAccessToken(credentials);

    return NextResponse.json({
      ok: true,
-      tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+      tradingEnv,
      message: "API 키 검증이 완료되었습니다. (토큰 발급 성공)",
    } satisfies DashboardKisValidateResponse);
  } catch (error) {
-    const message = error instanceof Error ? error.message : "API 키 검증 중 오류가 발생했습니다.";
+    const message =
+      error instanceof Error
+        ? error.message
+        : "API 키 검증 중 오류가 발생했습니다.";

    return NextResponse.json(
      {
        ok: false,
-        tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+        tradingEnv,
        message,
      } satisfies DashboardKisValidateResponse,
      { status: 401 },
    );
  }
 }
-
-interface DashboardKisValidateRequest {
-  appKey: string;
-  appSecret: string;
-  tradingEnv: "real" | "mock";
-}
--- a/app/api/kis/ws/approval/route.ts
+++ b/app/api/kis/ws/approval/route.ts
@@ -1,35 +1,32 @@
 import type { DashboardKisWsApprovalResponse } from "@/features/dashboard/types/dashboard.types";
-import type { KisCredentialInput } from "@/lib/kis/config";
-import { hasKisConfig, normalizeTradingEnv } from "@/lib/kis/config";
 import { getKisApprovalKey, resolveKisWebSocketUrl } from "@/lib/kis/approval";
+import { normalizeTradingEnv } from "@/lib/kis/config";
+import {
+  parseKisCredentialRequest,
+  validateKisCredentialInput,
+} from "@/lib/kis/request";
 import { NextRequest, NextResponse } from "next/server";

 /**
 * @file app/api/kis/ws/approval/route.ts
- * @description KIS 웹소켓 approval key 발급 라우트
+ * @description KIS 웹소켓 승인키와 WS URL을 발급합니다.
 */

 /**
- * 실시간 웹소켓 승인키 발급
- * @param request appKey/appSecret/tradingEnv JSON 본문
- * @returns approval key + ws url
- * @see features/dashboard/components/dashboard-main.tsx connectKisRealtimePrice - 실시간 체결가 구독 진입점
+ * @description 실시간 웹소켓 연결 정보를 발급합니다.
+ * @see features/dashboard/hooks/useKisTradeWebSocket.ts
 */
 export async function POST(request: NextRequest) {
-  const body = (await request.json()) as Partial<DashboardKisWsApprovalRequest>;
+  const credentials = await parseKisCredentialRequest(request);
+  const tradingEnv = normalizeTradingEnv(credentials.tradingEnv);

-  const credentials: KisCredentialInput = {
-    appKey: body.appKey?.trim(),
-    appSecret: body.appSecret?.trim(),
-    tradingEnv: normalizeTradingEnv(body.tradingEnv),
-  };
-
-  if (!hasKisConfig(credentials)) {
+  const invalidMessage = validateKisCredentialInput(credentials);
+  if (invalidMessage) {
    return NextResponse.json(
      {
        ok: false,
-        tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
-        message: "앱 키와 앱 시크릿을 모두 입력해 주세요.",
+        tradingEnv,
+        message: invalidMessage,
      } satisfies DashboardKisWsApprovalResponse,
      { status: 400 },
    );
@@ -41,27 +38,24 @@ export async function POST(request: NextRequest) {

    return NextResponse.json({
      ok: true,
-      tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+      tradingEnv,
      approvalKey,
      wsUrl,
-      message: "KIS 실시간 웹소켓 승인키 발급이 완료되었습니다.",
+      message: "웹소켓 승인키 발급이 완료되었습니다.",
    } satisfies DashboardKisWsApprovalResponse);
  } catch (error) {
-    const message = error instanceof Error ? error.message : "웹소켓 승인키 발급 중 오류가 발생했습니다.";
+    const message =
+      error instanceof Error
+        ? error.message
+        : "웹소켓 승인키 발급 중 오류가 발생했습니다.";

    return NextResponse.json(
      {
        ok: false,
-        tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+        tradingEnv,
        message,
      } satisfies DashboardKisWsApprovalResponse,
      { status: 401 },
    );
  }
 }
-
-interface DashboardKisWsApprovalRequest {
-  appKey: string;
-  appSecret: string;
-  tradingEnv: "real" | "mock";
-}