Skip to content

About

다양한 재무 지표와 복합적인 조건을 기준으로 주식 종목을 정밀하게 필터링할 수 있는 주식 스크리너

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

📈 주식필터

재무 지표 기반 주식 스크리너

주식필터는 다양한 재무 지표와 복합적인 조건을 기준으로 주식 종목을 정밀하게 필터링할 수 있는 주식 스크리너 서비스입니다. 흩어져 있는 공시·시세 데이터를 한곳에 모아, 나만의 투자 전략에 맞는 종목을 효율적으로 탐색해 보세요.


📱 주요 기능 미리보기

🏠 홈 / 초보자 필터 / 테마
Image
🔎 스크리너 조건 설정
Image
📊 주식 종목 상세 조회
Image
💾 전략(저장된 필터) 조회
Image

🛠️ 기술 스택

Backend

Spring Boot Spring Data JPA QueryDSL

Database

MySQL

Cache

Redis Caffeine

Resilience / Scheduling

Resilience4j Spring Scheduler ShedLock


🏗️ 아키텍처

헥사고날(포트/어댑터) 아키텍처와 DDD 전술 패턴을 기반으로 설계되었습니다.

src/main/java/org/project/ssogssog/
├── presentation/          # REST Controller
├── application/           # Application Layer
├── domain/                # Domain Layer (도메인별 DDD 전술 패턴 적용)
├── infrastructure/        # Infrastructure Layer
└── global/                # 공통 모듈

Application Layer

CQRS 패턴을 적용하여 Reader/Writer로 책임을 분리하고, Shared Kernel로 도메인 간 공유 객체를 관리합니다.

application/
├── common/                      # Shared Kernel (전략적 설계)
│   └── dto/condition/           # 도메인 간 공유되는 검색 조건 DTO
├── service/
│   ├── stock/
│   │   ├── port/                # 외부 시스템 인터페이스 (Port)
│   │   ├── collect/             # 데이터 수집 UseCase
│   │   ├── reader/              # 캐시 기반 조회 
│   │   ├── writer/              # 저장 전용 서비스 (self-injection 문제 해결)
│   │   └── api/                 # API 서비스
│   ├── stockmetric/
│   │   ├── collect/             # 메트릭 수집 UseCase
│   │   ├── reader/              # Bulk 데이터 조회
│   │   ├── writer/              # Bulk 데이터 저장
│   │   └── api/                 # API 서비스
│   └── member/
│       ├── reader/              # 캐시 기반 조회
│       └── api/                 # API 서비스
└── utils/                       # 공통 유틸리티

Domain Layer

서브 도메인별로 분리하고, DDD 전술 패턴(Entity, VO, Factory, Repository 등)을 적용했습니다.

domain/
├── stock/                       # 주식 도메인
│   ├── entity/                  # Stock, DailyPrice, StockFinancial
│   ├── enums/                   # MarketType 등
│   ├── policy/                  # 도메인 정책 (ThemeEmojiRegistry)
│   ├── projection/              # 쿼리 전용 DTO
│   └── repository/              # Repository 인터페이스
│
├── stockmetric/                 # 투자 지표 도메인
│   ├── entity/                  # StockMetric (Aggregate Root)
│   ├── vo/                      # MetricValues (Value Object)
│   ├── factory/                 # StockMetricCalculator (Factory)
│   ├── enums/                   # 지표 관련 열거형
│   └── repository/              # Repository 인터페이스
│
└── member/                      # 회원 도메인
    ├── entity/                  # Member, Strategy, StockLike
    │   └── range/               # 필터 범위 (Embedded)
    ├── factory/                 # StrategyFactory
    └── repository/              # Repository 인터페이스

Infrastructure Layer

infrastructure/
├── adapter/stock/               # Port 구현체 (Adapter)
├── client/feign/                # Feign Client (KIS, OpenDART, Naver)
├── scheduler/                   # 스케줄러
└── config/                      # 설정 (Cache, Async, Resilience4j)

외부 API 연동

에러 유형 KIS API OpenDART API Naver API
403 (토큰) 1분 대기 → 2회 재시도 → Circuit Breaker - -
429 (Rate Limit) 1초 20회 제한
→ 1초 대기 후 재시도
1초 10회 제한
→ 1초 대기 후 재시도
1초 10회 제한
→ 1초 대기 후 재시도
5xx (서버 오류) 지수 백오프 2~3회 지수 백오프 2~3회 지수 백오프 2~3회
Timeout - 응답 지연 시 Timeout 처리 및 Skip -
Circuit Breaker 연속 실패 시 호출 차단 연속 실패 시 호출 차단 API 사용량 보호 목적

🚀 주요 기술적 도전 (Challenges)

1. 배치 처리 최적화 (960% 성능 개선)

  • 문제: 3,000개 종목의 지표 계산 시 반복된 네트워크 I/O로 인한 심각한 성능 저하 (15초 소요)
  • 해결: Bulk Query로 데이터 조회 후 메모리 상에서 Map 구조로 매핑하여 DB 접근 최소화, 비상관 서브 쿼리 및 인덱스 튜닝
  • 성과: 메트릭 계산 시간 **15초 → 1.5초 **
  • 👉 📄 기술 블로그 포스팅 보러가기

2. 외부 API 회복탄력성 (Resilience4j)

  • 문제: 외부 API의 간헐적 장애가 전체 서비스의 데이터 정합성을 위협
  • 해결: Resilience4j의 4중 방어 패턴 적용 (CircuitBreaker, Retry, RateLimiter, TimeLimiter)
  • 성과: 부분 장애 발생 시에도 전체 시스템 셧다운 없이 서비스 가용성 확보
  • 👉 📄 기술 블로그 포스팅 보러가기

3. 헥사고날 아키텍처 도입

  • 목표: 외부 인프라(API, DB) 변경이 핵심 비즈니스 로직(도메인)에 영향을 주지 않는 구조 설계
  • 해결: DIP(의존성 역전 원칙)를 적용하여 도메인은 오직 내부 인터페이스(Port)에만 의존하고, 구현체(Adapter)가 이를 의존하도록 설계
  • 👉 📄 기술 블로그 포스팅 보러가기

About

다양한 재무 지표와 복합적인 조건을 기준으로 주식 종목을 정밀하게 필터링할 수 있는 주식 스크리너

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages