Files
QuantEngineByItz/spec/37_evaluation_dashboard_contract.yaml
T
kjh2064 ee3e799de1 feat: 리밸런싱 엔진 V1 + GAS 버그 수정 (2026-06-13)
주요 변경:
- tools/build_rebalance_engine_v1.py: REBALANCE_ENGINE_V1 신규
  * account_snapshot 직접 합산(_build_snap_position_map) → 소수주 분리 행 병합
  * 레짐 소스 macro.REGIME_PRELIM 최우선 (GAS 와 동일)
- src/gas_adapter_parts/gdf_06_rebalance.gs: runRebalanceSheet_() 신규
  * Logger.log / getSpreadsheet_() 로 run_all 연동 수정
- src/gas_adapter_parts/gdc_01_fetch_fundamentals.gs
  * _mergePositionRecord_(): 소수주 중복 행 합산 신규
  * parseInt → parseFloat (qty, availQty)
- src/gas_adapter_parts/gdf_01_price_metrics.gs
  * 미보유 종목 SELL_READY → WATCH_EXIT_SIGNAL
- spec/41_release_dag.yaml: build_rebalance_sheet 노드 추가 (step_count 63)
- spec/51_formula_lifecycle_registry.yaml: REBALANCE_ENGINE_V1 등록

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-13 13:20:14 +09:00

59 lines
2.3 KiB
YAML

schema_version: evaluation_dashboard_contract.v2
formula_id: CONTINUOUS_EVALUATION_DASHBOARD_V1
purpose: >
P2-020: 주간 성과 대시보드. LIVE T+20 표본 기반 기대수익/승률/MDD/수익반납 지표 산출.
REPLAY 표본은 informational 섹션에만 집계되며 성과 지표 계산에 혼입 금지.
python_tool: tools/build_continuous_evaluation_dashboard_v1.py
sources:
- Temp/proposal_evaluation_history.json
output: Temp/continuous_evaluation_dashboard_v1.json
# -- 필수 필드 --
required_fields:
- weekly_scorecard_generated # bool: 주간 스코어카드 생성 여부
- expectancy_pct # float: 평균 T+20 기대수익률 (LIVE만)
- win_rate_pct # float: 수익 거래 비율 (T+20 > 0)
- max_drawdown_pct # float: 단일 거래 최대 손실 (T+20 기준)
- profit_giveback_pct # float: 수익의 50% 이상 반납 비율
# -- 지표 정의 --
metric_definitions:
expectancy_pct:
formula: "mean(t20_return_pct) for LIVE EVALUATED_T20 records"
target: "> 0"
note: "T+20 표본이 30건 미만이면 INSUFFICIENT_DATA"
win_rate_pct:
formula: "count(t20_return_pct > 0) / count(EVALUATED_T20) * 100"
target: ">= 50%"
max_drawdown_pct:
formula: "min(t20_return_pct) for EVALUATED_T20 records"
note: "음수가 클수록 나쁨"
profit_giveback_pct:
formula: >
count(proposals where t20_return > 0 AND subsequent outcome showed >50% giveback)
/ count(profitable_t20) * 100
note: "현재 giveback 추적 미구현 → None 반환"
# -- 주간 스코어카드 구조 --
weekly_scorecard:
group_by: ISO_week
min_records_per_week: 3
fields: [win_rate_pct, expectancy_pct, trade_count, avg_t20_days]
# -- gate 판정 --
gate_logic:
INSUFFICIENT_DATA:
condition: "live_t20_count < 30"
effect: "성과 지표를 None으로 표기 (게이트 실패 아님)"
PASS:
condition: "live_t20_count >= 30"
WARNING:
condition: "expectancy_pct < 0 OR win_rate_pct < 40"
# -- 금지 사항 --
prohibitions:
- "REPLAY 표본을 성과 지표(win_rate/expectancy/MDD) 계산에 포함 금지"
- "T+20 미확정 LIVE 거래를 EVALUATED_T20으로 분류 금지"
- "외부 가격 데이터를 직접 조회해 T+20 수익률 계산 금지 (history 기록 기준만 사용)"