# JB3 - I livelli

# JB3.1 - Lettore, base, avanzato, staff

**In una frase.** I livelli sono quattro, hanno lo stesso nome e lo stesso significato in ogni servizio, e ognuno comprende quelli prima.

Con quattro livelli uguali ovunque non devi imparare un sistema di permessi per ogni programma. Se sai che una persona è «Utente base», sai già cosa può fare nelle stampe, nelle analisi e nell'ERP.

<table id="bkmrk-livello-in-breve-let"><thead><tr><th>Livello</th><th>In breve</th></tr></thead><tbody><tr><td>**Lettore**</td><td>Consulta e stampa. Non modifica</td></tr><tr><td>**Utente base**</td><td>Lavora e personalizza, per sé e per l'azienda</td></tr><tr><td>**Utente avanzato**</td><td>Disegna, pubblica e gestisce i ruoli del servizio</td></tr><tr><td>**Staff**</td><td>Personale Genesys: tutto, compresi i ruoli di sistema</td></tr></tbody></table>

**Come ricevi un livello.** Non ti viene assegnato a mano, uno per uno. Tu hai già dei ruoli nel gestionale, per esempio «amministrazione» o «magazzino». Arrivano insieme al tuo accesso. Ogni servizio guarda nella sua tabella che livello dà ciascun ruolo. Se ne hai più di uno, vale il livello più alto.

<div drawio-diagram="2643"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/dal-ruolo-al-livello-i-ruoli-del-gestionale-arrivano-con-laccesso-la-pagina-ruoli-e-permessi-dice-che-livello-danno-il-livello-d" alt="Dal ruolo al livello: i ruoli del gestionale arrivano con l&#039;accesso, la pagina Ruoli e permessi dice che livello danno, il livello decide cosa puoi fare"/></div>

*Dal ruolo al livello: i ruoli del gestionale arrivano con l'accesso, la pagina Ruoli e permessi dice che livello danno, il livello decide cosa puoi fare*

I quattro livelli esistono anche come ruoli già pronti, uguali in ogni servizio. Chi amministra può darli direttamente a una persona, senza passare da un ruolo del gestionale.

![L'elenco dei ruoli di un servizio: i quattro livelli già pronti, ognuno con la sua descrizione. Ambiente di prova](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/lelenco-dei-ruoli-di-un-servizio-i-quattro-livelli-gia-pronti-ognuno-con-la-sua-descrizione-ambiente-di-prova.png)

*L'elenco dei ruoli di un servizio: i quattro livelli già pronti, ognuno con la sua descrizione. Ambiente di prova*

**Lo Staff conta solo dove è acceso.** Negli ambienti Genesys la gestione staff è accesa e Staff è il livello più alto. Dal cliente è spenta: lì chi ha Staff vale come Utente avanzato, e la pagina lo dice con la nota «Staff vale come Utente avanzato».

**Il primo amministratore.** Chi ha nel gestionale il ruolo di amministratore entra sempre come Utente avanzato, anche con le tabelle vuote. È lui che configura gli altri.

<p class="callout info">**Nota.** I livelli sono provati con l'Accesso spento e il «Ruolo di prova». Con l'Accesso vero acceso sono ancora da provare dal vivo.</p>

<p class="callout info">**Per chi sviluppa.**  
• Nomi tecnici: `UTENTE_LETTORE`, `UTENTE_BASE`, `UTENTE_AVANZATO`, `STAFF`.  
• Lo Staff si accende con `RUOLI_STAFF_ABILITATO=true` (di serie è `false`).  
• Il ruolo amministratore è in `RUOLO_AMMINISTRATORE`; se manca vale `SBH_ADMIN_ROLE`, poi `SYSADMN`.  
• Regole in `RegoleRuoli` e `Livello`, file gemelli in `backend/middleware/it_gsba_gpe_next` e `backend/middleware/it_gsba_ade_next`. </p>

<p class="callout info">**Per approfondire.**  
• Ruoli e permessi: `docs/guide/amministrazione/ruoli-e-permessi/README.md`</p>

# JB3.2 - Cosa può fare ogni livello

**In una frase.** Ogni servizio dichiara cosa concede a ciascun livello, e te lo mostra in chiaro nella pagina Ruoli e permessi.

Non devi indovinare né chiedere a chi ha scritto il programma. Apri la scheda del servizio e leggi: una riga per ogni cosa che si può fare, una spunta sotto i livelli che la possono fare.

<div drawio-diagram="2645"><img src="https://gsdoc.genesyssoftware.eu/uploads/images/drawio/2026-11/i-quattro-livelli-in-fila-ognuno-aggiunge-qualcosa-al-precedente-sotto-un-esempio-con-le-stampe-e-con-le-analisi.png" alt="I quattro livelli in fila: ognuno aggiunge qualcosa al precedente. Sotto, un esempio con le stampe e con le analisi"/></div>

*I quattro livelli in fila: ognuno aggiunge qualcosa al precedente. Sotto, un esempio con le stampe e con le analisi*

Oggi i servizi concedono questo:

<table id="bkmrk-livello-stampe-%28gpen"><thead><tr><th>Livello</th><th>Stampe (GPEnext)</th><th>Analisi e disegno (ADEnext)</th></tr></thead><tbody><tr><td>**Lettore**</td><td>Stampa, anteprima, grafici</td><td>Apre i cruscotti</td></tr><tr><td>**Utente base**</td><td>In più: ritocca documenti, profili, aziende</td><td>In più: personalizza i cruscotti e salva le sue copie</td></tr><tr><td>**Utente avanzato**</td><td>In più: designer completo, gestione dei ruoli</td><td>In più: pubblica per tutti, usa lo Studio, gestisce i ruoli</td></tr><tr><td>**Staff**</td><td>In più: catalogo dei modelli, ruoli di sistema</td><td>In più: ruoli di sistema, concede lo Staff</td></tr></tbody></table>

Così lo mostra la pagina, nella scheda delle stampe:

![La scheda delle stampe in Ruoli e permessi: una riga per capacità, una spunta per ogni livello che la possiede. Ambiente di prova](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/la-scheda-delle-stampe-in-ruoli-e-permessi-una-riga-per-capacita-una-spunta-per-ogni-livello-che-la-possiede-ambiente-di-prova.)

*La scheda delle stampe in Ruoli e permessi: una riga per capacità, una spunta per ogni livello che la possiede. Ambiente di prova*

**In SIGEAnext** oggi i livelli proteggono due cose: la configurazione dei moduli e la scelta dei ruoli, tutte e due da Utente avanzato. Le altre funzioni dell'ERP chiedono solo di essere entrati. Il Lettore in sola lettura modulo per modulo è ancora da fare.

**Se non hai il livello che serve**, il pulsante è spento e il suggerimento dice perché. Se la richiesta parte lo stesso, il servizio la rifiuta e spiega il motivo.

<p class="callout info">**Nota.** «Pubblica per tutti» nelle analisi chiede anche un'opzione accesa sull'installazione. Vedi il libro JF - Analytics, capitolo «JF5 - Salvare e condividere».</p>

<p class="callout info">**Per chi sviluppa.**  
• Ogni servizio elenca le sue capacità in `CapacitaServizio`: codice, descrizione, livello minimo.  
• Le autorizzazioni passano dalle capacità, mai da nomi di ruolo scritti nel codice.  
• Le API dello Studio che chiedono la capacità `studio`: `docs/low-code/permessi-api.md`.  
• La pagina legge `GET /ruoli/livelli` e `GET /me/permessi` di ogni servizio. </p>

<p class="callout info">**Per approfondire.**  
• Ruoli e permessi: `docs/guide/amministrazione/ruoli-e-permessi/README.md`</p>

# JB3.3 - Assegnare un ruolo

**In una frase.** Per dare un livello a un gruppo di persone, agganci un loro ruolo del gestionale a uno dei quattro livelli.

Non si lavora utente per utente. Dici una volta sola «chi ha il ruolo amministrazione è Utente base nelle stampe», e vale per tutti quelli che hanno quel ruolo, anche per chi arriverà dopo.

1. **Apri Ruoli e permessi.** Dal modulo **EE0 Gestione Servizi**, **Impostazioni**, **Utenti e accessi**, **Ruoli e permessi**. Oppure dal menu utente, in alto a destra.
2. **Scegli la scheda del servizio.** Una scheda per servizio. I ruoli della scheda di ADEnext valgono anche per SIGEAnext, con lo stesso livello.
3. **Premi Nuovo ruolo.** Con **Scegli fra i ruoli di Keycloak** cerchi fra i ruoli che esistono davvero, compresi quelli arrivati dal gestionale: il nome si scrive da solo, senza errori di battitura. Puoi anche scriverlo a mano.
4. **Scegli il livello e premi Salva.**
    
    ![Il riquadro Nuovo ruolo: il nome del ruolo e il livello da dare. Schermata di una versione precedente: oggi c'è anche il pulsante per scegliere il ruolo da un elenco](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-riquadro-nuovo-ruolo-il-nome-del-ruolo-e-il-livello-da-dare-schermata-di-una-versione-precedente-oggi-ce-anche-il-pulsante-p)
    
    *Il riquadro Nuovo ruolo: il nome del ruolo e il livello da dare. Schermata di una versione precedente: oggi c'è anche il pulsante per scegliere il ruolo da un elenco*
5. **Controlla.** La riga compare nell'elenco. Chi ha quel ruolo ha il livello nuovo dalla richiesta successiva: non serve uscire e rientrare.

Per cambiare un aggancio premi la matita sulla riga. Il cestino lo toglie, dopo una conferma.

**Chi può farlo.** Serve il livello Utente avanzato nel servizio. Solo lo Staff può concedere il livello Staff e toccare i quattro ruoli già pronti. Utente base e Lettore vedono l'elenco senza poterlo cambiare.

<p class="callout info">**Nota.** Lo stesso ruolo può dare livelli diversi in servizi diversi: per esempio Utente avanzato nelle analisi e Lettore nelle stampe.</p>

<p class="callout warning">**Attenzione.** Se l'elenco dei ruoli non si apre, al posto del pulsante compare un avviso con il motivo e **Riprova**. Intanto puoi scegliere fra i ruoli del gestionale o scrivere il nome a mano.</p>

<p class="callout info">**Per chi sviluppa.**  
• Pagina: `frontend/shell/src/pages/ruoli`, indirizzo `/pages/ruoli`.  
• Ogni servizio tiene i suoi agganci in una tabella `ruoli`; SIGEAnext legge quelli di ADEnext.  
• Nome del ruolo: lettere, cifre, `_`, `.`, `-`, al massimo 64 caratteri. Maiuscole e minuscole non contano. </p>

<p class="callout info">**Per approfondire.**  
• Ruoli e permessi: `docs/guide/amministrazione/ruoli-e-permessi/README.md`</p>

# JB3.4 - Il ruolo di prova

**In una frase.** Negli ambienti di prova, dove l'Accesso è spento, un selettore ti fa vedere l'applicazione come la vedrebbe chi ha un certo ruolo.

Serve a chi configura i permessi e a chi sviluppa. Prima di dare un ruolo a venti persone, controlli in un minuto cosa vedranno: quali pulsanti sono accesi, quali pagine si aprono, cosa viene rifiutato. Senza creare utenti finti.

1. **Guarda la barra in alto.** Con l'Accesso spento c'è il selettore **Ruolo di prova**. Parte da **Tutti i permessi (sviluppo)**: puoi fare tutto.
2. **Scegli un ruolo.** L'elenco contiene i ruoli di tutti i servizi. Accanto a ognuno c'è scritto quali servizi lo conoscono.
    
    ![Il selettore Ruolo di prova aperto: i quattro livelli e, per ciascuno, i servizi che lo conoscono. Ambiente di sviluppo](https://gsdoc.genesyssoftware.eu/uploads/images/gallery/2026-11/il-selettore-ruolo-di-prova-aperto-i-quattro-livelli-e-per-ciascuno-i-servizi-che-lo-conoscono-ambiente-di-sviluppo.png)
    
    *Il selettore Ruolo di prova aperto: i quattro livelli e, per ciascuno, i servizi che lo conoscono. Ambiente di sviluppo*
3. **Prova.** La pagina si ricarica. Da quel momento ogni servizio si comporta come per un utente con quel ruolo. Apri una stampa, un cruscotto, la pagina Ruoli e permessi: vedi cosa cambia.
4. **Torna indietro.** Scegli di nuovo **Tutti i permessi (sviluppo)**.

**Dal cliente non c'è.** Con l'Accesso acceso il selettore non compare e il Gateway scarta qualunque richiesta che provi a usarlo. Nessuno può fingersi un altro ruolo: valgono solo i ruoli veri, quelli che arrivano con l'accesso.

<p class="callout info">**Nota.** Per provare un ruolo che non è ancora agganciato, prima aggiungilo in **Ruoli e permessi** con il livello che vuoi dare. Poi lo trovi nel selettore.</p>

<p class="callout info">**Per chi sviluppa.**  
• La scelta viaggia nell'intestazione `X-Dev-Roles`. Il Gateway la lascia passare solo con `AUTH_ENABLED=false`.  
• Con l'Accesso spento e nessun ruolo scelto, i servizi danno il livello Staff.  
• Selettore: `frontend/shell/src/layout/components/ruolo-prova-select.ts`. Elenco dei servizi: `SERVIZI_CON_RUOLI` in `frontend/shell/src/shared/auth/ruolo-prova.ts`. </p>

<p class="callout info">**Per approfondire.**  
• Ruoli e permessi: `docs/guide/amministrazione/ruoli-e-permessi/README.md`</p>