---
title: Konventionen
description: Sprachregeln, Backend- und Frontend-Muster.
---

- **Sprache:** Deutsch für die Domäne (Datenbankschema, API-Felder, Oberfläche), Englisch für
  Technik (Kommentare, Commits, generische Bezeichner). Siehe [`CONVENTIONS.md`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/CONVENTIONS.md).
- **Rechte:** Schreibende Endpunkte prüfen eine Berechtigung; relevante Aktionen landen im
  Audit-Log, Patientendaten nie — auch keine Freitexte, die sie enthalten können (Anrufer,
  Zusatzinfo eines Einsatzes, Text und Meldeweg eines Tagebucheintrags).
- **Logs und Fehlerberichte nur mit IDs:** keine Namen, Benutzernamen, Adressen, Dateinamen,
  Kennungswerte oder Freitexte — auch nicht in Fehlertexten, die an GlitchTip gehen. Das Request-Log
  enthält weder Query noch Client-IP; ein Filter maskiert URLs und E-Mail-Adressen in jeder Logzeile
  zusätzlich, ein Test prüft die Log-Aufrufe im Code.
- **Append-only:** Tagebuch, Audit-Log, Lage-Nachrichten, Aufgaben-Ereignisse,
  Patientenverlauf und Schadenverlauf werden nie geändert oder gelöscht (der Schadenverlauf
  verschwindet nur zusammen mit seinem Schaden).
- **Sperrreihenfolge** in Transaktionen: Lage, dann Fahrzeug, dann Einsatz.
- **Ausgehende Abrufe** mit Ziel aus Stammdaten laufen über den Egress-Guard.
- **Frontend:** eigene Komponenten statt Komponenten-Kits, schwere Bibliotheken nur
  route-gesplittet, Inhaltsziele über den Fenster-Bus.
- **Marke:** Das Produkt heißt **Lagewerk**. `elw` ist nur der technische Bezeichner in Code und
  Repository und erscheint nicht als Produktname. Das Logo ist einfarbig in der Tinte der
  Oberfläche; Farbe bleibt Status, Triage und Rückmeldung vorbehalten. Logo-Dateien entstehen nur über den Generator in `branding/lagewerk/quelle/`,
  Konzept und Regeln stehen in [`branding/KONZEPT.md`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/branding/KONZEPT.md).

Die vollständige Liste der Kern-Invarianten steht in [`AGENTS.md`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/AGENTS.md).
