전체적인 리팩토링

app/api/kis/domestic/chart/route.ts

@@ -15,6 +15,9 @@ import { readKisCredentialsFromHeaders } from "@/app/api/kis/domestic/_shared";
 
 const VALID_TIMEFRAMES: DashboardChartTimeframe[] = [
   "1m",
+  "5m",
+  "10m",
+  "15m",
   "30m",
   "1h",
   "1d",

app/api/kis/domestic/market-hub/route.ts

@@ -0,0 +1,72 @@
+import { NextResponse } from "next/server";
+import type { DashboardMarketHubResponse } from "@/features/dashboard/types/dashboard.types";
+import { hasKisConfig, normalizeTradingEnv } from "@/lib/kis/config";
+import { getDomesticDashboardMarketHub } from "@/lib/kis/dashboard";
+import { hasKisApiSession } from "@/app/api/kis/_session";
+import {
+  createKisApiErrorResponse,
+  KIS_API_ERROR_CODE,
+  toKisApiErrorMessage,
+} from "@/app/api/kis/_response";
+import { readKisCredentialsFromHeaders } from "@/app/api/kis/domestic/_shared";
+
+/**
+ * @file app/api/kis/domestic/market-hub/route.ts
+ * @description 국내주식 시장 허브(급등/인기/뉴스) 조회 API
+ */
+
+/**
+ * 대시보드 시장 허브 조회 API
+ * @returns 급등주식/인기종목/주요뉴스 목록
+ * @remarks UI 흐름: DashboardContainer -> useDashboardData -> /api/kis/domestic/market-hub -> MarketHubSection 렌더링
+ */
+export async function GET(request: Request) {
+  const hasSession = await hasKisApiSession();
+  if (!hasSession) {
+    return createKisApiErrorResponse({
+      status: 401,
+      code: KIS_API_ERROR_CODE.AUTH_REQUIRED,
+      message: "로그인이 필요합니다.",
+    });
+  }
+
+  const credentials = readKisCredentialsFromHeaders(request.headers);
+  if (!hasKisConfig(credentials)) {
+    return createKisApiErrorResponse({
+      status: 400,
+      code: KIS_API_ERROR_CODE.CREDENTIAL_REQUIRED,
+      message: "KIS API 키 설정이 필요합니다.",
+    });
+  }
+
+  try {
+    const result = await getDomesticDashboardMarketHub(credentials);
+    const response: DashboardMarketHubResponse = {
+      source: "kis",
+      tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+      gainers: result.gainers,
+      losers: result.losers,
+      popularByVolume: result.popularByVolume,
+      popularByValue: result.popularByValue,
+      news: result.news,
+      pulse: result.pulse,
+      warnings: result.warnings,
+      fetchedAt: new Date().toISOString(),
+    };
+
+    return NextResponse.json(response, {
+      headers: {
+        "cache-control": "no-store",
+      },
+    });
+  } catch (error) {
+    return createKisApiErrorResponse({
+      status: 500,
+      code: KIS_API_ERROR_CODE.UPSTREAM_FAILURE,
+      message: toKisApiErrorMessage(
+        error,
+        "시장 허브 조회 중 오류가 발생했습니다.",
+      ),
+    });
+  }
+}

app/api/kis/domestic/orderable-cash/route.ts

@@ -0,0 +1,124 @@
+import { NextRequest, NextResponse } from "next/server";
+import { z } from "zod";
+import { executeInquireOrderableCash } from "@/lib/kis/trade";
+import type { DashboardStockOrderableCashResponse } from "@/features/trade/types/trade.types";
+import { hasKisApiSession } from "@/app/api/kis/_session";
+import { hasKisConfig, normalizeTradingEnv } from "@/lib/kis/config";
+import {
+  createKisApiErrorResponse,
+  KIS_API_ERROR_CODE,
+  toKisApiErrorMessage,
+} from "@/app/api/kis/_response";
+import {
+  readKisAccountParts,
+  readKisCredentialsFromHeaders,
+} from "@/app/api/kis/domestic/_shared";
+
+/**
+ * @file app/api/kis/domestic/orderable-cash/route.ts
+ * @description 국내주식 매수가능금액(주문가능현금) 조회 API
+ */
+
+const orderableCashBodySchema = z.object({
+  symbol: z
+    .string()
+    .trim()
+    .regex(/^\d{6}$/, "종목코드는 6자리 숫자여야 합니다."),
+  price: z.coerce.number().positive("기준 가격은 0보다 커야 합니다."),
+  orderType: z.enum(["limit", "market"]).default("market"),
+});
+
+export async function POST(request: NextRequest) {
+  const credentials = readKisCredentialsFromHeaders(request.headers);
+  const tradingEnv = normalizeTradingEnv(credentials.tradingEnv);
+
+  const hasSession = await hasKisApiSession();
+  if (!hasSession) {
+    return createKisApiErrorResponse({
+      status: 401,
+      code: KIS_API_ERROR_CODE.AUTH_REQUIRED,
+      message: "로그인이 필요합니다.",
+      tradingEnv,
+    });
+  }
+
+  if (!hasKisConfig(credentials)) {
+    return createKisApiErrorResponse({
+      status: 400,
+      code: KIS_API_ERROR_CODE.CREDENTIAL_REQUIRED,
+      message: "KIS API 키 설정이 필요합니다.",
+      tradingEnv,
+    });
+  }
+
+  const account = readKisAccountParts(request.headers);
+  if (!account) {
+    return createKisApiErrorResponse({
+      status: 400,
+      code: KIS_API_ERROR_CODE.ACCOUNT_REQUIRED,
+      message:
+        "계좌번호가 필요합니다. 설정에서 계좌번호(예: 12345678-01)를 입력해 주세요.",
+      tradingEnv,
+    });
+  }
+
+  try {
+    let rawBody: unknown = {};
+    try {
+      rawBody = (await request.json()) as unknown;
+    } catch {
+      return createKisApiErrorResponse({
+        status: 400,
+        code: KIS_API_ERROR_CODE.INVALID_REQUEST,
+        message: "요청 본문(JSON)을 읽을 수 없습니다.",
+        tradingEnv,
+      });
+    }
+
+    const parsed = orderableCashBodySchema.safeParse(rawBody);
+    if (!parsed.success) {
+      return createKisApiErrorResponse({
+        status: 400,
+        code: KIS_API_ERROR_CODE.INVALID_REQUEST,
+        message: parsed.error.issues[0]?.message ?? "요청값이 올바르지 않습니다.",
+        tradingEnv,
+      });
+    }
+
+    const result = await executeInquireOrderableCash(
+      {
+        symbol: parsed.data.symbol,
+        price: parsed.data.price,
+        orderType: parsed.data.orderType,
+        accountNo: account.accountNo,
+        accountProductCode: account.accountProductCode,
+      },
+      credentials,
+    );
+
+    const response: DashboardStockOrderableCashResponse = {
+      ok: true,
+      tradingEnv,
+      orderableCash: result.orderableCash,
+      noReceivableBuyAmount: result.noReceivableBuyAmount,
+      maxBuyAmount: result.maxBuyAmount,
+      maxBuyQuantity: result.maxBuyQuantity,
+      noReceivableBuyQuantity: result.noReceivableBuyQuantity,
+      fetchedAt: new Date().toISOString(),
+    };
+
+    return NextResponse.json(response, {
+      headers: {
+        "cache-control": "no-store",
+      },
+    });
+  } catch (error) {
+    return createKisApiErrorResponse({
+      status: 500,
+      code: KIS_API_ERROR_CODE.UPSTREAM_FAILURE,
+      message: toKisApiErrorMessage(error, "매수가능금액 조회 중 오류가 발생했습니다."),
+      tradingEnv,
+    });
+  }
+}
+

app/api/kis/indices/route.ts

@@ -0,0 +1,64 @@
+/**
+ * @file app/api/kis/indices/route.ts
+ * @description 국내 KOSPI/KOSDAQ 지수 조회 API
+ *
+ * @description [주요 책임]
+ * - 로그인 및 KIS API 설정 여부 확인
+ * - `getDomesticDashboardIndices` 함수를 호출하여 지수 데이터를 조회
+ * - 조회된 데이터를 클라이언트에 JSON 형식으로 반환
+ */
+import { NextResponse } from "next/server";
+import { hasKisConfig } from "@/lib/kis/config";
+import { getDomesticDashboardIndices } from "@/lib/kis/dashboard";
+import { hasKisApiSession } from "@/app/api/kis/_session";
+import {
+  createKisApiErrorResponse,
+  KIS_API_ERROR_CODE,
+  toKisApiErrorMessage,
+} from "@/app/api/kis/_response";
+import { readKisCredentialsFromHeaders } from "@/app/api/kis/domestic/_shared";
+
+export async function GET(request: Request) {
+  const hasSession = await hasKisApiSession();
+  if (!hasSession) {
+    return createKisApiErrorResponse({
+      status: 401,
+      code: KIS_API_ERROR_CODE.AUTH_REQUIRED,
+      message: "로그인이 필요합니다.",
+    });
+  }
+
+  const credentials = readKisCredentialsFromHeaders(request.headers);
+
+  if (!hasKisConfig(credentials)) {
+    return createKisApiErrorResponse({
+      status: 400,
+      code: KIS_API_ERROR_CODE.CREDENTIAL_REQUIRED,
+      message: "KIS API 키 설정이 필요합니다.",
+    });
+  }
+
+  try {
+    const indices = await getDomesticDashboardIndices(credentials);
+    return NextResponse.json(
+      {
+        indices,
+        fetchedAt: new Date().toISOString(),
+      },
+      {
+        headers: {
+          "cache-control": "no-store",
+        },
+      },
+    );
+  } catch (error) {
+    return createKisApiErrorResponse({
+      status: 500,
+      code: KIS_API_ERROR_CODE.UPSTREAM_FAILURE,
+      message: toKisApiErrorMessage(
+        error,
+        "지수 조회 중 오류가 발생했습니다.",
+      ),
+    });
+  }
+}