MVP 프로젝트 구축

[ehrud25]

What

• MVP 프로젝트 프론트엔드 구현
• MVP 프로젝트 백엔드 구현

Why

• 핵심 가치 검증: 매수/매도 지시가 아닌 '상황 가이드'라는 차별화된 시스템이 사용자에게 실질적인 도움을 주는지 빠르게 확인해야 합니다.
• 시장 반응 확인: 4월 10일 배포 및 고도화 일정을 맞추기 위해, 가장 먼저 한국투자증권 API 안정성을 테스트하고 초기 데이터를 확보해야 합니다.

Done Criteria

• 기능 동작 확인
• 테스트 통과
• 리뷰 반영

[ehrud25]

실시간 주식 상황 가이드 서비스

1. 개요

항목	내용
프로젝트명	실시간 주식 상황 가이드 서비스 (지수추종 / Finsight)
성격	MVP — "매수/매도 지시"가 아닌 상황 가이드 차별화 검증
목표	핵심 가치 검증, 한국투자증권 API 안정성 검증, 4월 10일 배포·고도화 일정 준수
범위	프론트엔드(MVP) + 백엔드(MVP) + 카카오 오픈채팅 연동, Stock 서비스 도입

---

2. 핵심 가치와 차별점

• 상황 가이드: "이 종목 사라/팔라"가 아니라, **현재 국면(상방/하방 압력, 지지·저항, RSI 등)**을 설명해 사용자가 스스로 판단할 수 있게 함.
• 검증 포인트: 이 방식이 사용자에게 실질적 도움을 주는지 빠르게 확인.
• 시장·일정: 4월 10일 배포를 위해 한국투자증권(KIS) API 안정성 테스트 및 초기 데이터 확보를 우선 수행.

---

3. 시스템 설계 개요

• 프론트: 사용자에게 종목 검색, 시세·차트, 기술적 지표 요약, AI 결론(상황 가이드 문장) 제공.
• 백엔드: 크론으로 탑500 종목 KIS 시세·일봉 수집 → Gemini 분석 → JSON 저장. 사용자에게는 이 저장된 탑500 분석 결과를 기반으로 상황 가이드 제공. 카카오 스킬·규칙 기반 분석 포함.
• 카카오: 오픈채팅/스킬에서 종목명·발화로 검색 후 동일한 "상황 가이드" 문장 제공.

---

4. 아키텍처

4.1 전체 구성

• 프론트엔드: Next.js(App Router) 단일 앱 — 대시보드, 종목 분석, 차트, 설정(API 키), 결제(토스) 등.
• 백엔드: 마이크로서비스 형태.
  • Discovery (Eureka): 서비스 등록·조회.
  • Gateway: 단일 진입점, 라우팅·인증·로깅.
  • Auth: 로그인, JWT 발급, Caffeine 캐시로 인증 부하 완화.
  • Stock: KIS/Gemini 연동, 기술지표 계산, 규칙/Gemini 분석, 카카오 스킬, 탑500 크론 배치 및 저장된 분석 제공.
• 인프라: Jenkins → Gradle 빌드 → Docker 이미지(Discovery, Auth, Stock, Gateway) → docker-compose 배포, MariaDB 사용.

4.2 데이터 흐름 (요약)

1. 배치(크론): 매일(또는 설정된 주기) 탑500 국내/해외 종목에 대해 KIS 시세·일봉 수집 → Gemini로 종목별 상황 가이드 문장 생성 → top500-domestic-analysis.json / top500-overseas-analysis.json 등으로 저장.
2. 웹 분석: 사용자 → 프론트 → Gateway → Stock API → 저장된 탑500(탑100) 분석 파일에서 해당 종목 조회 후 상황 가이드 문장 반환 (필요 시 실시간 KIS·규칙 기반 분석 보조).
3. 카카오 스킬: 사용자 발화 → 카카오 → Stock API /kakao/skill → 탑100 분석 파일에서 종목 검색 → 분석 문장 반환.
4. 정리: 사용자에게 제공하는 분석은 크론으로 미리 돌려 둔 탑500 분석 결과를 기반으로 함.

4.3 주요 설계 결정

• 탑500 크론: 사용자 요청 시마다 실시간 KIS 호출에 의존하지 않고, 주기적으로 탑500을 배치로 돌려 분석 결과를 JSON으로 저장하고, 이 데이터를 사용자/스킬에 제공.
• KIS API: 탑500 배치 및 (필요 시) 실시간 조회에 사용. 국내/해외 시세·일봉 단일 소스.
• 상황 문장 생성: 규칙 기반(MA, RSI, MACD, 지지·저항 등) + Gemini(탑100/탑500 저장 파일 맥락 결합) 혼합.
• 인증: JWT + RSA 키(public/private), 인증/검증 코드는 Caffeine 캐시로 DB 부하 감소.
• 시크릿: key.env, *-secret.yml 등은 Git 제외, 값만 보안 채널로 공유.

---

5. 기술 스택 요약

구분	기술
프론트	Next.js 16, React 19, TypeScript, TanStack Query, lightweight-charts, TossPayments, Tailwind, shadcn/ui
백엔드	Java 17+, Spring Boot 4, Spring Cloud, Eureka, Caffeine Cache
외부	한국투자증권 Open API, Google Gemini API
인프라	Jenkins, Docker, docker-compose, MariaDB

---

6. 주요 기능(설계 관점)

• 탑500 배치 분석: 크론으로 국내/해외 탑500 종목의 KIS 시세·일봉을 수집하고, Gemini로 종목별 상황 분석 문장을 생성해 JSON 파일로 저장. 사용자에게는 이 저장된 탑500 분석 결과를 기반으로 분석 제공 (요청 시마다 전 종목 실시간 KIS 호출이 아님).
• 기술적 분석: MA(5/20/60), RSI(14), MACD, 변동성, 볼린저, 지지·저항 — 백엔드 계산 후 요약·상세 문장.
• 상황 가이드 문장: "지금 OO은 상방/하방 압력, … 매도 시 손실 구간, 매수 시 반등 구간" 형식의 3문장 결론.
• 카카오 스킬: 발화 → 탑100 분석 파일에서 종목 검색 → 동일 상황 가이드 문장 반환.
• 저장 데이터 활용: 탑500(탑100) 분석 JSON을 스킬·웹에서 공통으로 사용.

---

7. 배포·운영

• CI/CD: Jenkins 파이프라인 — Checkout → Gradle 빌드 → Docker 이미지 빌드(병렬) → docker-compose로 Discovery → Auth/Stock/Gateway 순서 배포 → Health Check.
• 환경: docker-compose 기준으로 MariaDB, Discovery, Auth, Stock, Gateway 컨테이너 구성.

---

8. 실제 동작

cron으로 분석한 데이터를 기반으로 사용자에게 분석을 제공해주는것을 확인 완료.