Allgemeines
Glossar
Die Fach- und API-Begriffe dieser Dokumentation, auf Deutsch und Englisch.
Die Spalte „Englisch“ nennt den Begriff, den die englischen Seiten dieser Dokumentation verwenden. Code, Feldnamen und Operation-Ids sind in beiden Sprachen gleich.
Produkte und Pässe
| Begriff | Englisch | Bedeutung |
|---|---|---|
| Batteriepass | Battery passport | Der digitale Datensatz einer einzelnen Batterie nach Verordnung (EU) 2023/1542 (Art. 77). In BatteryPass hat jede Einheit einen Pass mit nummerierten, signierten Versionen. Siehe Pässe. |
| Passversion | Passport version | Eine Veröffentlichung eines Passes. Sie ändert sich nie und enthält Snapshot, öffentliches Dokument und deren Signaturen. |
| Wirtschaftsakteur | Economic operator | Hersteller, Einführer oder Bevollmächtigter, der eine Batterie in Verkehr bringt und für ihren Pass verantwortlich ist. |
| Batteriemodell | Battery model | Das Handelsprodukt mit Name, SKU, GTIN und Kategorie. Siehe Batteriemodelle. |
| Modellversion | Model version | Ein technischer Stand eines Batteriemodells, gültig ab seinem Datum effective_from. Hier liegen die Werte der Modellebene. Status draft, approved oder superseded. |
| Einheit | Unit | Eine physische Batterie mit Seriennummer, einer Modellversion zugeordnet. In der API heißt sie Battery. |
| GTIN | GTIN | Global Trade Item Number, die GS1-Nummer des Batteriemodells. BatteryPass speichert sie 14-stellig. |
| GS1 Digital Link | GS1 Digital Link | Eine Webadresse aus GS1-Kennungen, hier /01/{gtin}/21/{serial}. Genau diese trägt der QR-Code. Siehe GS1 Digital Link. |
| Resolver | Resolver | Der Dienst hinter dem Digital Link: Er leitet Browser zur öffentlichen Seite und Maschinen zum öffentlichen JSON oder zu einem Linkset. |
| Second Life | Second life | Eine umgewidmete, wiederverwendete oder wiederaufbereitete Batterie. Sie wird eine neue Einheit mit eigenem Pass, der auf das Original verweist. |
Daten und Prüfung
| Begriff | Englisch | Bedeutung |
|---|---|---|
| Feldregister | Field registry | Die versionierte Liste aller Passfelder: Ebene, Zugriffsstufe, Pflicht je Batteriekategorie, Validierung und Exportpfade. Sie lesen es mit getRegistrySchema. |
| Zugriffsstufe | Tier (access tier) | Wer ein Feld oder Dokument sehen darf: public, legitimate_interest, authority oder internal. Siehe Zugriffsstufen. |
| Herkunft | Provenance | Woher ein Wert stammt: Quelle, Urheber, Zeitpunkt, Prüfer und Nachweise, für jede Revision aufbewahrt. Siehe Herkunft und Freigabe. |
| Nachweis | Evidence | Ein Dokument, das einen Wert belegt, etwa eine Konformitätserklärung oder ein Prüfbericht. Nachweise sind versioniert und haben eine eigene Zugriffsstufe. |
| Vier-Augen-Prinzip | Four-eyes principle | Die Regel, dass ein anderes Mitglied einen Wert freigibt als das, das ihn erfasst hat. In jeder Organisation standardmäßig eingeschaltet. |
Zustand und Lebenszyklus
| Begriff | Englisch | Bedeutung |
|---|---|---|
| Zustandsdaten | Condition data | Gemessene Werte einer Einheit, der Abschnitt condition des Registers. Als Messwerte ohne Prüfschritt angenommen. Siehe Zustandsdaten und Lebenszyklus. |
| Gesundheitszustand (State of Health, SoH) | State of health | Wie viel ihrer ursprünglichen Leistungsfähigkeit eine Batterie noch hat. Das Register drückt ihn über Felder wie Kapazitätsverlust, verbleibende Kapazität und, bei Elektrofahrzeugbatterien, den State of Certified Energy aus. |
| Lebenszyklus-Ereignis | Lifecycle event | Eine datierte Aufzeichnung dessen, was mit einer Einheit geschehen ist, etwa eine Reparatur oder Inspektion. Ereignisse ändern keine Daten der Einheit. |
API
| Begriff | Englisch | Bedeutung |
|---|---|---|
| API-Schlüssel | API key | Der Zugangsschlüssel einer Organisation, bp_live_…, gesendet als Authorization: Bearer. Er handelt mit den Rechten eines Betrachters. Siehe Authentifizierung. |
| Scope | Scope | Was ein Schlüssel darf: read (Daten lesen), condition (Zustandsdaten und Lebenszyklus-Ereignisse melden) oder import (Tabellenimporte bereitstellen, die Mitglieder übernehmen). |
| Problem Details | Problem Details | Das Fehlerformat nach RFC 9457 (application/problem+json), hier mit stabilem code und einer request_id. Siehe Fehler. |
| Keyset-Paginierung | Keyset pagination | Blättern mit limit und einem undurchsichtigen cursor; eine Seite liefert items und next_cursor, das auf der letzten Seite null ist. Siehe Paginierung. |
Signaturen
| Begriff | Englisch | Bedeutung |
|---|---|---|
| JCS | JCS | JSON Canonicalization Scheme (RFC 8785): eine feste Art, JSON zu serialisieren, sodass dieselben Daten immer dieselben Bytes zum Hashen und Signieren ergeben. |
| Ed25519 | Ed25519 | Das Signaturverfahren von BatteryPass (EdDSA auf Curve25519, RFC 8032). Öffentliche Schlüssel haben 32 Bytes, Signaturen 64 Bytes. |
| JWK | JWK | JSON Web Key (RFC 7517), ein öffentlicher Schlüssel als JSON. BatteryPass veröffentlicht seine Ed25519-Schlüssel als OKP-Schlüssel (RFC 8037) in einem JWK-Set unter /.well-known/batterypass/keys.json. Siehe Signaturen. |