context-notes.md

# 자재 발주 플래너 — 작업 노트 (결정·근거)

## 목표
완제품 소진예정일 + ML 예측 판매량 + BOM을 연결해, "어떤 BOM 자재를 언제까지 입고하고 얼마나 발주해야 하는지"를 한눈에 보여주는 화면.

## 확정된 결정 (2026-06-12)
1. **소진예정일 = 예측 판매량 누적 기준** (현재재고를 예측 일별 판매로 차감해 0 되는 날).
   - 근거: 계절성 반영 + 자재 수량 계산과 일관성. 저volume은 과거 가중속도 폴백·병기.
2. **부자재 입고 데드라인 = 소진예정일 − 리드타임(45일 기본, 슬라이더 조정)**.
   - "발주일"이 아니라 "자재가 입고돼 있어야 하는 마감일" 개념.
3. **대상 = 전체 BOM 자재** (원자재+부자재 모두).
4. **위치 = 신규 탭으로 먼저 추가(Phase1) → 확인 후 BOM·소진기한과 통합(Phase2)**.
   - 근거: 기존 소진기한 탭(600줄+) 직접 병합은 운영기능 손상 위험. 단계 분리로 위험 0.

## 데이터 소스
- 예측: demand_forecasts (product_name, forecast_date, predicted_qty) — 우리가 적재.
- 현재재고: raw_sojin → load_google_sojin_data_v6 / calculate_sojin_metrics (품명, 현재재고).
- BOM: bom_df (parent_name, child_name, child_code, unit_qty) — get_base_data_cached.
- 매칭: clean_product_name 퍼지조인 (기존 로직 재사용).

## 리스크
- 품명 매칭률(예측↔소진↔BOM)이 낮으면 커버리지 부실 → Phase0에서 먼저 검증.
- 45/90 블록 타이밍 로직은 사용자가 대시보드 보고 최종 확정 예정(확인1).