기획서

기획서 — Tenbagger Hunter

요약 페이지입니다. 전체 명세는 PRD.md 참고.

1. 서비스 주제

사용자가 입력한 자연어 테마를 AI가 해석해 10배(ten bagger) 상승 가능성이 있는 기업 후보를 발굴하고, 왜 그 기업인지를 내러티브 + 데이터로 설명하는 글로벌(한국+미국) 주식 리서치 어시스턴트.

단순 스크리너(숫자 필터링)와 달리 — 자연어 테마 탐색 / 스토리텔링(Bull·Bear·Verdict) / 최신 뉴스+재무 동적 반영 / 한·미 통합이 차별점.

2. 핵심 기능

기능	설명	우선순위
테마 기반 탐색	자연어 테마 → 관련 기업 5~8개 도출 (한/미/전체 필터)	P0
Tenbagger Score	5개 축(TAM/해자/경영진/재무/내러티브) 0~100 점수	P0
Bull / Bear / Verdict	강세 3 · 약세 3 · 최종 판단 리포트	P0
기업 딥다이브	5년 재무 차트, 뉴스 요약, 동종업계 비교	P1
Watchlist & 비교 모드	저장·Score 추적·2개 기업 비교	P1
데일리 픽 / 소셜 카드	매일 1개 발굴, 공유 이미지	P2

3. 기술 스택 선택 및 이유

영역	선택	선택 이유
Frontend	Next.js 14 (App Router) + TS	프론트+API Routes 단일 코드베이스로 빠른 MVP, 서버 컴포넌트로 외부 API 키 보호, Vercel 무배포 마찰
UI	Tailwind + shadcn/ui	디자인 시스템 직접 구축 부담 ↓, 카드/차트 중심 UI를 빠르게 조립
차트	Recharts	React 친화적 선언형 API, 재무 시계열 차트에 충분
AI	Claude API (sonnet-4)	긴 컨텍스트 + web_search 도구로 테마 해석·뉴스 요약·정성 평가에 적합
Backend	Next.js API Routes (→ 필요시 FastAPI)	초기 단순성 우선, 트래픽 증가 시 분리
DB	Supabase (PostgreSQL)	무료 티어 + Auth/캐싱/실시간 일체형, MCP 연동으로 Agent가 스키마 직접 관리
Infra	Vercel	Next.js 1급 지원, 프리뷰 배포로 데모 공유 용이

비용 제약: FMP 무료 250 req/day, Claude API 비용 → Supabase 캐싱(재무 24h / 주가 1h / AI 6h / 뉴스 2h)으로 호출 최소화.

4. 데이터 소스

시장	재무 / 공시	주가	뉴스
🇺🇸 미국	FMP · SEC EDGAR (무료)	FMP (무료 250 req/day)	Claude web_search
🇰🇷 한국	DART Open API (무료)	KRX 정보데이터시스템 (무료)	Claude web_search

한·미 응답 구조가 다르므로 Adapter 패턴(공통 StockData 타입)으로 통일해 상위 레이어(AI 분석·UI)는 시장 구분 없이 동일 인터페이스를 사용한다.

5. 개발 로드맵

Phase	목표	기간
1	MVP(미국주) — scaffold, FMP wrapper+캐싱, 테마 탐색 프롬프트 v1, Score v1, Bull/Bear/Verdict UI	2주
2	한국주 추가 — DART/KRX 연동, Adapter 패턴 통일, Watchlist + DB 스키마	+1주
3	고도화 — 재무 차트(Recharts), 뉴스 통합, 비교 모드, UI 디자인	+1주
4	배포 준비 — 소셜 공유 카드, 데일리 픽 피드, 인증(Supabase Auth), 모니터링	필요시

6. 화면 흐름

[랜딩]  ──테마 입력 / 추천 칩──▶  [탐색 결과]  ──카드 클릭──▶  [딥다이브]
                                  기업 카드 5~8개              레이더 차트
                                  한/미 필터                  Bull/Bear/Verdict
                                                              재무 차트 + 뉴스
                                                              Watchlist 저장
                                                                   │
                                                                   ▼
                                                              [Watchlist]
                                                              Score 변화 + 메모

7. 면책 조항

본 서비스는 투자 참고 정보를 제공할 뿐이며, 투자 권유나 금융 조언이 아닙니다. 모든 투자 결정은 사용자 본인의 판단과 책임 하에 이루어져야 합니다.