Architettura del codice
Linee guida per orientarsi nel repository dell'applicazione senza confondere i livelli di interfaccia utente, API e persistenza.
| Zona | Ruolo |
|---|---|
src/app | Route, pagine ed endpoint API di Next.js |
src/components | Interfaccia, schede, widget e modali |
src/providers | Stato client e chiamate all'API di configurazione |
src/lib | Tipi, autenticazione, controllo degli accessi, persistenza, integrazioni e regole di business |
public | Risorse statiche |
e2e | Scenari Playwright |
scripts | Test dei container e strumenti di manutenzione |
data | Dati locali persistenti, mai codice sorgente |
Le mutazioni della configurazione passano attraverso le route del server, che impongono i privilegi di amministratore e filtrano le risposte. Le integrazioni vengono interrogate lato server per evitare di esporre i loro segreti direttamente al browser.
Prima di modificare un tipo condiviso, cerca i suoi consumer nell'API, nei moduli, nel livello di persistenza, nei filtri di lettura e nei test. Un'opzione visibile priva di un contratto server completo è una funzionalità non completata.
Manifesti e contratti sono in src/integrations; registro e viste in src/widgets; persistenza, filtri e modelli in src/lib/pages; traduzioni in src/i18n. Credenziali infrastrutturali restano sul server. Le richieste meteo sono del browser senza segreti.