# Utenti, ruoli e accesso

## Opzioni di accesso

Tutti accedono da **/login** sull'indirizzo del tuo portale o dalla pagina di accesso della piattaforma. Il **nome breve dell'azienda è facoltativo**: lascialo vuoto e il sistema individua la tua azienda dalla tua email — ti viene chiesto solo se la stessa email (con la stessa password) appartiene a più aziende. Con una password errata il messaggio è semplicemente *Wrong email or password* (email o password errate), così nessuno può scoprire a quali aziende appartiene un'email.

- **Nome utente e password** — almeno 8 caratteri (le password comuni come 12345678 vengono rifiutate). Le password temporanee vanno cambiate al primo accesso. Dopo 6 tentativi falliti l'accesso viene sospeso per 15 minuti.
- **Continue with Google** — funziona se l'indirizzo email dell'utente in **Users & roles** corrisponde al suo account Google.
- **Continue with phone.codeb.io** — accedi con il tuo telefono; viene abbinato all'email o al numero di cellulare dell'utente.

![La pagina di accesso](/site/img/docs/d-login.webp "La pagina di accesso")

## Ruoli

| Ruolo | Cosa può fare |
|---|---|
| Owner | Tutto, inclusi utenti, chiavi API, audit trail e ruoli di owner |
| Manager | Tutto tranne utenti, chiavi API e audit trail: prenotazioni, pagamenti e depositi, strutture e guida, canali, impostazioni, report |
| Staff | Visualizzare e modificare le prenotazioni, visualizzare le strutture — niente pagamenti, impostazioni o report |
| Viewer | Sola lettura: prenotazioni, strutture e report |

I permessi esatti sono elencati in **Settings → Users & roles → Roles** (Impostazioni → Utenti e ruoli → Ruoli). Ogni tenant mantiene sempre almeno un owner attivo.

## Aggiungere un utente

1. **Settings → Users & roles → + Add user**.
2. Inserisci nome utente, nome, email (per Google) e cellulare (per phone.codeb.io), quindi scegli il ruolo.
3. Lascia vuota la password per generarne una temporanea. Viene mostrata una sola volta — comunicala in modo sicuro.

![Settings → Users & roles](/site/img/docs/d-settings-users.webp "Settings → Users & roles")

## Modificare, disattivare, rimuovere

Apri l'utente per cambiare ruolo o dati di contatto, usare **Reset password** (lo disconnette ovunque), spuntare **Disabled**, scollegare un'identità Google o phone.codeb.io, oppure rimuoverlo con **Remove**.

## Audit trail

**Settings → Audit trail** registra chi ha modificato impostazioni, utenti, prenotazioni e pagamenti, e quando.

![Settings → Audit trail](/site/img/docs/d-settings-audit.webp "Settings → Audit trail")

## Domande frequenti

### L'operatore della piattaforma può vedere il mio account?

Solo quando chiedi assistenza: l'operatore può aprire il tuo backend in una sessione di supporto, che viene registrata nel tuo audit trail.

### Ho dimenticato la password?

Chiedi a un owner del tuo account di eseguire **Reset password** per te. Gli owner possono rivolgersi all'operatore della piattaforma.