Getting started
Questa sezione è il punto di ingresso per orientarsi nella documentazione di People FE v2.
I documenti in questa cartella sono le reference per sviluppatori: setup, convenzioni e architettura del codice. Le guide funzionali per gli utenti dell'applicazione vivono nella sezione Funzionalità del sito MkDocs.
Come usare questa guida
- Parti da questa pagina per capire quali documenti aprire in base al tuo obiettivo.
- Per capire cosa fa ogni pagina dell'app, consulta Funzionalità.
- Per login e sessione, vedi Autenticazione SSO.
Reference sviluppo
| Documento | Quando consultarlo |
|---|---|
onboarding.md |
Primo accesso al progetto: prerequisiti, setup locale, struttura del codice, stack, ambienti, architettura, build e troubleshooting. |
components.md |
Navigazione rapida tra componenti del Design System (src/lib) e componenti business (src/components), con indicazione dei punti d'uso nel codice. |
ai-agents-and-skills.md |
Configurazione condivisa di agenti e skill AI (Cursor / Claude Code), symlink e convenzioni del repository. |
ai-agents-roadmap.md |
Roadmap dell'orchestrazione AI: stato attuale, priorità e backlog di miglioramenti. |
Reference funzionale e tecnica
| Documento | Quando consultarlo |
|---|---|
| Autenticazione SSO | Flusso SSO Google, JWT, guard, interceptor. |
| Funzionalità | Guide per area applicativa (People, Teams, Permessi, …). |
| Accesso e ruoli | Matrice ruoli, guard e visibilità sidebar. |
| Route e path | Mappa URL ↔ componenti. |
| Servizi e API | Servizi Angular e endpoint backend. |
Percorso suggerito per i nuovi contributor
onboarding.md— ambiente di lavoro e panoramica del codebase.- Autenticazione — se devi toccare login, sessione o permessi.
components.md— prima di aggiungere o modificare UI riutilizzabile.- Funzionalità — prima di modificare una pagina o un flusso utente.
ai-agents-and-skills.md— se lavori con agenti o skill nel repo.
Per qualsiasi dubbio su convenzioni di codice, controlla anche CLAUDE.md nella root del repository.