{
  "_readme": [
    "⚠️  THIS IS A STARTER FILE, NOT THE WORKBOOK CATALOGUE.",
    "",
    "The ESG_Nexus workbook defines 50 master metrics. This file contains 6.",
    "It exists to prove the pipeline end to end — the schema, the multi-framework",
    "mappings, the unit handling and the reporting fan-out — and to give the UI",
    "something to render that is not empty.",
    "",
    "It is NOT a substitute for loading the real ESG_Topics_Metrics sheet.",
    "These 6 are the metrics whose definitions are least in dispute (total GHG",
    "emissions, the three GHG scopes, energy, water, workforce headcount), which",
    "is exactly why they are safe to use as examples.",
    "",
    "TO LOAD THE REAL CATALOGUE:",
    "  1. Export ESG_Topics_Metrics from the workbook to metrics.json, using the",
    "     same shape as this file (see the `metrics` array below).",
    "  2. npm run seed:nexus  (the importer reads BOTH files if present)",
    "",
    "EVERY mapping below is verificationStatus UNVERIFIED — including the ones",
    "whose framework codes look familiar. A plausible-looking GRI number that",
    "has not been checked against the standard is worse than an empty mapping,",
    "because it will be reported as though it were true. Verify, then confirm",
    "through POST /api/nexus/metrics/:id/verify-style review, before relying on",
    "any figure a report produces."
  ],
  "metrics": [
    {
      "code": "E-GHG-01",
      "name": "Total greenhouse gas emissions (Scope 1, 2 and 3)",
      "pillar": "environmental",
      "category": "Greenhouse Gases",
      "description": "Total GHG emissions in tonnes CO2e across Scope 1, 2 and 3. The headline climate figure for statutory and investor reporting.",
      "dataType": "quantity",
      "unit": "tCO2e",
      "scope": "not_applicable",
      "boundary": "all",
      "isStatutory": true,
      "assuranceRequired": true,
      "appliesToSectorProfiles": [
        "ENERGY_HEAVY",
        "INDUSTRIAL",
        "BUILT_ENV",
        "TRANSPORT",
        "TECH"
      ],
      "mappings": [
        {
          "framework": "GRI",
          "code": "305-1",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed. Confirm against GRI 305 before use."
        },
        {
          "framework": "ISSB_S2",
          "paragraph": "29",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed. Confirm paragraph reference."
        },
        {
          "framework": "UAE_MRV",
          "mrvCategory": "total_ghg",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "UAE MRV category from the workbook. Confirm."
        },
        {
          "framework": "UAE_CLIMATE_LAW",
          "code": "SCOPE-1-2-MEASUREMENT",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook states Scope 1 & 2 measurement is mandatory; this mapping is a placeholder."
        }
      ]
    },
    {
      "code": "E-GHG-02",
      "name": "Scope 1 direct greenhouse gas emissions",
      "pillar": "environmental",
      "category": "Greenhouse Gases",
      "description": "Direct emissions from owned or controlled sources — fuel combustion in stationary and mobile sources, and process emissions.",
      "dataType": "quantity",
      "unit": "tCO2e",
      "scope": "scope1",
      "boundary": "own_operations",
      "isStatutory": true,
      "assuranceRequired": true,
      "appliesToSectorProfiles": [
        "ENERGY_HEAVY",
        "INDUSTRIAL",
        "TRANSPORT"
      ],
      "mappings": [
        {
          "framework": "GRI",
          "code": "305-1",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        },
        {
          "framework": "ISSB_S2",
          "paragraph": "29",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        },
        {
          "framework": "UAE_MRV",
          "mrvCategory": "scope_1",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        }
      ]
    },
    {
      "code": "E-GHG-03",
      "name": "Scope 2 energy indirect greenhouse gas emissions",
      "pillar": "environmental",
      "category": "Greenhouse Gases",
      "description": "Indirect emissions from purchased electricity, heat, cooling or steam. In the UAE the district-cooling provider is a material driver of this figure.",
      "dataType": "quantity",
      "unit": "tCO2e",
      "scope": "scope2",
      "boundary": "own_operations",
      "isStatutory": true,
      "assuranceRequired": true,
      "appliesToSectorProfiles": [
        "ENERGY_HEAVY",
        "BUILT_ENV",
        "RETAIL_HOSP",
        "TECH"
      ],
      "mappings": [
        {
          "framework": "GRI",
          "code": "305-2",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        },
        {
          "framework": "ISSB_S2",
          "paragraph": "29",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        },
        {
          "framework": "UAE_MRV",
          "mrvCategory": "scope_2",
          "transform": "none",
          "expectedUnit": "tCO2e",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        }
      ]
    },
    {
      "code": "E-ENE-01",
      "name": "Total energy consumption",
      "pillar": "environmental",
      "category": "Energy",
      "description": "Total energy consumed across all sources, in kWh. The denominator for most energy intensity metrics.",
      "dataType": "quantity",
      "unit": "kWh",
      "scope": "not_applicable",
      "boundary": "own_operations",
      "isStatutory": true,
      "appliesToSectorProfiles": [
        "ENERGY_HEAVY",
        "INDUSTRIAL",
        "BUILT_ENV",
        "RETAIL_HOSP",
        "TECH"
      ],
      "mappings": [
        {
          "framework": "GRI",
          "code": "302-1",
          "transform": "none",
          "expectedUnit": "kWh",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        },
        {
          "framework": "ISSB_S2",
          "paragraph": "28",
          "transform": "none",
          "expectedUnit": "kWh",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        }
      ]
    },
    {
      "code": "E-WAT-01",
      "name": "Total water withdrawal",
      "pillar": "environmental",
      "category": "Water",
      "description": "Total water withdrawn across all sources, in cubic metres. In the GCC this is closely tied to desalination and to WRI Aqueduct water-stress exposure.",
      "dataType": "quantity",
      "unit": "m3",
      "scope": "not_applicable",
      "boundary": "own_operations",
      "isStatutory": true,
      "appliesToSectorProfiles": [
        "BUILT_ENV",
        "FOOD_AGRI",
        "INDUSTRIAL",
        "RETAIL_HOSP",
        "ENERGY_HEAVY"
      ],
      "mappings": [
        {
          "framework": "GRI",
          "code": "303-3",
          "transform": "none",
          "expectedUnit": "m3",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        },
        {
          "framework": "ISSB_S2",
          "paragraph": "28",
          "transform": "none",
          "expectedUnit": "m3",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        }
      ]
    },
    {
      "code": "S-EMP-01",
      "name": "Total workforce headcount",
      "pillar": "social",
      "category": "Workforce",
      "description": "Total number of employees at period end. The denominator for most workforce rates, and the basis for Emiratisation reporting.",
      "dataType": "count",
      "unit": "count",
      "scope": "not_applicable",
      "boundary": "own_operations",
      "appliesToSectorProfiles": [
        "ENERGY_HEAVY",
        "BUILT_ENV",
        "INDUSTRIAL",
        "RETAIL_HOSP",
        "TRANSPORT",
        "FIN_SERV",
        "TECH"
      ],
      "mappings": [
        {
          "framework": "GRI",
          "code": "2-7",
          "transform": "none",
          "expectedUnit": "count",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        },
        {
          "framework": "ISSB_S1",
          "paragraph": "5",
          "transform": "none",
          "expectedUnit": "count",
          "isMandatory": true,
          "verificationStatus": "UNVERIFIED",
          "sourceReference": "Workbook-transcribed."
        }
      ]
    }
  ]
}
