SIGNO — 한국·미국 증시 대시보드

지수·수급·섹터·종목을 한 화면에서 보는 시장 대시보드. Next.js 16 (App Router) · React 19 · Tailwind 4 · SWR · Vercel.

운영 https://signo-chi.vercel.app

작업을 이어받는다면 HANDOFF.md 를 먼저 읽으세요 — 구조, 데이터 출처, 겪은 함정, KIS TR 코드가 정리되어 있습니다.

이 구조를 다른 앱에 참고하려면 PATTERNS.md — UI 배치와 데이터 흐름을 구간별로 나눠 실제 코드와 함께 설명한 문서입니다.

국내 종목탭을 다른 데이터 출처로 옮기려면 PORTING-STOCK-TAB.md — 복사할 파일 29개, 데이터 계약, 코스콤 매핑과 빠지는 항목이 정리되어 있습니다.

실행

npm install && npm run dev

키가 없어도 야후·네이버로 대부분 동작합니다. .env.example 을 .env.local 로 복사해 키를 채우면 KIS 기능(프로그램매매·지수선물·NXT·실시간 수급·미국 주간거래)과 Redis 캐시가 켜집니다.

npm run build    # 타입 체크 포함 — push 전에 통과시킬 것

화면

경로	내용
/	한국 대시보드 — 지수·수급, 증시 주변자금, 시장수급, 섹터 강약, 특징주, 시총상위
/market	한국 시장지표 — 아시아 증시·지수선물·환율·원자재·가상자산·국채금리
/stock	한국 종목 — 차트, 투자자수급, 종목상세, 재무제표, 섹터 종합평가
/us /us/market /us/stock	미국증시 (위와 같은 구성)
/watchlist	관심종목
/calendar	경제 캘린더 + 주요 기업 실적발표

대시보드에서 장 마감 리포트를 텍스트로 내려받을 수 있습니다 (한국·미국 각각).

데이터

출처	쓰는 곳	키
네이버 금융	국내 시세·수급·업종·국채금리·증시자금	불필요
야후 파이낸스	미국·글로벌 전반, 실적발표일	불필요
한국투자증권 (KIS)	프로그램매매·지수선물·NXT·장중 추정수급·미국 주간거래	필요
finviz · ForexFactory	경제지표 캘린더 (미국 / 일본·유럽)	불필요

구조

src/
  app/        화면 + api/ (29개 라우트, lib 을 캐시로 감싸 호출만 함)
  components/ sections/(화면 블록) stock/(종목 카드) us/(미국 전용)
  lib/        데이터 수집·가공 — naverApi · us · kis · score · session …

핵심 공용 모듈 — 채점 규칙 lib/score.ts, 세션 판정 lib/session.ts, 캐시 lib/cache.ts (배포마다 키가 갈립니다).

디자인

브랜드 인디고 #3844BE, 상승 빨강 #E23D3D / 하락 파랑 #2E77C9 (한국 관례). globals.css 의 @theme 에서 관리하며 라이트/다크가 전환됩니다.

---

본 사이트에서 제공하는 지표는 투자 참고용이며, 투자의 최종 책임은 투자자 본인에게 있습니다.