Développeurs

Architecture du code

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

ZoneRôle
src/approutes Next.js, pages et endpoints API
src/componentsinterface, onglets, widgets et modales
src/providersétat client et appels vers l'API de configuration
src/libtypes, auth, accès, persistance, intégrations et règles métier
publicressources statiques
e2escénarios Playwright
scriptstests de conteneur et outils de maintenance
datadonné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.

Manifestes et contrats d’intégrations sont dans src/integrations ; registre et vues des widgets dans src/widgets ; stockage, filtrage et modèles des pages dans src/lib/pages ; traductions dans src/i18n. Les identifiants d’infrastructure restent côté serveur. Les recherches et prévisions météo passent par le navigateur sans secret d’intégration.