Code-Architektur

Richtlinien zur Navigation im Anwendungs-Repository, ohne die Ebenen für UI, API und Persistenz zu verwechseln.

Zone	Rolle
`src/app`	Next.js-Routen, Seiten und API-Endpunkte
`src/components`	Oberfläche, Tabs, Widgets und Modals
`src/providers`	Client-Zustand und Aufrufe der Konfigurations-API
`src/lib`	Typen, Authentifizierung, Zugriffskontrolle, Persistenz, Integrationen und Geschäftsregeln
`public`	Statische Ressourcen
`e2e`	Playwright-Szenarien
`scripts`	Container-Tests und Wartungswerkzeuge
`data`	Persistente lokale Daten, niemals Quellcode

Konfigurationsänderungen werden über Server-Routen verarbeitet, die Administratorrechte erzwingen und Antworten filtern. Integrationen werden serverseitig abgefragt, um deren Geheimnisse nicht direkt im Browser preiszugeben.

Bevor Sie einen geteilten Typ ändern, suchen Sie nach seinen Verwendern in der API, Formularen, der Persistenzebene, Lese-Filtern und Tests. Eine sichtbare Option ohne vollständigen Server-Vertrag ist eine unvollständige Funktion.