대시보드

features/dashboard/types/dashboard.types.ts

@@ -0,0 +1,108 @@
+/**
+ * @file features/dashboard/types/dashboard.types.ts
+ * @description 대시보드(검색/시세/차트)에서 공통으로 쓰는 타입 모음
+ */
+
+export type KisTradingEnv = "real" | "mock";
+export type DashboardPriceSource = "inquire-price" | "inquire-ccnl" | "inquire-overtime-price";
+export type DashboardMarketPhase = "regular" | "afterHours";
+
+/**
+ * KOSPI/KOSDAQ 종목 인덱스 항목
+ */
+export interface KoreanStockIndexItem {
+  symbol: string;
+  name: string;
+  market: "KOSPI" | "KOSDAQ";
+  standardCode: string;
+}
+
+/**
+ * 차트 1개 점(시점 + 가격)
+ */
+export interface StockCandlePoint {
+  time: string;
+  price: number;
+}
+
+/**
+ * 대시보드 종목 상세 모델
+ */
+export interface DashboardStockItem {
+  symbol: string;
+  name: string;
+  market: "KOSPI" | "KOSDAQ";
+  currentPrice: number;
+  change: number;
+  changeRate: number;
+  open: number;
+  high: number;
+  low: number;
+  prevClose: number;
+  volume: number;
+  candles: StockCandlePoint[];
+}
+
+/**
+ * 검색 결과 1개 항목
+ */
+export interface DashboardStockSearchItem {
+  symbol: string;
+  name: string;
+  market: "KOSPI" | "KOSDAQ";
+}
+
+/**
+ * 종목 검색 API 응답
+ */
+export interface DashboardStockSearchResponse {
+  query: string;
+  items: DashboardStockSearchItem[];
+  total: number;
+}
+
+/**
+ * 종목 개요 API 응답
+ */
+export interface DashboardStockOverviewResponse {
+  stock: DashboardStockItem;
+  source: "kis";
+  priceSource: DashboardPriceSource;
+  marketPhase: DashboardMarketPhase;
+  tradingEnv: KisTradingEnv;
+  fetchedAt: string;
+}
+
+/**
+ * KIS 키 검증 API 응답
+ */
+export interface DashboardKisValidateResponse {
+  ok: boolean;
+  tradingEnv: KisTradingEnv;
+  message: string;
+  sample?: {
+    symbol: string;
+    name: string;
+    currentPrice: number;
+  };
+}
+
+/**
+ * KIS 키 접근 폐기 API 응답
+ */
+export interface DashboardKisRevokeResponse {
+  ok: boolean;
+  tradingEnv: KisTradingEnv;
+  message: string;
+}
+
+/**
+ * KIS 웹소켓 승인키 발급 API 응답
+ */
+export interface DashboardKisWsApprovalResponse {
+  ok: boolean;
+  tradingEnv: KisTradingEnv;
+  message: string;
+  approvalKey?: string;
+  wsUrl?: string;
+}