# 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](https://passport.kabin.sh/docs/de/concepts/passports). |
| 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](https://passport.kabin.sh/docs/de/concepts/battery-models).                                                                                                         |
| 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](https://passport.kabin.sh/docs/de/concepts/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`](https://passport.kabin.sh/docs/de/api-reference/registry/get-registry-schema). |
| Zugriffsstufe      | Tier (access tier)  | Wer ein Feld oder Dokument sehen darf: `public`, `legitimate_interest`, `authority` oder `internal`. Siehe [Zugriffsstufen](https://passport.kabin.sh/docs/de/concepts/access-tiers).                                                           |
| Herkunft           | Provenance          | Woher ein Wert stammt: Quelle, Urheber, Zeitpunkt, Prüfer und Nachweise, für jede Revision aufbewahrt. Siehe [Herkunft und Freigabe](https://passport.kabin.sh/docs/de/concepts/provenance-and-review).                                         |
| 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](https://passport.kabin.sh/docs/de/concepts/condition-and-lifecycle). |
| 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](https://passport.kabin.sh/docs/de/authentication). |
| 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](https://passport.kabin.sh/docs/de/errors).                                                |
| 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](https://passport.kabin.sh/docs/de/pagination).       |

## 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](https://passport.kabin.sh/docs/de/concepts/signatures). |
