Project

General

Profile

Feature #1123 » data_contract_v3.json

수아 황, 10/27/2026 07:20 AM

 
{
"version": "handoff_data_basis_v3",
"issue": "https://sulfite-footbath-next.ngrok-free.dev/issues/1123",
"prepared_by_role": "Data & Validation / 수아",
"intended_recipient_role": "Forecasting / 이상재",
"accepted_by_recipient": false,
"source_sha256": "f8b8914d1e45c7a7e8108fc2bfb2c1287373a07e2621cfe653bb3a12a438834e",
"raw_dataset_included": false,
"cleaned_training_dataset": null,
"preprocessing_applied": false,
"model_trained": false,
"data_keys": {
"plant": "site_id",
"generation": [
"site_id",
"ts"
],
"wa_forecast": [
"wa_station",
"round",
"ts"
],
"wb_forecast": [
"wb_station",
"round",
"ts"
]
},
"units": {
"capacity_kw": "kW",
"energy": "kWh per right-closed 1-hour interval",
"smp": "KRW/kWh",
"wa_wind_speed": "m/s",
"wb_wind_speed": "km/h"
},
"timezone": "Asia/Seoul",
"label_contract": "energy is a target, never a future predictor; respect fit cutoff and arrival conditions",
"split_config": "outputs/oibc_1121/split_config.json",
"feature_policy": "outputs/oibc_1122/feature_policy.json",
"quality_results": "outputs/oibc_1120/audit_results.json",
"forecast_output_proposal": {
"required_columns": [
"site_id",
"ts",
"actual_kwh",
"prediction_kwh",
"residual_kwh",
"fold",
"model_version",
"data_version",
"split_version",
"feature_version"
],
"residual_formula": "actual_kwh - prediction_kwh",
"artifact_metadata": [
"run_id",
"code_version",
"fit_cutoff",
"issue_rule",
"quality_policy_version",
"forecast_round_policy",
"data_hash",
"scoring_status"
],
"official_test_actual_policy": "No actual test labels provided; never fabricate actual/residual. Separate prediction-only artifact.",
"oof_policy": "Prediction must come from a model that did not fit the same target; use only prior residuals for VPP selection."
},
"settlement_contract_proposal": {
"aggregation_order": "sum plant actual/prediction inside each VPP/time, then abs error",
"k_rule": "3 when KST ts.hour is 11..15 inclusive; otherwise 1",
"current_rule_basis": "README only; official approval not confirmed",
"source": "Redmine #991 latest implementation report, not rerun here",
"official_score": null
},
"data_criteria_agreed_with_recipient": true,
"recipient_v2_execution_verified": false,
"agreement_evidence": "AGREEMENT_D01_D03.md; recipient reply relayed by human user on 2026-10-27",
"forecast_round_policy": "forecast_round_policy.json",
"intended_recipient_roles": [
"Forecasting / 이상재",
"VPP / Settlement / 조영우"
],
"integration_contract": "vpp_handoff/integration_contract.json",
"plant_master": "vpp_handoff/plant_master.csv",
"data_basis_frozen_by_data_owner": true,
"recipient_vpp_acceptance_verified": false,
"official_rules_approved": false,
"official_submission_ready": false
}
(8-8/12)