콘텐츠로 이동

ADR-0024: MVP 상품 범위 — 국내 ETF, 스키마는 미국 확장성 선반영

  • 상태: 승인됨
  • 날짜: 2026-07-15

맥락

기존 문서(context.md·scope.md)는 MVP를 "종목 단위 가격 변동 설명, 한국주식 한정"으로 서술했으나, 실제 데이터 파이프라인(ETF 구성종목·NAV 수집)과 Cloud Event Store 물리 스키마(V202607150001 — etf_instrument_id grain, ETF 보유·기여도 분해 테이블군)는 ETF 를 설명 단위로 설계됐다. 문서와 실물의 드리프트를 PM 확정으로 해소한다.

결정

  • MVP 상품 범위 = 국내 상장 ETF 의 가격 변동 이유 설명. 개별 종목(주식) 단위 설명은 MVP 밖(로드맵).
  • 물리 스키마는 미국 ETF 까지 확장 가능하게 선반영한다 — instrument 모델이 시장에 중립적이므로 스키마 변경 없이 수집원(SEC 공시·해외 뉴스·미국 시세)만 추가하면 확장된다. 미국 ETF 데이터 수집(파이프라인)은 스키마 검증·개발 편의 목적이며 MVP 제공 범위가 아니다.

대안

  • 한국주식 개별 종목 유지 — 종목 수(2,700+)·뉴스 노이즈 대비 설명 품질 확보가 어렵고, ETF 는 구성종목·NAV 분해로 "왜 움직였나"를 구조적으로 귀속시킬 수 있어 설명 가능성이 높다. 파이프라인·스키마 실물도 이미 ETF 방향.
  • 스키마를 국내 전용으로 축소 — 확장 시 스키마 재작업 비용 대비 선반영 비용이 낮아 배제.

결과

  • context.md(한 줄 정의·MVP 집중·제공 기능)·scope.md(개별 종목 명시적 아웃)·roadmap.md(미국 ETF·개별 종목 확장)·sync-protocol.md(규모 가정 기준) 갱신.
  • 구 서술(종목 단위·한국주식)을 담은 ADR-0010 등 기존 ADR 은 수정하지 않는다 — 이 ADR 이 범위를 갱신한다.
  • 대외 산출물(기획서·발표)의 상품 정의도 "국내 ETF 가격 변동 설명"으로 정렬해야 한다 (writing-rules 톤 규칙과 함께 적용).