Files
stock_chart_site/web/app/[code]/page.tsx
claude-owner fed8ff287e feat(orderbook): 10단계 호가 패널 (KIS asking-price 스냅샷)
backend:
- fetch/kis.py: fetch_orderbook(code) — KIS FHKST01010200 (inquire-asking-price-exp-ccn)
  호출. output1 의 askp1~10/bidp1~10 + 잔량 + 합계, output2 의 현재가/전일대비 파싱.
- api/orderbook.py: GET /api/orderbook/{code}. symbols 매칭 안 되면 404, KIS 키 없으면
  skipped_missing_key 상태로 빈 호가 반환 (502 와 구분).
- main.py: orderbook_router 등록.

frontend:
- lib/api.ts: OrderbookResponse 타입 + api.orderbook(code).
- components/OrderbookPanel.tsx: 매도 10단계(위→아래 가격 내림차순) / 현재가(굵게, 전일대비)
  / 매수 10단계. 잔량 막대는 사이드별 max 정규화로 셀 안에서 자라남. ask=파랑, bid=빨강
  (한국 거래소 관행). 10초 폴링.
- app/[code]/page.tsx: 사이드바에 SymbolSidebar 다음으로 OrderbookPanel 마운트.

실시간 ws 가 아니라 HTTP 폴링이라 KIS rate-limit 친화적. 표시 전용 — 주문/체결 endpoint 는
일절 import 하지 않음 (kis.py 문서 정책).
2026-05-28 19:13:35 +09:00

184 lines
6.4 KiB
TypeScript

"use client";
import Link from "next/link";
import { useEffect, useMemo, useState } from "react";
import { AlertsPanel } from "../../components/AlertsPanel";
import { CompositeScoreCard } from "../../components/CompositeScoreCard";
import { DisclosuresPanel } from "../../components/DisclosuresPanel";
import { MetricsPanel } from "../../components/MetricsPanel";
import { PeerComparePanel } from "../../components/PeerComparePanel";
import { NewsList } from "../../components/NewsList";
import { OrderbookPanel } from "../../components/OrderbookPanel";
import { PeriodReturns } from "../../components/PeriodReturns";
import { PeriodTabs, periodSpec, type Period } from "../../components/PeriodTabs";
import { PredictionPanel } from "../../components/PredictionPanel";
import { PriceHero } from "../../components/PriceHero";
import { RelatedStocks } from "../../components/RelatedStocks";
import { StarButton } from "../../components/StarButton";
import { StockChart } from "../../components/StockChart";
import { SymbolSidebar } from "../../components/SymbolSidebar";
import { TradingValuePanel } from "../../components/TradingValuePanel";
import { api, type ChartPayload, type LatestPredictionResponse } from "../../lib/api";
import { recent } from "../../lib/recent";
export default function CodePage({ params }: { params: { code: string } }) {
const { code } = params;
const [chart, setChart] = useState<ChartPayload | null>(null);
const [prediction, setPrediction] = useState<LatestPredictionResponse | null>(null);
const [err, setErr] = useState<string | null>(null);
const [period, setPeriod] = useState<Period>("3M");
const spec = periodSpec(period);
const isIntraday = spec.interval === "10m";
// 종목 페이지 방문 시 최근 본 종목에 push.
useEffect(() => {
recent.push(code);
}, [code]);
useEffect(() => {
let alive = true;
setErr(null);
setChart(null);
const load = () => {
api
.getChart(code, spec.days, spec.interval)
.then((c) => {
if (alive) setChart(c);
})
.catch((e) => {
if (alive) setErr(e instanceof Error ? e.message : String(e));
});
};
load();
// 1일(10분봉) 모드만 60s 폴링 — 백엔드가 10분 내면 DB 만 읽음.
if (isIntraday) {
const h = window.setInterval(load, 60_000);
return () => {
alive = false;
window.clearInterval(h);
};
}
return () => {
alive = false;
};
}, [code, spec.days, spec.interval, isIntraday]);
useEffect(() => {
let alive = true;
api
.latestPrediction(code)
.then((r) => {
if (alive && r.found) setPrediction(r);
})
.catch(() => {
// 예측 이력 없음 — 무시
});
return () => {
alive = false;
};
}, [code]);
// 현재가/전일가 + 헤더 sparkline 시리즈 — ohlcv 끝부분에서 산출.
const { current, prev, asOf, sparkSeries } = useMemo(() => {
if (!chart || !chart.ohlcv.length)
return { current: null, prev: null, asOf: null, sparkSeries: [] as number[] };
const valid = chart.ohlcv.filter((p) => p.close != null);
if (!valid.length)
return { current: null, prev: null, asOf: null, sparkSeries: [] as number[] };
const last = valid[valid.length - 1];
const prevPt = valid.length >= 2 ? valid[valid.length - 2] : null;
// 최근 30개 종가 (없으면 가용 전체).
const recent = valid.slice(-30).map((p) => p.close as number);
return {
current: last.close,
prev: prevPt?.close ?? null,
asOf: last.date,
sparkSeries: recent,
};
}, [chart]);
return (
<main className="mx-auto max-w-5xl px-6 py-8">
<div className="mb-4 flex items-center justify-between gap-3">
<div className="flex items-center gap-3">
<Link href="/" className="text-xs text-zinc-500 hover:text-zinc-300">
</Link>
<Link
href="/watchlist"
className="text-xs text-zinc-500 hover:text-zinc-300"
>
</Link>
</div>
<div className="flex items-center gap-3">
<Link
href={`/compare?codes=${code}`}
className="rounded-md border border-zinc-700 px-2 py-0.5 text-[11px] text-zinc-400 hover:border-zinc-500 hover:text-zinc-200"
title="이 종목으로 비교 시작"
>
</Link>
<StarButton code={code} name={chart?.name} />
<PeriodTabs value={period} onChange={(id) => setPeriod(id)} />
</div>
</div>
{err && <div className="mb-4 text-sm text-red-400"> : {err}</div>}
{chart && (
<>
<PriceHero
name={chart.name}
code={chart.code}
market={chart.market}
current={current}
prev={prev}
asOf={asOf}
series={sparkSeries}
/>
<div className="grid gap-6 lg:grid-cols-[1fr_280px]">
<div>
<StockChart chart={chart} prediction={prediction} />
{isIntraday && chart.intraday_status && (
<div className="mt-2 text-right text-[11px] text-zinc-500">
10 · 60 · [{chart.intraday_status}]
</div>
)}
<div className="mt-6">
<PredictionPanel code={code} initial={prediction} onResult={setPrediction} />
</div>
</div>
<div className="space-y-4">
<SymbolSidebar code={code} />
<OrderbookPanel code={code} />
<AlertsPanel code={code} name={chart?.name} current={current} />
<RelatedStocks code={code} />
</div>
</div>
<div className="mt-6">
<CompositeScoreCard chart={chart} />
</div>
<div className="mt-6">
<PeriodReturns ohlcv={chart.ohlcv} />
</div>
<div className="mt-6">
<PeerComparePanel code={code} />
</div>
<div className="mt-6 grid gap-6 md:grid-cols-2">
<TradingValuePanel data={chart.trading_value} />
<MetricsPanel code={code} />
</div>
<div className="mt-6 grid gap-6 md:grid-cols-2">
<NewsList code={code} />
<DisclosuresPanel code={code} />
</div>
</>
)}
</main>
);
}