# batterypass/batterypassdatamodel architecture

> Architecture diagram of the GitHub repository batterypass/batterypassdatamodel, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/batterypass/batterypassdatamodel
- Repository: https://github.com/batterypass/batterypassdatamodel

## Overview

BatteryPass is a platform-independent semantic data model for battery-passport information, with generated Java classes representing standardized, interoperable data rather than a running service. Stakeholders integrate these definitions into an application or schema to exchange battery data across its lifecycle. The model covers product identity, composition, performance, footprint, labels, circularity, and supply-chain diligence. Edges below show only class fields or constructor parameters supported by excerpts or the source index; other category models are included as documented capabilities, without inferred wiring.

Main entry points: [`BatteryPass/java/BatteryPass/Circularity/Circularity.java`](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/Circularity.java) (Circularity information), [`BatteryPass/java/BatteryPass/GeneralProductInformation/GeneralProductInformation.java`](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/GeneralProductInformation/GeneralProductInformation.java) (Product information), [`BatteryPass/java/BatteryPass/MaterialComposition/MaterialComposition.java`](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/MaterialComposition/MaterialComposition.java) (Material composition), [`BatteryPass/java/BatteryPass/GeneralProductInformation/ContactInformationEntity.java`](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/GeneralProductInformation/ContactInformationEntity.java) (Contact details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Product identity"]
  node_product["Product information"]
  node_contact["Contact details"]
  node_address["Postal address"]
end

subgraph group_technical["Technical profile"]
  node_composition["Material composition"]
  node_materials["Battery materials"]
  node_hazards["Hazardous substances"]
  node_performance["Performance properties"]
  node_condition["Battery condition"]
  node_component["Battery component"]
end

subgraph group_sustainability["Sustainability data"]
  node_carbon["Carbon footprint"]
  node_labels["Battery labeling<br/>[Labeling.java]"]
  node_labelentity["Label details"]
end

subgraph group_lifecycle["Lifecycle stewardship"]
  node_circularity["Circularity information<br/>[Circularity.java]"]
  node_dismantling["Dismantling documents"]
  node_spares["Spare-part suppliers"]
  node_recycled["Recycled content"]
  node_duediligence["Supply-chain diligence"]
end

node_stakeholders(("Value-chain stakeholders"))
node_application["Integrating application"]

node_stakeholders -->|"integrate data"| node_application
node_application -->|"uses definitions"| node_product
node_product -->|"includes contacts"| node_contact
node_product -->|"includes location"| node_address
node_contact -->|"includes address"| node_address
node_composition -->|"includes materials"| node_materials
node_composition -->|"includes substances"| node_hazards
node_condition -->|"tracks resistance"| node_component
node_labels -->|"includes labels"| node_labelentity
node_circularity -->|"includes documents"| node_dismantling
node_circularity -->|"includes suppliers"| node_spares
node_circularity -->|"includes content"| node_recycled

click node_product "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/GeneralProductInformation/GeneralProductInformation.java"
click node_contact "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/GeneralProductInformation/ContactInformationEntity.java"
click node_address "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/GeneralProductInformation/PostalAddressEntity.java"
click node_composition "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/MaterialComposition/MaterialComposition.java"
click node_materials "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/MaterialComposition/BatteryMaterialEntity.java"
click node_hazards "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/MaterialComposition/HazardousSubstanceEntity.java"
click node_performance "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Performance/BatteryTechnicalPropertiesEntity.java"
click node_condition "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Performance/BatteryConditionEntity.java"
click node_component "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Performance/BatteryComponent.java"
click node_carbon "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/CarbonFootprint/CarbonFootprintForBatteries.java"
click node_labels "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Labels/Labeling.java"
click node_labelentity "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Labels/LabelingEntity.java"
click node_circularity "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/Circularity.java"
click node_dismantling "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/DismantlingandRemovalDocumentation.java"
click node_spares "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/SparePartSupplierEntity.java"
click node_recycled "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/RecycledContentEntity.java"
click node_duediligence "https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/SupplyChainDueDiligence/SupplyChainDueDiligence.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_product,node_contact,node_address toneBlue
class node_composition,node_materials,node_hazards,node_performance,node_condition,node_component toneAmber
class node_carbon,node_labels,node_labelentity toneMint
class node_circularity,node_dismantling,node_spares,node_recycled,node_duediligence toneRose
class node_stakeholders,node_application toneIndigo
```

## Components

### Product identity

- [Product information](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/GeneralProductInformation/GeneralProductInformation.java): `BatteryPass/java/BatteryPass/GeneralProductInformation/GeneralProductInformation.java`
- [Contact details](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/GeneralProductInformation/ContactInformationEntity.java): `BatteryPass/java/BatteryPass/GeneralProductInformation/ContactInformationEntity.java`
- [Postal address](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/GeneralProductInformation/PostalAddressEntity.java): `BatteryPass/java/BatteryPass/GeneralProductInformation/PostalAddressEntity.java`

### Technical profile

- [Material composition](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/MaterialComposition/MaterialComposition.java): `BatteryPass/java/BatteryPass/MaterialComposition/MaterialComposition.java`
- [Battery materials](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/MaterialComposition/BatteryMaterialEntity.java): `BatteryPass/java/BatteryPass/MaterialComposition/BatteryMaterialEntity.java`
- [Hazardous substances](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/MaterialComposition/HazardousSubstanceEntity.java): `BatteryPass/java/BatteryPass/MaterialComposition/HazardousSubstanceEntity.java`
- [Performance properties](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Performance/BatteryTechnicalPropertiesEntity.java): `BatteryPass/java/BatteryPass/Performance/BatteryTechnicalPropertiesEntity.java`
- [Battery condition](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Performance/BatteryConditionEntity.java): `BatteryPass/java/BatteryPass/Performance/BatteryConditionEntity.java`
- [Battery component](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Performance/BatteryComponent.java): `BatteryPass/java/BatteryPass/Performance/BatteryComponent.java`

### Sustainability data

- [Carbon footprint](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/CarbonFootprint/CarbonFootprintForBatteries.java): `BatteryPass/java/BatteryPass/CarbonFootprint/CarbonFootprintForBatteries.java`
- [Battery labeling](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Labels/Labeling.java): `BatteryPass/java/BatteryPass/Labels/Labeling.java`
- [Label details](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Labels/LabelingEntity.java): `BatteryPass/java/BatteryPass/Labels/LabelingEntity.java`

### Lifecycle stewardship

- [Circularity information](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/Circularity.java): `BatteryPass/java/BatteryPass/Circularity/Circularity.java`
- [Dismantling documents](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/DismantlingandRemovalDocumentation.java): `BatteryPass/java/BatteryPass/Circularity/DismantlingandRemovalDocumentation.java`
- [Spare-part suppliers](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/SparePartSupplierEntity.java): `BatteryPass/java/BatteryPass/Circularity/SparePartSupplierEntity.java`
- [Recycled content](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/Circularity/RecycledContentEntity.java): `BatteryPass/java/BatteryPass/Circularity/RecycledContentEntity.java`
- [Supply-chain diligence](https://github.com/batterypass/batterypassdatamodel/blob/main/BatteryPass/java/BatteryPass/SupplyChainDueDiligence/SupplyChainDueDiligence.java): `BatteryPass/java/BatteryPass/SupplyChainDueDiligence/SupplyChainDueDiligence.java`

### Other components

- **Value-chain stakeholders**
- **Integrating application**

## Connections

- Value-chain stakeholders → Integrating application: integrate data (evidence: `README.md`)
- Integrating application → Product information: uses definitions (evidence: `README.md`)
- Product information → Contact details: includes contacts (evidence: `BatteryPass/java/BatteryPass/GeneralProductInformation/GeneralProductInformation.java`)
- Product information → Postal address: includes location (evidence: `BatteryPass/java/BatteryPass/GeneralProductInformation/GeneralProductInformation.java`)
- Contact details → Postal address: includes address (evidence: `BatteryPass/java/BatteryPass/GeneralProductInformation/ContactInformationEntity.java`)
- Material composition → Battery materials: includes materials (evidence: `BatteryPass/java/BatteryPass/MaterialComposition/MaterialComposition.java`)
- Material composition → Hazardous substances: includes substances (evidence: `BatteryPass/java/BatteryPass/MaterialComposition/MaterialComposition.java`)
- Battery condition → Battery component: tracks resistance
- Battery labeling → Label details: includes labels (evidence: `BatteryPass/java/BatteryPass/Labels/Labeling.java`)
- Circularity information → Dismantling documents: includes documents (evidence: `BatteryPass/java/BatteryPass/Circularity/Circularity.java`)
- Circularity information → Spare-part suppliers: includes suppliers (evidence: `BatteryPass/java/BatteryPass/Circularity/Circularity.java`)
- Circularity information → Recycled content: includes content (evidence: `BatteryPass/java/BatteryPass/Circularity/Circularity.java`)
