{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://ref.openepcis.io/extensions/eu/electronics/electronics-json-schema.json",
  "title": "OpenEPCIS Electronics Vocabulary Schema",
  "description": "JSON Schema for validating Electronics Digital Product Passport data per ESPR Electronics delegated acts. Covers the French Repairability Index (Indice de R\u00e9parabilit\u00e9), the EU Repairability Class (A\u2013E) under Right-to-Repair Directive 2024/1799, WEEE / RoHS compliance, energy labelling (EPREL), software support commitments, and the CIRPASS-2 multi-component bill-of-materials pattern. Version 0.9.5.",
  "$defs": {
    "ElectronicDevice": {
      "type": "object",
      "title": "Electronic Device",
      "description": "An electronic device falling under ESPR Electronics delegated acts. Extends gs1:Product / schema:Product with the cross-cutting DPP fields from dpp-core plus the electronics-specific assessments below.",
      "properties": {
        "@type": {
          "const": "ElectronicDevice"
        },
        "modelIdentifier": {
          "type": "string",
          "description": "Manufacturer-assigned model identifier (commercial reference)."
        },
        "category": {
          "$ref": "#/$defs/DeviceCategory"
        },
        "hasRepairabilityIndex": {
          "$ref": "#/$defs/RepairabilityIndex",
          "description": "Recommended — repairability assessment per the French Repairability Index (Indice de Réparabilité), precursor of the EU repairability score under ESPR."
        },
        "hasSparePartAvailabilityYears": {
          "$ref": "#/$defs/QuantitativeValue",
          "description": "Recommended — duration for which spare parts remain available (unitCode ANN); repairability parameter per the French Repairability Index and the EU Right to Repair."
        },
        "hasSoftwareSupport": {
          "$ref": "#/$defs/SoftwareSupport",
          "description": "Recommended — software/firmware support lifecycle (guaranteed update period); ESPR reliability parameter for electronics."
        },
        "hasEnergyEfficiency": {
          "$ref": "#/$defs/EnergyEfficiency",
          "description": "Recommended — EU Energy Labelling (Regulation (EU) 2017/1369) / Ecodesign (EU) 2019/2021: energy label class and consumption data."
        },
        "hasBillOfMaterials": {
          "$ref": "#/$defs/ComponentBOM"
        },
        "hasWeeeCompliance": {
          "$ref": "#/$defs/WEEECompliance",
          "description": "Recommended — WEEE Directive 2012/19/EU: separate-collection marking and producer-registration compliance."
        },
        "hasRohsCompliance": {
          "$ref": "#/$defs/RoHSCompliance",
          "description": "Recommended — RoHS Directive 2011/65/EU restricted-substances compliance declaration."
        },
        "hasDisplaySpecification": {
          "$ref": "#/$defs/DisplaySpecification"
        },
        "hasMaterialDeclaration": {
          "type": "string",
          "format": "uri",
          "description": "URL to the full material declaration (e.g. IPC-1752A material composition declaration)."
        }
      }
    },
    "DeviceCategory": {
      "type": "string",
      "title": "Device Category",
      "description": "Top-level device categorisation aligned with the ESPR Electronics delegated-act scope and the WEEE Directive (2012/19/EU) Annex III categories.",
      "enum": [
        "DataStorage",
        "Desktop",
        "Dishwasher",
        "Display",
        "Laptop",
        "NetworkEquipment",
        "Printer",
        "Refrigerator",
        "Server",
        "SmallAppliance",
        "Smartphone",
        "Tablet",
        "Television",
        "VacuumCleaner",
        "WashingMachine",
        "Wearable"
      ]
    },
    "RepairabilityIndex": {
      "type": "object",
      "title": "Repairability Index",
      "description": "French Repairability Index (Indice de R\u00e9parabilit\u00e9) assessment per the official 5-criteria, 100-point methodology, extended with the EU Repairability Class (A\u2013E) introduced by Right-to-Repair Directive 2024/1799.",
      "properties": {
        "@type": {
          "const": "RepairabilityIndex"
        },
        "totalScore": {
          "type": "number",
          "minimum": 0,
          "maximum": 100,
          "description": "Overall repairability score on the 0\u2013100 scale (0 = least repairable, 100 = most repairable). Required per ESPR repairability-disclosure obligation."
        },
        "displayScore": {
          "type": "number",
          "minimum": 0,
          "maximum": 10,
          "description": "Score as displayed to consumers on the indicator label (0.0 to 10.0, one decimal). Required."
        },
        "hasRepairabilityClass": {
          "$ref": "#/$defs/EURepairabilityClass",
          "description": "EU Repairability Class (A best, E worst) per Right-to-Repair Directive 2024/1799. Required."
        },
        "hasRepairCriteria": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/RepairCriterion"
          },
          "minItems": 1,
          "description": "Five-criterion breakdown of the repairability assessment. Required."
        },
        "assessmentDate": {
          "type": "string",
          "format": "date",
          "description": "Date the repairability assessment was carried out. Required."
        },
        "hasAssessmentBody": {
          "type": "string",
          "description": "Identifier of the organisation that performed the assessment (recommend GLN). Required."
        },
        "repairabilityLabelUrl": {
          "type": "string",
          "format": "uri",
          "description": "Resolvable URL to the consumer-facing repairability label artefact. Required."
        }
      },
      "required": [
        "totalScore",
        "displayScore",
        "hasRepairabilityClass",
        "hasRepairCriteria",
        "assessmentDate",
        "hasAssessmentBody",
        "repairabilityLabelUrl"
      ]
    },
    "EURepairabilityClass": {
      "type": "string",
      "title": "EU Repairability Class",
      "description": "Repairability grade (A best to E worst) as defined by Right-to-Repair Directive 2024/1799.",
      "enum": [
        "RepairClassA",
        "RepairClassB",
        "RepairClassC",
        "RepairClassD",
        "RepairClassE"
      ]
    },
    "RepairCriterion": {
      "type": "object",
      "title": "Repair Criterion",
      "description": "An individual criterion score within the French Repairability Index 5-criterion methodology.",
      "properties": {
        "@type": {
          "const": "RepairCriterion"
        },
        "hasCriterionType": {
          "$ref": "#/$defs/RepairCriterionType",
          "description": "Which of the five criteria this entry scores. Required."
        },
        "criterionScore": {
          "type": "number",
          "minimum": 0,
          "description": "Score achieved on this criterion (\u2265 0). Required."
        },
        "criterionMaxScore": {
          "type": "number",
          "minimum": 0,
          "description": "Maximum possible score for this criterion under the methodology. Required."
        },
        "criterionDetails": {
          "type": "string",
          "description": "Free-text justification or sub-criterion breakdown for the score."
        }
      },
      "required": [
        "hasCriterionType",
        "criterionScore",
        "criterionMaxScore"
      ]
    },
    "RepairCriterionType": {
      "type": "string",
      "title": "Repair Criterion Type",
      "description": "The five French Repairability Index criteria.",
      "enum": [
        "Documentation",
        "Disassembly",
        "SparePartsAvailability",
        "SparePartsPricing",
        "ProductSpecific"
      ]
    },
    "SoftwareSupport": {
      "type": "object",
      "title": "Software Support",
      "description": "Operating-system and firmware support commitments. The EU Right-to-Repair Directive 2024/1799 and ESPR Electronics delegated acts require explicit minimum support periods for security and feature updates.",
      "properties": {
        "@type": {
          "const": "SoftwareSupport"
        },
        "operatingSystem": {
          "type": "string",
          "description": "Operating system name (e.g. Android, iOS, Windows, Linux distribution). Required."
        },
        "osVersion": {
          "type": "string",
          "description": "Operating-system version shipped with the device. Required."
        },
        "firmwareVersion": {
          "type": "string",
          "description": "Firmware version shipped with the device. Required."
        },
        "securityUpdateEndDate": {
          "type": "string",
          "format": "date",
          "description": "Date until which security updates are committed to be provided. Required."
        },
        "featureUpdateEndDate": {
          "type": "string",
          "format": "date",
          "description": "Date until which feature updates are committed to be provided. Required."
        },
        "hasSecuritySupportYears": {
          "type": "integer",
          "minimum": 0,
          "description": "Security support period in whole years from placement on the market. Required."
        },
        "hasFeatureSupportYears": {
          "type": "integer",
          "minimum": 0,
          "description": "Feature support period in whole years from placement on the market. Required."
        },
        "updateChannel": {
          "type": "string",
          "format": "uri",
          "description": "Resolvable URL where software updates are published or distributed. Required."
        }
      },
      "required": [
        "operatingSystem",
        "osVersion",
        "firmwareVersion",
        "securityUpdateEndDate",
        "featureUpdateEndDate",
        "hasSecuritySupportYears",
        "hasFeatureSupportYears",
        "updateChannel"
      ]
    },
    "EnergyEfficiency": {
      "type": "object",
      "title": "Energy Efficiency",
      "description": "EU Energy Label data per Energy Labelling Framework Regulation 2017/1369 and the relevant product-group delegated acts, plus the EPREL (European Product Registry for Energy Labelling) cross-reference.",
      "properties": {
        "@type": {
          "const": "EnergyEfficiency"
        },
        "hasEnergyEfficiencyClass": {
          "$ref": "#/$defs/EnergyEfficiencyClass"
        },
        "hasAnnualEnergyConsumption": {
          "$ref": "#/$defs/QuantitativeValue",
          "description": "Annual energy consumption (typically in kWh/year)."
        },
        "energyLabelUrl": {
          "type": "string",
          "format": "uri",
          "description": "Resolvable URL to the consumer-facing EU energy-label artefact (the A\u2013G colour scale)."
        },
        "eprelProductUrl": {
          "type": "string",
          "format": "uri",
          "description": "EPREL database registry URL for this product."
        }
      }
    },
    "EnergyEfficiencyClass": {
      "type": "string",
      "title": "Energy Efficiency Class",
      "description": "EU Energy Label class (A best, G worst) per Energy Labelling Regulation 2017/1369 rescaled labels.",
      "enum": [
        "EnergyClassA",
        "EnergyClassB",
        "EnergyClassC",
        "EnergyClassD",
        "EnergyClassE",
        "EnergyClassF",
        "EnergyClassG"
      ]
    },
    "ComponentBOM": {
      "type": "object",
      "title": "Component Bill of Materials",
      "description": "Bill of Materials for multi-component electronics, supporting the CIRPASS-2 nested-DPP pattern for components.",
      "properties": {
        "@type": {
          "const": "ComponentBOM"
        },
        "hasComponents": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ElectronicComponent"
          },
          "minItems": 1,
          "description": "Constituent components of the device. Required."
        }
      },
      "required": [
        "hasComponents"
      ]
    },
    "ElectronicComponent": {
      "type": "object",
      "title": "Electronic Component",
      "description": "An individual electronic component listed in the device's bill of materials.",
      "properties": {
        "@type": {
          "const": "ElectronicComponent"
        },
        "name": {
          "type": "string",
          "description": "Human-readable component name. Required."
        },
        "hasComponentType": {
          "$ref": "#/$defs/ComponentType"
        },
        "componentPartNumber": {
          "type": "string",
          "description": "Manufacturer-assigned part number for the component."
        },
        "hasComponentPassport": {
          "type": "string",
          "format": "uri",
          "description": "Resolvable URL to the component's own Digital Product Passport (CIRPASS-2 nested-DPP pattern)."
        },
        "hasReplacementDifficulty": {
          "$ref": "#/$defs/ReplacementDifficulty"
        }
      },
      "required": [
        "name"
      ]
    },
    "ComponentType": {
      "type": "string",
      "title": "Component Type",
      "description": "Functional component categorisation used in the bill of materials.",
      "enum": [
        "BatteryComponent",
        "CameraComponent",
        "ConnectorComponent",
        "CoolingSystemComponent",
        "DisplayComponent",
        "EnclosureComponent",
        "KeyboardComponent",
        "MemoryComponent",
        "MicrophoneComponent",
        "MotherboardComponent",
        "PowerSupplyComponent",
        "ProcessorComponent",
        "SpeakerComponent",
        "StorageComponent",
        "TrackpadComponent"
      ]
    },
    "ReplacementDifficulty": {
      "type": "string",
      "title": "Replacement Difficulty",
      "description": "How accessible the replacement of this component is.",
      "enum": [
        "UserReplaceable",
        "ToolRequired",
        "ProfessionalOnly",
        "NotReplaceable"
      ]
    },
    "WEEECompliance": {
      "type": "object",
      "title": "WEEE Compliance",
      "description": "Waste Electrical and Electronic Equipment (WEEE) Directive 2012/19/EU compliance information.",
      "properties": {
        "@type": {
          "const": "WEEECompliance"
        },
        "weeeCategory": {
          "$ref": "#/$defs/WEEECategory"
        },
        "collectionSchemeUrl": {
          "type": "string",
          "format": "uri",
          "description": "Resolvable URL to the producer-responsibility collection scheme covering this product."
        },
        "wasteCode": {
          "type": "string",
          "description": "European Waste Catalogue (EWC) code applicable at end of life."
        },
        "recyclingInstructions": {
          "type": "string",
          "format": "uri",
          "description": "Resolvable URL to recycling / dismantling instructions for waste-treatment operators."
        }
      }
    },
    "WEEECategory": {
      "type": "string",
      "title": "WEEE Category",
      "description": "WEEE Directive 2012/19/EU Annex III equipment categories.",
      "enum": [
        "WEEE1_TemperatureExchange",
        "WEEE2_ScreensMonitors",
        "WEEE3_Lamps",
        "WEEE4_LargeEquipment",
        "WEEE5_SmallEquipment",
        "WEEE6_SmallIT"
      ]
    },
    "RoHSCompliance": {
      "type": "object",
      "title": "RoHS Compliance",
      "description": "Restriction of Hazardous Substances (RoHS) Directive 2011/65/EU compliance information.",
      "properties": {
        "@type": {
          "const": "RoHSCompliance"
        },
        "rohsCompliant": {
          "type": "boolean",
          "description": "True if the product complies with the RoHS restricted-substances list."
        },
        "rohsDeclarationUrl": {
          "type": "string",
          "format": "uri",
          "description": "Resolvable URL to the manufacturer's RoHS declaration of conformity."
        },
        "rohsExemptions": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "List of RoHS Annex III / Annex IV exemption numbers claimed (e.g. \"6(c)\", \"7(a)\")."
        }
      }
    },
    "DisplaySpecification": {
      "type": "object",
      "title": "Display Specification",
      "description": "Display-specific technical specifications for monitors, TVs, and device screens (relevant to the ESPR Electronics display delegated act).",
      "properties": {
        "@type": {
          "const": "DisplaySpecification"
        },
        "displayTechnology": {
          "type": "string",
          "description": "Display technology (e.g. LCD-IPS, OLED, mini-LED, e-ink)."
        },
        "displaySize": {
          "$ref": "#/$defs/QuantitativeValue",
          "description": "Diagonal display size, typically expressed in inches."
        },
        "displayResolution": {
          "type": "string",
          "description": "Native resolution, e.g. \"3840x2160\"."
        },
        "hasRefreshRate": {
          "$ref": "#/$defs/QuantitativeValue",
          "description": "Refresh rate, typically in Hz."
        },
        "hasPeakBrightness": {
          "$ref": "#/$defs/QuantitativeValue",
          "description": "Peak luminance, typically in cd/m\u00b2 (nits)."
        }
      }
    },
    "QuantitativeValue": {
      "type": "object",
      "title": "Quantitative Value",
      "description": "GS1-idiomatic quantitative value with a numeric magnitude and a UN/CEFACT Recommendation 20 unit code.",
      "properties": {
        "@type": {
          "const": "QuantitativeValue"
        },
        "value": {
          "type": "number"
        },
        "unitCode": {
          "type": "string",
          "description": "UN/CEFACT Recommendation 20 unit code (e.g. KWH for kilowatt-hour, HTZ for Hertz, INH for inch, CDL for candela per square metre)."
        }
      },
      "required": [
        "value",
        "unitCode"
      ]
    }
  },
  "oneOf": [
    {
      "$ref": "#/$defs/ElectronicDevice"
    },
    {
      "$ref": "#/$defs/RepairabilityIndex"
    },
    {
      "$ref": "#/$defs/RepairCriterion"
    },
    {
      "$ref": "#/$defs/SoftwareSupport"
    },
    {
      "$ref": "#/$defs/EnergyEfficiency"
    },
    {
      "$ref": "#/$defs/ComponentBOM"
    },
    {
      "$ref": "#/$defs/ElectronicComponent"
    },
    {
      "$ref": "#/$defs/WEEECompliance"
    },
    {
      "$ref": "#/$defs/RoHSCompliance"
    },
    {
      "$ref": "#/$defs/DisplaySpecification"
    }
  ]
}