Code Quality & Conventions

Einheitliche Standards beschleunigen Reviews, Deployments und Onboarding. Nachfolgend unsere Leitplanken für sauberen Code und Prozesse.

TypeScript

• Strikte Typisierung, keine any in Libraries.
• Utility- und DTO-Typen zentral halten und wiederverwenden.

ESLint & Formatierung

• ESLint läuft in CI; Fehler blockieren Merges.
• Nutze Prettier-Einstellungen des Repos; keine eigenen Overrides.

Ordnerstruktur

• app/ als Routenbaum, components/ für UI, lib/für Services/Utils.
• Docs leben unter app mit Sidebar-Navigation.

Commits & Branches

• Commit-Style: feat:, fix:, docs:, refactor:, chore:.
• Feature-Branches: feat/<kurz-beschreibend>.
• Pull Requests klein und reviewbar halten (≤ 300 Zeilen netto).

Tests

• Unit-Tests an kritischen Stellen (Parser, Kalkulationen).
• API-Verträge mit Contract- oder Smoke-Tests absichern.

Security

• Secrets nie clientseitig; nur Server/CI Envs.
• Input validieren, Output escapen; Logs ohne personenbezogene Daten.