Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

Konventionen

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.
  • 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.

Die vollständige Liste der Kern-Invarianten steht in AGENTS.md.