{
  "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"
    }
  ]
}