feat(schema): ElectricityCredential v1.1 — unified energyResources, multi-meter topology, ConsumptionProfile

[ameetdesh]

Summary

• ElectricityCredential v1.1 replaces the three separate v1.0 profile arrays (consumptionProfiles, generationProfiles, storageProfiles) with a single customerProfile.energyResources[] using EnergyResource/v2.0 as the canonical asset class. No v1.0 field is lost — every field maps to an EnergyResource id, type, or attributes property.
• ConsumptionProfile links tariff/load data (sanctionedLoadKW, tariffCategoryCode) to a specific meter via meterId. Kept separate from physical asset data because tariff info is administrative and changes independently.
• Multi-topology support: a single customerNumber can have multiple METER entries (different premises, sub-meters, parallel meters). DERs link to their parent meter via parentResources[]; consumption profiles link via meterId.
• EnergyResource/v2.0 updated: fields renamed (resourceId → id, resourceType → type, resourceAttributes → attributes); CommonResourceAttributes (make, model, ratedPowerKw, energyCapacityKwh, telemetryProvider) extracted as a component nested inside the attributes bag. type promoted to a closed enum — grid infrastructure types DT, BUS, FEEDER added alongside generation, storage and load types. Stale vocab.jsonld entries (sourceType, meterId) removed.
• PII isolation: fullName exclusively in customerDetails — never in profile entries.

EnergyResource.type enum

Category	Values
Grid infrastructure	METER, DT, BUS, FEEDER
Generation DERs	SOLAR, SOLAR_PV, WIND, HYDRO, BIOGAS, CHP, FUEL_CELL
Storage	BATTERY, BESS
Flexible loads	EV_CHARGER, EV_V2G, SMART_HVAC, SMART_WATER_HEATER, CONTROLLABLE_LOAD
System	MICROGRID

EnergyResource structure

EnergyResource
├── id                — stable identifier (meter serial number for METER)
├── type              — enum (see table above)
├── attributes        — open bag; CommonResourceAttributes + type-specific fields
│   ├── make, model, ratedPowerKw, energyCapacityKwh, telemetryProvider
│   └── meterType, gps, location, feeder, bus / commissioningDate / storageType / …
├── subResources[]    — child resource ids or inline objects
└── parentResources[] — parent resource ids (e.g. DT id for a meter)

Files changed

File	Change
ElectricityCredential/v1.1/attributes.yaml	New — ElectricityCredential, CustomerProfile, ConsumptionProfile, CustomerDetails
ElectricityCredential/v1.1/schema.json	New — self-contained bundled JSON Schema
ElectricityCredential/v1.1/context.jsonld	New — JSON-LD context
ElectricityCredential/v1.1/vocab.jsonld	New — RDF vocabulary
ElectricityCredential/v1.1/README.md	New — full documentation
ElectricityCredential/v1.1/examples/example.json	Single meter (parentResources → DT) + 2 generation + 2 storage DERs
ElectricityCredential/v1.1/examples/example-submetering.json	Building main meter + 2 tenant sub-meters + solar DER
ElectricityCredential/v1.1/examples/example-parallel-metering.json	Dual parallel meters (import/export) + solar DER + FIT tariff
EnergyResource/v2.0/attributes.yaml	Rename id/type/attributes; add CommonResourceAttributes; type → enum with DT/BUS/FEEDER
EnergyResource/v2.0/context.jsonld	Updated for new field names and attributes nested context
EnergyResource/v2.0/vocab.jsonld	Rewrite: fix stale entries, add CommonResourceAttributes class and properties
EnergyResource/v2.0/README.md	Add CommonResourceAttributes section, type enum table, updated examples

v1.0 → v1.1 field mapping

v1.0	v1.1
customerProfile.meterNumber	energyResources[METER].id
customerProfile.meterType	energyResources[METER].attributes.meterType
consumptionProfiles[].sanctionedLoadKW	consumptionProfiles[].sanctionedLoadKW
consumptionProfiles[].tariffCategoryCode	consumptionProfiles[].tariffCategoryCode
generationProfiles[].assetId	energyResources[DER].id
generationProfiles[].capacityKW	energyResources[DER].attributes.ratedPowerKw
generationProfiles[].manufacturer	energyResources[DER].attributes.make
generationProfiles[].commissioningDate	energyResources[DER].attributes.commissioningDate
storageProfiles[].storageCapacityKWh	energyResources[DER].attributes.energyCapacityKwh
storageProfiles[].storageType	energyResources[DER].attributes.storageType
fullName (duplicated per entry)	customerDetails.fullName (once)

Test plan

• Validate examples/example.json against schema.json
• Validate examples/example-submetering.json against schema.json
• Validate examples/example-parallel-metering.json against schema.json
• Confirm all v1.0 credential fields have a documented v1.1 destination (mapping table above)

🤖 Generated with Claude Code