InsightHub — 설계문서 by ChatGPT

📝 한눈 요약

• 문제: X·즐겨찾는 사이트·YouTube에서 투자 정보를 흩어 소비 → 스크린타임 과다
• 해결: 콘텐츠 수집 → AI 요약/태깅 → 개인화 피드 제공(MVP)
• 백엔드: Python(FastAPI) + Celery + Redis + PostgreSQL
• AI: OpenAI API(요약/태깅) + spaCy/KeyBERT 키워드 추출
• Trader Mode(선택): 백테스트 → 페이퍼 트레이딩 → 실거래
• 안전장치: 리스크 한도·킬스위치·감시·알림·감사로그

---

🎯 1. 목표 & 비즈니스 가치

• 스크린타임 절감
• 개인화 인사이트 제공
• 운영비 최소화
• 확장 용이성 확보

---

📦 2. 기능 범위

2.1 MVP

• [ ] 데이터 수집
  • [ ] X API 연동 or 대체 RSS
  • [ ] RSS 파싱(feedparser)
  • [ ] YouTube API + 자막 수집
• [ ] AI 처리
  • [ ] LLM 요약(핵심 5줄)
  • [ ] 투자 시사점 생성
  • [ ] 자동 태깅(#AI, #EV 등)
• [ ] 피드 & 필터
  • [ ] 태그·키워드·출처 기반 필터
  • [ ] 저장/읽음 처리
• [ ] 설정/동기화
  • [ ] OAuth 로그인
  • [ ] 소스 관리 UI
  • [ ] 알림 빈도 제어

2.2 V2+ (추후)

• [ ] 신뢰도/중복 감지
• [ ] 아침 브리핑·주간 리포트 PDF
• [ ] 음성 리더
• [ ] 포트폴리오 기반 추천

2.3 Trader Mode (옵션)

• [ ] 뉴스/태그 기반 시그널 엔진
• [ ] 백테스트 → 페이퍼 트레이드 → 실거래
• [ ] 리스크 관리(한도, 킬스위치, 승인)

---

🏗 3. 시스템 아키텍처

• Client: React
• API: FastAPI (ASGI, Pydantic)
• 비동기: Celery + Redis
• DB: PostgreSQL(OLTP)
• 스토리지: S3 호환

---

🗄 4. 데이터 모델

• source, content, summary, tags, feedback, user, settings, signal, order, audit_log
• 인덱스: hash, published_at, GIN(tags), symbol+ts

---

🔌 5. API 설계

• GET /feed
• GET /brief/daily
• POST /sources, /orders
• GET /signals

---

🔄 6. 수집 파이프라인(ETL)

• RSS → 본문 정제 → 중복 제거 → 요약/태그 처리
• 스크래핑 시 robots.txt 준수
• LLM 큐잉 처리

---

🤖 7. AI 요약/태그 설계

• Prompt 템플릿(한·영 자동 감지)
• bullets ≤5, insight 2~3문장
• 키워드 추출 보조(spaCy/KeyBERT)
• 토큰 로깅, 실패 재시도

---

📊 8. Trader Mode 아키텍처

• 브로커: Alpaca, IBKR, 국내 OpenAPI, Upbit/Binance
• 리스크: 손실/포지션 제한, 승인, 킬스위치
• 전략 초기 버전: 룰베이스 + 감성 분석

---

💻 9. 프론트엔드

• Stack: React + Vite + Tailwind + TanStack Query
• 화면: 로그인, 피드, 브리핑, 설정, 시그널 보드

---

🚀 10. 배포 & 운영

• Front: Vercel
• API: Fly.io/Render
• DB: Railway
• Redis: Upstash

---

🔐 11. 보안

• OAuth2 + JWT
• API Key 암호화 저장(KMS)
• RBAC, Rate Limit
• XSS/CSRF 방어

---

🗓 12. 개발 계획 (2주 MVP)

Week 1

• [ ] RSS/YouTube 수집기
• [ ] DB 모델 작성
• [ ] LLM 요약 모듈
• [ ] 피드 API

Week 2

• [ ] OAuth 로그인
• [ ] 소스 관리 UI
• [ ] 알림 시스템
• [ ] 캐싱/중복 방지
• [ ] e2e 데모

---

📂 13. 디렉토리 구조

backend/app/
  api/
  core/
  models/
  schemas/
  services/
  workers/
  repo/
  utils/
frontend/src/
  pages/
  components/
  hooks/
infra/
  docker-compose.yml

---

✅ MVP 체크리스트 요약

• [ ] RSS/YouTube 수집 → DB 저장
• [ ] LLM 요약/태그 처리
• [ ] 피드 API + 필터링
• [ ] OAuth 로그인 & 소스 관리
• [ ] 브리핑 API
• [ ] 캐싱/중복 방지
• [ ] 비용 로깅
• [ ] 배포 환경 구성

---