3.1 KiB
3.1 KiB
data - 데이터 관리
개요
data 컴포넌트는 시계열 데이터 수집, 정제, 저장, 제공을 담당합니다.
책임
- 외부 데이터 소스 연동 및 수집 스케줄링
- 실시간 시세 스트리밍 및 캐시 업데이트
- 데이터 품질 검증/보정
- 백테스트 및 전략 실행을 위한 데이터 제공
의존성
graph LR
Data[data] --> Providers[Data Providers]
Data --> DB[(Time-series DB)]
Data --> Cache[(Redis Cache)]
Strategy[strategy] --> Data
Analytics[analytics] --> Data
Monitor[monitor] --> Data
style Data fill:#9C27B0,color:#fff
주요 기능
1. 데이터 수집
collectMarketData(symbols: string[], from: Date, to: Date): void
updateRealTimeData(symbols: string[]): void
- 외부 제공자(Yahoo Finance, Alpha Vantage 등)에서 시세를 수집합니다.
- 증분 업데이트로 중복 수집을 방지합니다.
2. 데이터 제공
getPriceHistory(symbol: string, from: Date, to: Date, interval: Interval): PriceBar[]
getLatestPrice(symbol: string): Price
getMultipleSymbols(symbols: string[], date: Date): Record<string, Price>
- 실시간 데이터는 캐시 우선으로 제공합니다.
3. 데이터 품질 관리
validateData(symbol: string, from: Date, to: Date): ValidationReport
adjustForCorporateActions(symbol: string): void
fillMissingData(symbol: string, method: 'FORWARD_FILL' | 'INTERPOLATE'): void
- 결측치/이상치 탐지 및 보정 정책을 적용합니다.
4. 데이터 소스 관리
addDataSource(source: DataSourceConfig): DataSource
syncDataSource(sourceId: string): SyncResult
데이터 모델
interface PriceBar {
symbol: string
timestamp: Date
open: number
high: number
low: number
close: number
volume: number
adjustedClose?: number
}
interface DataSource {
id: string
name: string
provider: 'BROKER' | 'YAHOO' | 'ALPHA_VANTAGE' | 'CUSTOM'
config: {
apiKey?: string
endpoint?: string
rateLimit?: number
}
coverage: {
symbols: string[]
intervals: string[]
delay: number
}
priority: number
isActive: boolean
}
interface ValidationReport {
symbol: string
period: { from: Date, to: Date }
issues: {
type: 'MISSING_DATA' | 'OUTLIER' | 'ZERO_VOLUME' | 'PRICE_GAP'
date: Date
description: string
severity: 'LOW' | 'MEDIUM' | 'HIGH'
}[]
completeness: number
quality: 'EXCELLENT' | 'GOOD' | 'FAIR' | 'POOR'
}
API 명세
GET /api/data/prices
가격 데이터 조회
POST /api/data/sources
데이터 소스 추가
구현 고려사항
- 데이터 소스별 레이트 리밋을 준수합니다.
- 기업 이벤트(배당, 액면분할) 반영 규칙을 문서화합니다.