대시보드 구현

app/(main)/dashboard/page.tsx

@@ -4,13 +4,13 @@
  */
 
 import { redirect } from "next/navigation";
+import { DashboardContainer } from "@/features/dashboard/components/DashboardContainer";
 import { createClient } from "@/utils/supabase/server";
 
 /**
- * 대시보드 페이지 (향후 확장용)
- * @returns 빈 대시보드 안내 UI
- * @see app/(main)/trade/page.tsx 트레이딩 기능은 `/trade` 경로에서 제공합니다.
- * @see app/(main)/settings/page.tsx KIS 인증 설정은 `/settings` 경로에서 제공합니다.
+ * 대시보드 페이지
+ * @returns DashboardContainer UI
+ * @see features/dashboard/components/DashboardContainer.tsx 대시보드 상태 헤더/지수/보유종목 UI를 제공합니다.
  */
 export default async function DashboardPage() {
   // 상태 정의: 서버에서 세션을 먼저 확인해 비로그인 접근을 차단합니다.
@@ -21,17 +21,5 @@ export default async function DashboardPage() {
 
   if (!user) redirect("/login");
 
-  return (
-    <section className="mx-auto flex h-full w-full max-w-5xl flex-col justify-center p-6">
-      {/* ========== DASHBOARD PLACEHOLDER ========== */}
-      <div className="rounded-2xl border border-brand-200 bg-background p-8 shadow-sm dark:border-brand-800/45 dark:bg-brand-900/14">
-        <h1 className="text-2xl font-semibold tracking-tight text-foreground">
-          대시보드
-        </h1>
-        <p className="mt-2 text-sm text-muted-foreground">
-          이 페이지는 향후 포트폴리오 요약과 리포트 기능을 위한 확장 영역입니다.
-        </p>
-      </div>
-    </section>
-  );
+  return <DashboardContainer />;
 }

app/api/kis/domestic/_shared.ts

@@ -0,0 +1,45 @@
+import { parseKisAccountParts } from "@/lib/kis/account";
+import {
+  normalizeTradingEnv,
+  type KisCredentialInput,
+} from "@/lib/kis/config";
+
+/**
+ * @description 요청 헤더에서 KIS 키를 읽어옵니다.
+ * @param headers 요청 헤더
+ * @returns KIS 인증 입력값
+ * @see app/api/kis/domestic/balance/route.ts 대시보드 잔고 API 인증키 파싱
+ * @see app/api/kis/domestic/indices/route.ts 대시보드 지수 API 인증키 파싱
+ */
+export function readKisCredentialsFromHeaders(headers: Headers): KisCredentialInput {
+  const appKey = headers.get("x-kis-app-key")?.trim();
+  const appSecret = headers.get("x-kis-app-secret")?.trim();
+  const tradingEnv = normalizeTradingEnv(
+    headers.get("x-kis-trading-env") ?? undefined,
+  );
+
+  return {
+    appKey,
+    appSecret,
+    tradingEnv,
+  };
+}
+
+/**
+ * @description 요청 헤더(또는 서버 환경변수)에서 계좌번호(8-2)를 읽어옵니다.
+ * @param headers 요청 헤더
+ * @returns 계좌번호 파트(8 + 2) 또는 null
+ * @see app/api/kis/domestic/balance/route.ts 잔고 조회 시 필수 계좌정보 파싱
+ */
+export function readKisAccountParts(headers: Headers) {
+  const headerAccountNo = headers.get("x-kis-account-no");
+  const headerAccountProductCode = headers.get("x-kis-account-product-code");
+
+  const envAccountNo = process.env.KIS_ACCOUNT_NO;
+  const envAccountProductCode = process.env.KIS_ACCOUNT_PRODUCT_CODE;
+
+  return (
+    parseKisAccountParts(headerAccountNo, headerAccountProductCode) ??
+    parseKisAccountParts(envAccountNo, envAccountProductCode)
+  );
+}

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

@@ -0,0 +1,65 @@
+import { NextResponse } from "next/server";
+import type { DashboardBalanceResponse } from "@/features/dashboard/types/dashboard.types";
+import { hasKisConfig, normalizeTradingEnv } from "@/lib/kis/config";
+import { getDomesticDashboardBalance } from "@/lib/kis/dashboard";
+import {
+  readKisAccountParts,
+  readKisCredentialsFromHeaders,
+} from "@/app/api/kis/domestic/_shared";
+
+/**
+ * @file app/api/kis/domestic/balance/route.ts
+ * @description 국내주식 계좌 잔고/보유종목 조회 API
+ */
+
+/**
+ * 대시보드 잔고 조회 API
+ * @returns 총자산/손익/보유종목 목록
+ * @see features/dashboard/hooks/use-dashboard-data.ts 대시보드 초기 로드/새로고침에서 호출합니다.
+ */
+export async function GET(request: Request) {
+  const credentials = readKisCredentialsFromHeaders(request.headers);
+
+  if (!hasKisConfig(credentials)) {
+    return NextResponse.json(
+      {
+        error: "KIS API 키 설정이 필요합니다.",
+      },
+      { status: 400 },
+    );
+  }
+
+  const account = readKisAccountParts(request.headers);
+  if (!account) {
+    return NextResponse.json(
+      {
+        error:
+          "계좌번호가 필요합니다. 설정에서 계좌번호(예: 12345678-01)를 입력해 주세요.",
+      },
+      { status: 400 },
+    );
+  }
+
+  try {
+    const result = await getDomesticDashboardBalance(account, credentials);
+    const response: DashboardBalanceResponse = {
+      source: "kis",
+      tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+      summary: result.summary,
+      holdings: result.holdings,
+      fetchedAt: new Date().toISOString(),
+    };
+
+    return NextResponse.json(response, {
+      headers: {
+        "cache-control": "no-store",
+      },
+    });
+  } catch (error) {
+    const message =
+      error instanceof Error
+        ? error.message
+        : "잔고 조회 중 오류가 발생했습니다.";
+    return NextResponse.json({ error: message }, { status: 500 });
+  }
+}

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

@@ -0,0 +1,50 @@
+import { NextResponse } from "next/server";
+import type { DashboardIndicesResponse } from "@/features/dashboard/types/dashboard.types";
+import { hasKisConfig, normalizeTradingEnv } from "@/lib/kis/config";
+import { getDomesticDashboardIndices } from "@/lib/kis/dashboard";
+import { readKisCredentialsFromHeaders } from "@/app/api/kis/domestic/_shared";
+
+/**
+ * @file app/api/kis/domestic/indices/route.ts
+ * @description 국내 주요 지수(KOSPI/KOSDAQ) 조회 API
+ */
+
+/**
+ * 대시보드 지수 조회 API
+ * @returns 코스피/코스닥 지수 목록
+ * @see features/dashboard/hooks/use-dashboard-data.ts 대시보드 초기 로드/주기 갱신에서 호출합니다.
+ */
+export async function GET(request: Request) {
+  const credentials = readKisCredentialsFromHeaders(request.headers);
+
+  if (!hasKisConfig(credentials)) {
+    return NextResponse.json(
+      {
+        error: "KIS API 키 설정이 필요합니다.",
+      },
+      { status: 400 },
+    );
+  }
+
+  try {
+    const items = await getDomesticDashboardIndices(credentials);
+    const response: DashboardIndicesResponse = {
+      source: "kis",
+      tradingEnv: normalizeTradingEnv(credentials.tradingEnv),
+      items,
+      fetchedAt: new Date().toISOString(),
+    };
+
+    return NextResponse.json(response, {
+      headers: {
+        "cache-control": "no-store",
+      },
+    });
+  } catch (error) {
+    const message =
+      error instanceof Error
+        ? error.message
+        : "지수 조회 중 오류가 발생했습니다.";
+    return NextResponse.json({ error: message }, { status: 500 });
+  }
+}