flowchart TB
    %% =========================
    %% Presentation Layer
    %% =========================
    subgraph L1["Presentation Layer"]
        FE["Web / Dashboard<br/>(Ranking · Portfolio)"]
    end

    %% =========================
    %% Application Layer
    %% =========================
    subgraph L2["Application Layer"]
        API["FastAPI Backend<br/>ETF API Service"]
        Cache["Redis<br/>(Read Cache Only)"]
    end

    %% =========================
    %% Data Processing Layer
    %% =========================
    subgraph L3["Data Processing Layer"]
        Scheduler["Batch Scheduler<br/>(Automated Job)"]
        MSFetcher["Morningstar API Fetcher<br/>(Auto Collection)"]
        Processor["ETF Data Processor<br/>(Validate · Extract · Load)"]
        Metric["Metrics Engine<br/>(Return · Risk · Portfolio)"]
    end

    %% =========================
    %% Data Layer
    %% =========================
    subgraph L4["Data Layer"]
        DB[("MySQL / Aurora<br/>ETF Master · Price · Returns · Metrics")]
    end

    %% =========================
    %% External Source
    %% =========================
    subgraph EXT["External Data Source"]
        MS["Morningstar API"]
    end

    %% =========================
    %% Flows
    %% =========================
    FE -->|REST API| API

    API -->|Read Cache| Cache
    API -->|Cache Miss / Read| DB

    Scheduler --> MSFetcher
    MSFetcher -->|Raw ETF Data| Processor
    Processor -->|Validated & Extracted Data| DB

    Metric -->|Calculated Metrics| DB

    MS --> MSFetcher

개요

• Batch 기반 데이터 처리 + REST API 조회 중심 구조로 설계된 정량 ETF 분석 플랫폼.
• 데이터는 사전 계산 후 조회 방식으로 제공.

Layers

(1) Presentation Layer

• 랭킹, 포트폴리오 결과, 누적 수익률 등을 조회하는 UI 계층
• 데이터는 REST API 요청/응답 방식으로 조회
• 사용자 액션에 의해 서버 API 호출 → 결과 렌더링 구조

(2) Application Layer

FastAPI Backend

• ETF 프로젝트의 단일 API 서버
• 제공 기능
  • ETF 기본 정보 조회
  • 가격 / NAV / 수익률 조회
  • 기간별 리스크 지표 조회
  • 배당금 및 세금을 고려한 누적 수익률 계산
  • 포트폴리오 계산 결과 조회 등

Redis (Cache Only)

• API 응답 캐시 용도로만 사용
• Read-heavy API의 응답 결과를 임시 저장
• Cache miss 시 DB 조회 → 결과 반환 → Redis 저장