Solar-FinSight Agent (Upstage Solar 기반 교육형 금융/공시 해석 Agent)

DART 공시(PDF/HTML/첨부) 또는 금융 뉴스 텍스트를 입력하면
근거 기반 해석(Evidence-grounded) + 용어/퀴즈/체크리스트로
“분석하며 배우는” 교육형 리서치 경험을 제공하는 Agent입니다.

---

1) 핵심 가치 (Why)

공시/뉴스를 읽어도 “뭘 봐야 하는지” 막막한 사용자에게 아래를 한 번에 제공합니다.

• (1) 핵심 내용 요약 (3줄 요약)
• (2) 투자자 관점 리스크 (주의점)
• (3) 근거 문장(참조) 기반 설명
• (4) 학습 요소 (용어/퀴즈/체크리스트)

단순 요약이 아닌 근거 기반(참조) UI를 통해 “이 말이 어디서 나왔는지”를 확인 가능한 구조로 설계했습니다.

---

2) 주요 기능 (What)

입력 모드

• 파일 모드: PDF / HTML / TXT / CSV / XML / JSON / XLSX / ZIP
• 뉴스/텍스트 모드: 기사 본문 붙여넣기

출력 섹션

• Key Stats: 주체/사건/숫자/투자자 리스크
• 3줄 요약
• 리스크/주의점 1개
• 핵심 포인트(Insights): 확실성 라벨(fact/interpretation/uncertain)
• 근거 카드(Evidence): 참조 가능한 근거 문장
• 용어(Glossary): 3개
• 퀴즈: 3문항
• 체크리스트: 5개

---

3) 아키텍처 (How)

Backend (FastAPI)

• POST /analyze/news : 텍스트 입력 분석
• POST /analyze/pdf : PDF 분석 (Upstage Document Parse 활용)
• POST /analyze/file : ZIP/XLSX/HTML/TXT 등 파일 처리

Frontend (React + Vite + Tailwind)

• 분석 결과를 카드형 UI로 구성
• “참조: 근거N” 형태로 근거 연결 표시

---

4) 실행 방법

# 4-1) Backend 실행
cd backend
python -m venv .venv
source .venv/bin/activate  # windows: .venv\Scripts\activate
pip install -r requirements.txt

cp .env.example .env
# .env에 UPSTAGE_API_KEY를 설정하세요. (예: UPSTAGE_API_KEY=xxxx)

uvicorn main:app --reload --port 8000

# 4-2) Frontend 실행 (새 터미널 권장)
cd ../frontend
npm install
npm run dev