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

Milestone: Korea Daily Data Foundation

위치

• Roadmap: agent-roadmap/ROADMAP.md
• Phase: agent-roadmap/phase/data-foundation/PHASE.md

목표

한국장 일봉 데이터를 첫 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 없는 검증 경로

필수 기능

Epic: [market-data] Korea daily market data

한국장 일봉 데이터의 provider-neutral 수집, 정규화, 저장, 검증 흐름을 묶는다.

• [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 검증이 통과한다.

완료 리뷰

• 상태: 없음
• 요청일: 없음
• 완료 근거: 아직 필수 기능과 완료 기준이 충족되지 않았다.
• 리뷰 필요:
  • 사용자가 완료 결과를 확인했다
  • archive 이동을 승인했다
• 리뷰 코멘트: 없음

범위 제외

• 미국장 데이터 수집
• 분봉/틱/실시간 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 제공 방식