Project

General

Profile

Feature #1123 » vpp_integration_contract_v1.json

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

 
{
"version": "vpp_data_basis_v1",
"data_contract_version": "handoff_data_basis_v3",
"status": "FROZEN_DATA_BASIS_FOR_INTEGRATION_REVIEW",
"source_sha256": "f8b8914d1e45c7a7e8108fc2bfb2c1287373a07e2621cfe653bb3a12a438834e",
"approval_scope": "data-owner delivery basis; D01-D03 recipient agreement relayed by human user",
"official_rules_approved": false,
"recipient_vpp_acceptance_verified": false,
"plant_master": {
"path": "vpp_handoff/plant_master.csv",
"sha256": "2133cd2e19bac33972d5dd30ad81b88bcecb6f38fc4209c0b2db21492c00f07d",
"key": "site_id",
"count": 253,
"total_capacity_w": 42655370,
"total_capacity_kw": "42655.370",
"capacity_kw_unit": "kW",
"canonical_decimal_places": 3,
"capacity_w_unit": "W",
"comparison": "exact integer W, tolerance 0 W",
"rounding": "none; reject a capacity that is not exactly representable at 1 W precision",
"input_transport": "decimal strings or exact decimal parsing; avoid binary-float aggregation",
"mapping": "site_id exact join; never positional join or strip leading zeros",
"current_group_reference": "reference only; not a final optimized assignment"
},
"capacity_rule_reference": {
"groups": 2,
"min_capacity_w_each": 20000000,
"basis": "existing README/team basis; official rule approval pending",
"boundary_rule": "greater than or equal using exact integer W"
},
"time": {
"timezone": "Asia/Seoul",
"transport": "ISO8601 with explicit offset; canonical +09:00",
"naive_timestamp": "reject",
"alignment": "exact hour",
"interval": "(ts-1 hour, ts]",
"target_day": "date(ts - 1 microsecond) in KST",
"issue_rule": "target day minus 1 day at 17:00 KST",
"target_day_hours": "D 01:00 through D+1 00:00 inclusive",
"official_first_ts": "2025-06-01T01:00:00+09:00",
"official_last_ts": "2026-06-01T00:00:00+09:00",
"official_hours": 8760,
"official_plant_time_pairs": 2216280,
"actual_receipt_latency_verified": false
},
"units": {
"capacity": "kW (exact W for comparison)",
"energy_actual_prediction_residual": "kWh per 1-hour interval",
"smp": "KRW/kWh",
"gross_penalty_net": "KRW"
},
"versions": {
"data_version": "sha256:f8b8914d1e45c7a7e8108fc2bfb2c1287373a07e2621cfe653bb3a12a438834e",
"split_version": "data_criteria_agreed_v2",
"feature_version": "data_criteria_agreed_v2",
"round_policy_version": "agreed_v2"
},
"linked_files": {
"split": {
"path": "outputs/oibc_1121/split_config.json",
"sha256": "b1587193610b2f75ca4a4e88ad4431f351b132417a0939affbc333e8588e06fb"
},
"features": {
"path": "outputs/oibc_1122/feature_policy.json",
"sha256": "5c53f999105939111f0fe0f3acf5b58000c16ba6add8813f8c2f117605a8c7b0"
},
"round_policy": {
"path": "forecast_round_policy.json",
"sha256": "ca0d5de7ad4cc86884f01028a14149958b45f31611a1839136f217fef0a5b275"
},
"agreement": {
"path": "AGREEMENT_D01_D03.md",
"sha256": "d30dad7f76737105d58889b89aaa28ec6dbe96f343ba1702d84dad03c68fb309"
},
"availability_matrix": {
"path": "outputs/oibc_1122/feature_availability_matrix.csv",
"sha256": "4e3f12d8f292dce9e047c578a9c1efeeb401ae730cea38f65e65b7ae9a8f933b"
},
"leakage_checklist_v1": {
"path": "outputs/oibc_1122/leakage_checklist.csv",
"sha256": "2cbbdeec09c3f664f6cc0cff2dd8228bbf4b5bc27a27d1c8ffe9d01eb6d708db"
}
},
"market": {
"train": "train/smp.csv: ts,smp; no k column",
"evaluation": "smp.csv: ts,smp,k",
"provided_k": "preserve supplied k and compare to interval-end KST ts.hour",
"train_k": "explicit derive_from_hour: 3 for KST hour 11..15 inclusive, otherwise 1; README_RULE_ONLY",
"zero_smp": "valid; do not drop",
"negative_or_nonfinite_inputs": "flag/reject until policy approved; never clamp or silently fill",
"smp_as_model_predictor": "excluded"
},
"oof": {
"source": "real model output from Sangjae; not included in this delivery",
"keys": [
"model_version",
"fold",
"site_id",
"ts"
],
"residual_formula": "actual_kwh - prediction_kwh",
"split_cohort": "exact validation_site_ids for seasonal folds; all 253 sites for DEV_JAN/DEV_FEB/HOLDOUT",
"portfolio_selection": "only prior out-of-time residuals available before selection cutoff; never tune using final holdout",
"summer": "plant metrics only; not a full 253-site residual portfolio",
"holdout": "final evaluation only; do not use its labels/residuals to choose grouping",
"official_test": "prediction only; no actual or residual fabrication",
"negative_values": "do not clamp silently; report for quality/model policy review",
"required_metadata": [
"run_id",
"artifact_path",
"artifact_sha256",
"model_version",
"code_commit",
"data_contract_version",
"data_version",
"split_version",
"feature_version",
"plant_master_sha256",
"split_config_sha256",
"feature_policy_sha256",
"forecast_round_policy_sha256",
"fold",
"fit_start",
"fit_cutoff",
"cutoff_basis"
],
"column_mapping_status": "existing forecast_output_proposal in data_contract.json; confirm with both consumers before real integration"
},
"delivery": {
"data_basis_files_ready": true,
"real_forecast_oof_received": false,
"real_oof_validation_status": "WAITING_FOR_FORECAST_OOF",
"recipient_acknowledged": false,
"recipient_pipeline_pass": false,
"official_submission_ready": false
},
"pending": [
{
"id": "D04",
"item": "actual receipt latency and official fit cutoff interpretation",
"owner": "PM/Data/Forecast",
"eta": "not committed; verify before official compliance claim"
},
{
"id": "D05",
"item": "official settlement/scoring/rounding/negative policy",
"owner": "PM/VPP",
"eta": "not committed; required before official score or submission approval"
},
{
"id": "D06",
"item": "recipient v3 acknowledgement and actual Forecast/OOF column mapping/run",
"owner": "Forecast/VPP/Data",
"eta": "after real artifacts are supplied; delivery time not yet committed"
}
]
}
(9-9/12)