Architecture du code

Repères pour naviguer dans le dépôt applicatif sans confondre UI, API et persistance.

Zone	Rôle
`src/app`	routes Next.js, pages et endpoints API
`src/components`	interface, onglets, widgets et modales
`src/providers`	état client et appels vers l'API de configuration
`src/lib`	types, auth, accès, persistance, intégrations et règles métier
`public`	ressources statiques
`e2e`	scénarios Playwright
`scripts`	tests de conteneur et outils de maintenance
`data`	données locales persistantes, jamais du code source

Les mutations de configuration passent par les routes serveur, qui contrôlent l'administrateur et filtrent les réponses. Les intégrations sont interrogées côté serveur afin de ne pas exposer directement leurs secrets au navigateur.

Avant de changer un type partagé, recherchez ses consommateurs dans l'API, les formulaires, la persistance, les filtres lecteur et les tests. Une option visible sans contrat serveur complet est une fonctionnalité inachevée.