# Milestone: US Market Expansion

## 위치

- Roadmap: `agent-roadmap/ROADMAP.md`
- Phase: `agent-roadmap/phase/trading-expansion/PHASE.md`

## 목표

한국장 MVP에서 만든 provider-neutral market data와 backtest 구조 위에 미국장 데이터를 추가한다. KIS가 국내/해외를 모두 지원한다는 전제를 활용하되, 시장별 calendar, currency, venue 차이를 domain과 persistence에서 흡수한다.

## 상태

[계획]

## 구현 잠금

- 상태: 잠금
- 결정 필요: 아래 체크리스트
  - [ ] 미국장 MVP universe를 ETF 중심, 개별주 중심, 또는 watchlist 중심 중 무엇으로 둘지 결정한다.
  - [ ] 미국장 데이터 provider를 KIS 우선으로 고정할지 보조 provider를 함께 고려할지 결정한다.

## 범위

- US market instrument mapping
- USD/NASDAQ/NYSE calendar handling
- daily bar import
- 한국장과 동일한 normalized data/query path
- backtest compatibility

## 필수 기능

### Epic: [us-market] US market expansion

미국장 instrument, calendar, daily data, shared query, backtest compatibility 확장을 묶는다.

- [ ] [us-instruments] 미국장 instrument identity와 provider symbol mapping이 있다.
- [ ] [us-calendar] 미국장 timezone/currency/venue 기준이 있다.
- [ ] [us-daily-bars] 미국장 일봉 데이터를 normalized bar model로 저장한다.
- [ ] [shared-query] 한국장과 미국장이 같은 query/contract pattern을 공유한다.
- [ ] [us-backtest] 미국장 daily data로 backtest fixture 또는 smoke가 동작한다.

## 완료 기준

- [ ] 한국장 pipeline을 깨지 않고 미국장 데이터를 추가한다.
- [ ] market/currency/venue 차이가 domain model과 contracts에 일관되게 반영된다.
- [ ] `bin/test`와 관련 worker 검증이 통과한다.

## 완료 리뷰

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

## 범위 제외

- 미국장 실거래 주문
- 옵션/선물/FX
- 분봉/실시간 미국장 streaming

## 작업 컨텍스트

- 관련 경로: `services/worker/`, `packages/domain/market/`, `packages/contracts/proto/alt/v1/market.proto`
- 표준선(선택): 시장 추가는 provider adapter와 market metadata 확장으로 처리하고 백테스트 코어를 복제하지 않는다.
- 선행 작업: Korea Daily Data Foundation, Backtest Engine Baseline, Command-First Operator Workflow, Paper Trading Command Workflow
- 후속 작업: Live Trading Boundary, Flutter Operator Console MVP
- 확인 필요: 미국장 universe와 provider 우선순위