kjh2064
4b1a33ba48
이미 harness_file:/python_tool:/validator: 필드로 1:1 코드 매핑을 스스로 명시하고 있던 H001~H008 결정론적 하네스 계약 7개(spec/52~58)와 spec/32(canonical_artifact_resolver), spec/37(evaluation_dashboard_contract)에 has_code_implementation/code_path를 추가했다. 모든 대상 파일의 code_path 실존을 사전 확인했다. governance/rules/00~05, spec/40·45·46·gas_adapter_contract 등 다중 구현체에 걸친 계약은 단일 code_path로 환원하면 거짓 1:1 매핑이 되므로 의도적으로 제외했다(WBS-7.11 핵심 원칙 유지).
61 lines
2.4 KiB
YAML
61 lines
2.4 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
|
|
has_code_implementation: true
|
|
code_path: "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 기록 기준만 사용)"
|