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