{
  "version": "1.0.0",
  "entity_types": [
    "projects"
  ],
  "required": [
    "record_id",
    "entity_type",
    "name",
    "record_scope",
    "capacity_scope",
    "created_at",
    "updated_at",
    "last_verified_at",
    "sources",
    "field_sources_json",
    "evidence_json",
    "quality_status"
  ],
  "fields": {
    "record_id": {
      "type": "string",
      "description": "Stable UUID; retain through renames and changes in capacity."
    },
    "name": {
      "type": "string",
      "description": "Identifiable facility, phase or exact equipment name."
    },
    "capacity_scope": {
      "type": "string",
      "description": "Physical boundary and configuration covered by reported ratings."
    },
    "notes": {
      "type": "string",
      "description": "Review notes; no unsupported technical facts."
    },
    "country_code": {
      "type": "string",
      "description": "ISO alpha-3 country code."
    },
    "location_accuracy": {
      "type": "string",
      "description": "Precision and method of public coordinates."
    },
    "parent_record_id": {
      "type": "string",
      "description": "Optional parent project UUID in this catalogue."
    },
    "overlap_group": {
      "type": "string",
      "description": "Stable group for overlapping capacity observations."
    },
    "status_date_basis": {
      "type": "string",
      "description": "Publication date or dated retrieval of undated evidence."
    },
    "entity_type": {
      "type": "string",
      "description": "Connected catalogue table.",
      "enum": [
        "projects"
      ]
    },
    "record_scope": {
      "type": "string",
      "description": "Physical identity granularity.",
      "enum": [
        "plant",
        "phase",
        "complex",
        "unit"
      ]
    },
    "aggregation_role": {
      "type": "string",
      "description": "Only independent or child records can contribute to sums. Aggregate and unresolved scopes are excluded even if filtered children are absent.",
      "enum": [
        "independent",
        "child",
        "aggregate",
        "unresolved"
      ]
    },
    "status": {
      "type": "string",
      "description": "Last evidenced project lifecycle; a portfolio listing alone does not establish operation.",
      "enum": [
        "announced",
        "permitted",
        "under_construction",
        "commissioning",
        "operational",
        "partially_operational",
        "refurbishment",
        "suspended",
        "cancelled",
        "decommissioned",
        "unknown"
      ]
    },
    "quality_status": {
      "type": "string",
      "description": "Evidence qualification; does not certify a facility or product.",
      "enum": [
        "source_backed",
        "needs_review"
      ]
    },
    "created_at": {
      "type": "timestamp",
      "description": "UTC timestamp; updated_at changes only on substantive data/evidence changes."
    },
    "updated_at": {
      "type": "timestamp",
      "description": "UTC timestamp; updated_at changes only on substantive data/evidence changes."
    },
    "last_verified_at": {
      "type": "timestamp",
      "description": "UTC timestamp; updated_at changes only on substantive data/evidence changes."
    },
    "status_as_of": {
      "type": "string",
      "description": "ISO date; only precise reported dates, never a forecast treated as achieved.",
      "format": "date"
    },
    "aliases": {
      "type": "list_string",
      "description": "Explicit evidenced values; linked IDs refer to existing canonical records."
    },
    "sources": {
      "type": "list_string",
      "description": "Explicit evidenced values; linked IDs refer to existing canonical records."
    },
    "source_urls": {
      "type": "list_string",
      "description": "Explicit evidenced values; linked IDs refer to existing canonical records."
    },
    "owner_names": {
      "type": "list_string",
      "description": "Explicit evidenced values; linked IDs refer to existing canonical records."
    },
    "operator_names": {
      "type": "list_string",
      "description": "Explicit evidenced values; linked IDs refer to existing canonical records."
    },
    "developer_names": {
      "type": "list_string",
      "description": "Explicit evidenced values; linked IDs refer to existing canonical records."
    },
    "external_ids_json": {
      "type": "json",
      "description": "Namespace to exact public identifier.",
      "json_container": "object"
    },
    "field_sources_json": {
      "type": "json",
      "description": "Map each populated factual column to registered source IDs. No wildcard evidence.",
      "json_container": "object"
    },
    "evidence_json": {
      "type": "json",
      "description": "Field-level locator, units, publication date/revision and confidence; keys match field_sources_json.",
      "json_container": "object"
    },
    "estimates_json": {
      "type": "json",
      "description": "Derived estimates with method and uncertainty, never substituted into reported columns.",
      "json_container": "object"
    },
    "conflicts_json": {
      "type": "json",
      "description": "Quarantined field observations and source dates/boundaries; unresolved numeric fields must be null.",
      "json_container": "object"
    },
    "extensions_json": {
      "type": "json",
      "description": "Extra documented metadata with units and conditions.",
      "json_container": "object"
    },
    "latitude": {
      "type": "float",
      "description": "Public source coordinate; no inferred centroids.",
      "minimum": -90,
      "maximum": 90,
      "unit": "degrees"
    },
    "longitude": {
      "type": "float",
      "description": "Public source coordinate; no inferred centroids.",
      "minimum": -180,
      "maximum": 180,
      "unit": "degrees"
    },
    "technology": {
      "type": "string",
      "description": "Explicit gas-generation technology; never inferred from plant name or fuel.",
      "enum": [
        "combined_cycle",
        "open_cycle",
        "steam_turbine",
        "reciprocating_engine",
        "unknown"
      ]
    },
    "observations_json": {
      "type": "json",
      "description": "observations json",
      "json_container": "list"
    },
    "installed_capacity_mw": {
      "type": "float",
      "description": "Reported electrical MW at this category and boundary; never thermal power or MVA.",
      "minimum": 0,
      "unit": "MW"
    },
    "planned_capacity_mw": {
      "type": "float",
      "description": "Reported electrical MW at this category and boundary; never thermal power or MVA.",
      "minimum": 0,
      "unit": "MW"
    },
    "historical_capacity_mw": {
      "type": "float",
      "description": "Reported electrical MW at this category and boundary; never thermal power or MVA.",
      "minimum": 0,
      "unit": "MW"
    },
    "capacity_reference_year": {
      "type": "int",
      "description": "Actual reported historical capacity year; null when absent.",
      "minimum": 1900,
      "maximum": 2200
    },
    "turbine_count": {
      "type": "int",
      "description": "turbine count",
      "minimum": 0
    },
    "operational_capacity_mw": {
      "type": "float",
      "description": "Reported electrical MW at this category and boundary; never thermal power or MVA.",
      "unit": "MW",
      "minimum": 0
    },
    "turbine_model": {
      "type": "string",
      "description": "Exact reported turbine model"
    },
    "manufacturer": {
      "type": "string",
      "description": "Reported turbine manufacturer"
    },
    "commissioning_date": {
      "type": "string",
      "description": "Reported commissioning date and precision"
    },
    "grid_connection": {
      "type": "string",
      "description": "Reported grid connection"
    },
    "cost_observations_json": {
      "type": "json",
      "description": "Costs with currency, year and basis"
    },
    "environmental_constraints": {
      "type": "string",
      "description": "Publicly documented constraints"
    },
    "cross_catalogue_links_json": {
      "type": "json",
      "description": "Reviewed links to other catalogue identities"
    },
    "fuel_type": {
      "type": "string",
      "description": "Evidence-backed fuel subtype; Gas in GPPD does not prove natural gas or LNG.",
      "enum": [
        "natural_gas",
        "lng",
        "associated_gas",
        "refinery_gas",
        "blast_furnace_gas",
        "coke_oven_gas",
        "gas_unspecified",
        "mixed_gases"
      ]
    },
    "secondary_fuels": {
      "type": "list_string",
      "description": "Other fuels reported by the source; does not prove current dual-fuel capability."
    },
    "historical_owner_names": {
      "type": "list_string",
      "description": "Owners in the historical source; current ownership is unverified."
    },
    "dataset_vintage_year": {
      "type": "int",
      "minimum": 1900,
      "maximum": 2200,
      "description": "Source dataset vintage; not a capacity measurement year."
    },
    "is_chp": {
      "type": "bool",
      "description": "Explicit combined heat and power configuration; unknown is not false."
    },
    "thermal_capacity_mwth": {
      "type": "float",
      "minimum": 0,
      "unit": "MWth",
      "description": "Useful thermal output; never added to electrical MW."
    },
    "performance_observations_json": {
      "type": "json",
      "json_container": "list",
      "description": "Efficiency, heat rate and emissions with explicit metric, value, unit, fuel_basis (HHV/LHV), electrical_basis (gross/net), conditions, period, boundary, source_id and locator."
    },
    "installed_capacity_basis": {
      "type": "string",
      "enum": [
        "gross",
        "net",
        "unspecified"
      ],
      "description": "Electrical rating basis for installed MW; unspecified is excluded from additive totals."
    },
    "installed_capacity_as_of": {
      "type": "string",
      "format": "date",
      "description": "Date of installed capacity evidence; separate from status date."
    },
    "operational_capacity_basis": {
      "type": "string",
      "enum": [
        "gross",
        "net",
        "unspecified"
      ],
      "description": "Electrical rating basis for operational MW; unspecified is excluded from additive totals."
    },
    "operational_capacity_as_of": {
      "type": "string",
      "format": "date",
      "description": "Date of operational capacity evidence; separate from status date."
    },
    "planned_capacity_basis": {
      "type": "string",
      "enum": [
        "gross",
        "net",
        "unspecified"
      ],
      "description": "Electrical rating basis for planned MW; unspecified is excluded from additive totals."
    },
    "planned_capacity_as_of": {
      "type": "string",
      "format": "date",
      "description": "Date of planned capacity evidence; separate from status date."
    },
    "historical_capacity_basis": {
      "type": "string",
      "enum": [
        "gross",
        "net",
        "unspecified"
      ],
      "description": "Electrical rating basis for historical MW; unspecified is excluded from additive totals."
    }
  }
}
