alt/agent-ops/roadmap/milestones/korea-daily-data-foundation.md

Korea Daily Data Foundation

목표

한국장 일봉 데이터를 첫 MVP market data로 삼아 provider-neutral import, normalization, persistence 파이프라인을 만든다. 한투/KIS는 초기 provider 후보로 보되, domain model은 한국장에만 종속되지 않게 유지한다.

단계

데이터 기반

상태

계획

구현 잠금

• 상태: 잠금
• 결정 필요: 아래 체크리스트
  • MVP에서 우선 수집할 한국장 universe를 watchlist, KOSPI/KOSDAQ 전체, 또는 특정 섹터 중 무엇으로 둘지 결정한다.
  • KIS credential과 계정 환경을 local secret/env 기준으로 어떻게 제공할지 결정한다.

범위

• KRX/Korea daily bar import pipeline
• provider symbol mapping
• normalized instrument/bar storage
• trading calendar/timezone/currency 기본 처리
• KIS adapter boundary
• fixture 또는 mock provider를 통한 credential 없는 검증 경로

필수 기능

• [instrument-map] provider symbol과 ALT instrument identity를 매핑한다.
• [daily-bars] 한국장 일봉 OHLCV를 normalized bar 모델로 저장한다.
• [calendar-rules] Asia/Seoul, KRX, KRW 기준의 최소 calendar/currency 처리를 갖는다.
• [kis-adapter] KIS provider adapter 경계가 worker 내부에 격리된다.
• [mock-provider] KIS credential 없이도 pipeline을 검증할 fixture/mock provider가 있다.
• [data-check] import 결과를 재현 가능하게 검증하는 테스트 또는 CLI/smoke 명령이 있다.

완료 기준

• 선택된 한국장 universe의 일봉 데이터가 저장소에 들어간다.
• 같은 입력을 다시 import해도 중복/갱신 정책이 일관된다.
• normalized data가 backtest milestone에서 소비 가능한 형태로 조회된다.
• bin/test와 관련 worker 검증이 통과한다.

범위 제외

• 미국장 데이터 수집
• 분봉/틱/실시간 streaming
• 실거래 주문 API
• 고급 corporate action adjustment

작업 컨텍스트

• 관련 경로: services/worker/, packages/domain/market/, packages/contracts/proto/alt/v1/market.proto
• 표준선(선택): 첫 데이터 단위는 일봉이고, 구조는 분봉/실시간 확장을 막지 않는다.
• 선행 작업: Persistence and Worker Backbone
• 후속 작업: Backtest Engine Baseline
• 확인 필요: MVP universe와 KIS credential 제공 방식