diff --git a/docs/ROADMAP_WBS.md b/docs/ROADMAP_WBS.md index af9ec9f..6eea6a3 100644 --- a/docs/ROADMAP_WBS.md +++ b/docs/ROADMAP_WBS.md @@ -1039,6 +1039,135 @@ LLM이 런타임에 이런 stale spec을 사실로 읽으면 할루시네이션 --- +### WBS-8: 실증 전환 & 운영 정규화 (Phase 8, 2026-07~09) + +> WBS-7 구조적 경화 완료 후, 실거래 데이터 누적을 통한 이론적 임계값의 실증적 검증 및 운영 안정화. +> 예상 기간: 2026-07-01 ~ 2026-09-30 | 완성도: 0% (예상) → 목표 100% + +#### WBS-8.1 T+20 레저 30건 달성 & 예측 정확도 활성화 + +| 항목 | 내용 | +|------|------| +| **작업** | WBS-4.1의 T+20 레저 첫 30건 실현 후 예측 정확도 하네스(WBS-4.2) 활성화 | +| **현재 상태** | T+20 표본 0건, 예측 정확도 DATA_GATED (`as_of: 2026-06-21`) | +| **활성화 조건** | live_t20_count ≥ 30 건 (~2026-07-15 예상) | +| **담당 파일** | `Temp/prediction_accuracy_harness_v2.json`, `tools/build_operational_t20_outcome_ledger_v1.py` | +| **성공 하네스** | `prediction_accuracy_harness_v2.json` → `calibration_state: READY` + `sample_count: 30` | +| **상태** | ⏳ 대기 (거래 데이터 누적 필요) | + +--- + +#### WBS-8.2 알파 보정 루프 1차 실행 + +| 항목 | 내용 | +|------|------| +| **작업** | WBS-4.2 활성화 후 30건마다 1회, SS001 가중치(P/V/F) 재보정 자동화 | +| **선행조건** | WBS-8.1 완료 (T+20 30건 누적) | +| **담당 파일** | `tools/build_alpha_calibration_loop_v1.py`, `spec/calibration_registry.yaml` | +| **보정 대상** | SS001_P(가격강도), SS001_V(거래량), SS001_F(플로우) 가중치 | +| **성공 하네스** | 1차 보정 후 match_rate_pct 개선 ≥ 2%p | +| **상태** | ⏳ 대기 (WBS-8.1 완료 후 착수) | + +--- + +#### WBS-8.3 캘리브레이션 실증 전환 1차 (EXPERT_PRIOR/SPEC_DERIVED → CALIBRATED) + +| 항목 | 내용 | +|------|------| +| **작업** | 190개 임계값 중 상위 urgency 10건을 실거래 표본 기반으로 `CALIBRATED` 승격 | +| **현재 상태** | CALIBRATED 0/190 (0%), PROVISIONAL 8/190 (4.2%) | +| **선행조건** | T+20 데이터 누적 및 실제 매매 결과 30건↑ | +| **우선순위** | `Temp/calibration_priority_v1.json`의 urgency score 상위 항목 | +| **담당 파일** | `tools/build_calibration_priority_v1.py`, `spec/calibration_registry.yaml` | +| **성공 하네스** | CALIBRATED ≥ 10건 (1차 목표) | +| **상태** | ⏳ 대기 (WBS-8.1 데이터 필요) | + +--- + +#### WBS-8.4 슬리피지 실측 보정 + +| 항목 | 내용 | +|------|------| +| **작업** | WBS-7.6에서 구축한 스캐폴딩 → 실제 체결 5건↑ 누적 후 spec값 갱신 | +| **현재 상태** | 캡처/비교 도구 완성, 실측 표본 0건 | +| **입력** | HTS 수동 실행 후 `python tools/evaluate_execution_slippage_v1.py record` 1건씩 기록 | +| **담당 파일** | `src/quant_engine/execution_slippage_store_v1.py`, `tools/evaluate_execution_slippage_v1.py` | +| **성공 기준** | actual_mean_slippage_bps vs 5.0bps 비교, gap>3bps면 spec값 갱신 권고 | +| **상태** | ⏳ 대기 (실거래 체결 5건 누적) | + +--- + +#### WBS-8.5 섹터 플로우 30일 누적 검증 (WBS-2.5 DATA_GATED 해소) + +| 항목 | 내용 | +|------|------| +| **작업** | `sector_flow_history` 탭 30일↑ 누적 후 `FLOW_CREDIT_V1` 활성화 | +| **현재 상태** | 데이터 3일 / 목표 30일 (DATA_GATED) | +| **담당 파일** | `spec/13_formula_registry.yaml:FLOW_CREDIT_V1`, `tools/build_sector_flow_confidence_v1.py` | +| **활성화 조건** | `Temp/sector_flow_history_progress_v1.json` → `days_accumulated: ≥30` | +| **성공 하네스** | SECTOR_ROTATION_MOMENTUM_V1 신호 `lifecycle: DATA_GATED` → `ACTIVE` 전환 | +| **상태** | ⏳ 대기 (일일 자동 누적 중, ~2026-07-21 예상) | + +--- + +#### WBS-8.6 Synology snapshot_admin 라이브 배포 검증 (WBS-7.9 잔여) + +| 항목 | 내용 | +|------|------| +| **작업** | Synology 실제 하드웨어에서 인증/지속성/외부 접근 POC 검증 (WBS-7.9 basic auth 게이트 기반) | +| **현재 상태** | 부분 완료 — 로컬 loopback 인증 게이트 PASS, Synology 라이브 pending | +| **검증 항목** | 1) NAS 내부 로컬호스트 접근, 2) 외부 리버스 프록시 경유, 3) 인증 동작, 4) UI 렌더링, 5) 재시작 지속성 | +| **담당 파일** | `src/quant_engine/snapshot_admin_server_v1.py`, `docs/SYNOLOGY_SNAPSHOT_ADMIN_*_CHECKLIST.md` | +| **성공 기준** | `docs/SYNOLOGY_SNAPSHOT_ADMIN_DEPLOYMENT_CHECKLIST_FILLED.md` 6개 항목 모두 완료 + 증빙 보관 | +| **상태** | 부분 완료 (사용자 실행 대기) | + +--- + +#### WBS-8.7 spec-코드 동기화 게이트 커버리지 확장 (12.5% → ≥50%) + +| 항목 | 내용 | +|------|------| +| **작업** | WBS-7.11에서 구축한 동기화 게이트의 태깅 범위 확대 (현재 20/160 YAML) | +| **현재 상태** | 12.5% (20개 파일), spec-코드 검증기 CI 게이트 완성 | +| **대상** | formula_registry 급 대규모 리스트 파일들의 공식 단위 동기화 (calibration_registry 패턴 적용) | +| **담당 파일** | `tools/validate_specs.py:validate_spec_code_sync`, `Temp/spec_code_sync_v1.json` | +| **성공 기준** | `spec_code_sync_v1.json` → `sync_field_coverage_pct: ≥50%` | +| **상태** | ⏳ 진행 중 (점진적 롤아웃) | + +--- + +#### WBS-8.8 KIS 수집기 리팩터 (원격 이미 진행 중) + +| 항목 | 내용 | +|------|------| +| **작업** | `src/quant_engine/kis_data_collection_v1.py` 개선: Naver 원자료 확장 → SQLite 자동 조회 경로 | +| **현재 상태** | 원격에서 이미 진행 중 (`data_collection_store_v1.py` 확장 커밋 확인) | +| **목표** | GAS 대신 Python/SQLite가 원자료(Close/MA20/ATR20/수급) 조회 → 타 도구들이 GAS 보조 참조 제거 | +| **담당 파일** | `src/quant_engine/kis_data_collection_v1.py`, `src/quant_engine/macro_index_collection_v1.py` | +| **성공 기준** | snapshot_admin 테이블 로드 시간 ≤2초 (현재 GAS 수집 병목 제거) | +| **상태** | 원격 진행 중 (로컬 머지 후 재검토) | + +--- + +### WBS-8 의존성 차트 + +``` +WBS-8.1 (T+20 30건) + ├─→ WBS-8.2 (알파 보정) + ├─→ WBS-8.3 (캘리브레이션 승격) + └─→ WBS-8.4 (슬리피지 보정) + +WBS-8.5 (섹터 플로우 30일) — 독립적 (매일 자동 누적) + +WBS-8.6 (Synology 배포) — 독립적 (사용자 실행) + +WBS-8.7 (spec 동기화) — 독립적 (점진적 확장) + +WBS-8.8 (KIS 리팩터) — 독립적 (원격 병행) +``` + +--- + ## 3. 완성도 로드맵 매트릭스 | WBS | 우선순위 | 난이도 | 선행조건 | 예상 기간 | 현재 완성도 |