🗂️ Struttura del progetto Dashboard
Il codice sorgente della Dashboard vive nella cartella src/.
Di seguito la struttura delle principali directory e il loro scopo.
🌳 Albero cartelle (panoramica)
src
├── assets/ # Immagini e risorse statiche
├── authentication/ # Login, registrazione, password reset
├── company-connect/ # Utente autenticato → collegarsi a un'azienda esistente
├── company-create/ # Utente autenticato → creare/riclamare una nuova azienda
├── company-invite-verification/ # Accettazione invito tramite token nell'URL
├── company-pending-verification/ # (DEPRECATO) verifica documentale lato backoffice
├── dashboards/ # Moduli delle sezioni per utenti connessi a una company
├── directives/ # Direttive Angular (es. tooltip) – attualmente non in uso
├── email-verification-page/ # (TODO/XX) pagina verifica email – da rivedere/descrivere
├── environments/ # Variabili per ambiente (dev/stage/prod)
├── errors/ # Pagine di errore (es. 404)
├── home/ # Entry point caricato da main.ts
├── modules/ # Moduli principali (AppModule, SharedModule, routing)
├── profile/ # Gestione profilo utente (fuori dal contesto company)
├── services/ # Servizi injectable condivisi
├── social-callback/ # Callback login social (Google, Apple, …)
├── translations/ # Chiavi e testi tradotti (i18n)
├── types/ # Tipi e interfacce (attualmente vuoto)
├── userAccessStore/ # Store accessi dell’utente alle company (NgRx)
├── utils/ # Helper e funzioni generiche
└── variables/ # Costanti e variabili globali (es. capienza bicchiere)
📁 Dettaglio directory
assets/
Risorse statiche (loghi, immagini, icone, file media).
authentication/
Flusso di registrazione, login e recupero password.
Punto d’ingresso per utenti non autenticati.
company-connect/
Percorso guidato per collegare l’utente autenticato a una company esistente (ricerca/claim).
company-create/
Flusso per creare/reclamare una nuova company quando non esiste ancora in piattaforma.
company-invite-verification/
Gestione dell’invito ricevuto da un altro utente:
lettura token da URL, verifica e connessione alla company.
company-pending-verification/ (deprecata)
Vecchio flusso che bloccava le company reclamate/create in attesa di verifica documentale lato backoffice.
Non più in uso: mantenuta per backward compatibility / migrazioni.
dashboards/
Contiene le feature module caricate in lazy loading (aree operative disponibili solo a utenti autenticati e collegati a una company).
directives/
Direttive Angular (es. tooltip). Attualmente non utilizzate.
email-verification-page/
Da documentare: pagina di verifica email.
TODO: completare descrizione e flusso quando riutilizzata.
environments/
Configurazioni per ambiente (variabili, endpoint, flag).
errors/
Componenti per pagine di errore (404, accessi non consentiti, ecc.).
home/
Root component caricato da main.ts.
Inizializza tema, i18n e orchestration della prima navigazione.
modules/
Moduli core e condivisi (es. AppModule, SharedModule, routing principale).
profile/
Gestione profilo utente (preferenze, dati personali, sicurezza).
Opera fuori dal contesto company: riguarda l’utente in quanto tale.
services/
Servizi injectable (API client, auth, storage, helpers di dominio).
social-callback/
Callback e gestione provider OAuth (Google, Apple, ecc.).
translations/
Chiavi e testi i18n (IT/EN).
Seguire convenzioni di naming esistenti.
types/
Tipi e interfacce TypeScript condivise. (Al momento vuota.)
userAccessStore/
Store centrale (NgRx) che modella gli accessi dell’utente alle varie company.
Fondamentale per:
- stabilire per quale company l'utente ha accesso e per quale sta operando attualmente;
- abilitare/limitare le sezioni disponibili in base al tipo di company per la quale sta operando;
- risolvere permessi a livello di UI e routing perche un accesso avrà un determinato ruolo.
utils/
Utility e funzioni generiche riusabili.
variables/
Costanti e variabili globali (es. capienza standard di un bicchiere).
Aggiornare con cautela: usate trasversalmente.
🔎 Note operative
- Le sezioni sotto
dashboards/sono caricate in lazy loading e richiedono utente autenticato + company attiva. userAccessStore/è il punto unico di verità per permessi e contesto aziendale.- Le label di menu/pagine vanno mantenute in
translations/per garantire coerenza multilingua.