HandyCafe Docs
owner

Come Configurare Ruoli e Permessi dei Cassieri

Questa guida tratta la creazione di account cassiere, la definizione di ruoli personalizzati con permessi granulari e l'assegnazione di tali ruoli al personale. Ruoli configurati correttamente garantiscono che ogni membro del personale possa accedere solo alle funzionalita necessarie per il proprio lavoro.

Cosa Ti Servira

  • Accesso amministratore a HandyCafe Server (solo gli amministratori possono gestire gli account e i ruoli dei cassieri).
  • Un piano su quali membri del personale hanno bisogno di quale livello di accesso.
  • Almeno un ruolo definito prima di creare gli account cassiere (i ruoli devono esistere per essere assegnati).

Come Creare un Ruolo Personalizzato

I ruoli definiscono cosa un cassiere puo e non puo fare. HandyCafe usa sei categorie di permessi, ognuna con impostazioni individuali. Crea prima i tuoi ruoli, poi assegnali agli account cassiere.

  1. Vai alla sezione Gestione tramite la barra laterale sinistra.
  2. Apri la scheda Ruoli Cassieri.
  3. Clicca Aggiungi Ruolo.
  4. Inserisci un nome per il ruolo (ad es. "Cassiere Turno Diurno"). I nomi dei ruoli devono essere univoci.
  5. Imposta il livello. Livelli piu alti indicano maggiore autorita. Un cassiere con un ruolo di livello inferiore non puo modificare un cassiere con un ruolo di livello superiore.
  6. Configura i permessi Autenticazione. Controllano le azioni correlate all'accesso:
    • Possibilita di login/logout.
    • Possibilita di reimpostazione della password.
  7. Configura i permessi Membro. Controllano cosa il cassiere puo fare con gli account membro:
    • Visualizzare i membri.
    • Creare membri.
    • Modificare i membri.
    • Eliminare i membri.
    • Ricaricare portafogli.
    • Visualizzare la cronologia delle transazioni.
  8. Configura i permessi Console. Controllano le azioni di sessione e console:
    • Avviare e terminare le sessioni.
    • Mettere in pausa e riprendere le sessioni.
    • Aggiungere tempo.
    • Visualizzare l'elenco console.
  9. Configura i permessi Log. Controllano l'accesso ai log di sistema:
    • Visualizzare i log (solo oggi o tutte le date).
    • Esportare i log.
  10. Configura i permessi Report. Controllano l'accesso ai report finanziari:
    • Visualizzare i report di cassa (solo oggi o tutte le date).
    • Visualizzare le statistiche.
    • Esportare i report.
  11. Configura i permessi Pagamento. Controllano le azioni correlate ai pagamenti:
    • Accettare i pagamenti.
    • Elaborare i rimborsi.
    • Modificare i metodi di pagamento.
    • Visualizzare la cronologia dei pagamenti.
  12. Clicca Salva per creare il ruolo.

Risultato atteso: Il nuovo ruolo compare nell'elenco dei Ruoli Cassieri con tutti i permessi configurati. E ora disponibile per l'assegnazione agli account cassiere.

Esempio Pratico: Ruolo Cassiere Turno Diurno

Questo esempio crea un ruolo limitato adatto a un cassiere normale che lavora in un turno diurno.

  1. Vai su Gestione > Ruoli Cassieri.
  2. Clicca Aggiungi Ruolo.
  3. Nome: "Cassiere Turno Diurno".
  4. Livello: 1 (livello piu basso).
  5. Permessi Autenticazione: Abilita login. Disabilita reimpostazione password.
  6. Permessi Membro:
    • Abilita: Visualizza membri, Crea membri, Ricarica portafogli, Visualizza cronologia transazioni.
    • Disabilita: Modifica membri, Elimina membri.
  7. Permessi Console:
    • Abilita: Avvia sessioni, Termina sessioni, Metti in pausa sessioni, Riprendi sessioni, Aggiungi tempo.
    • Disabilita: (nessuno; i cassieri del turno diurno hanno bisogno del controllo completo delle sessioni).
  8. Permessi Log:
    • Abilita: Visualizza log (solo oggi).
    • Disabilita: Visualizza tutti i log, Esporta log.
  9. Permessi Report:
    • Abilita: Visualizza report di cassa (solo oggi).
    • Disabilita: Visualizza tutti i report, Visualizza statistiche, Esporta report.
  10. Permessi Pagamento:
    • Abilita: Accetta pagamenti, Visualizza cronologia pagamenti.
    • Disabilita: Elabora rimborsi, Modifica metodi di pagamento.
  11. Clicca Salva.

Risultato atteso: Il ruolo "Cassiere Turno Diurno" puo avviare e gestire sessioni, creare membri, ricaricare portafogli, visualizzare i log e i report di oggi e accettare pagamenti. Non puo eliminare membri, modificare i metodi di pagamento, elaborare rimborsi o visualizzare report storici oltre a oggi.

Esempio Pratico: Ruolo Manager

Questo esempio crea un ruolo con accesso piu ampio per un responsabile di turno di fiducia.

  1. Vai su Gestione > Ruoli Cassieri.
  2. Clicca Aggiungi Ruolo.
  3. Nome: "Responsabile Turno".
  4. Livello: 5 (piu alto del Cassiere Turno Diurno).
  5. Permessi Autenticazione: Abilita tutti.
  6. Permessi Membro: Abilita tutti (Visualizza, Crea, Modifica, Elimina, Ricarica, Cronologia).
  7. Permessi Console: Abilita tutti.
  8. Permessi Log: Abilita tutti (Visualizza tutti i log, Esporta log).
  9. Permessi Report: Abilita tutti (Visualizza tutti i report, Statistiche, Esporta).
  10. Permessi Pagamento:
    • Abilita: Accetta pagamenti, Elabora rimborsi, Visualizza cronologia pagamenti.
    • Disabilita: Modifica metodi di pagamento (riserva questo per l'amministratore/proprietario).
  11. Clicca Salva.

Risultato atteso: Il ruolo "Responsabile Turno" ha accesso quasi completo. L'unica restrizione e che non puo modificare i metodi di pagamento, che e tipicamente una modifica di configurazione a livello di proprietario.

Come Creare un Account Cassiere

  1. Vai alla sezione Gestione.
  2. Apri la scheda Cassieri.
  3. Clicca Aggiungi per creare un nuovo cassiere.
  4. Inserisci un nome utente. Questo e quello che il cassiere digitera per accedere. Deve essere univoco.
  5. Inserisci una password. Usa una password robusta. Il cassiere potra cambiarla in seguito.
  6. Seleziona un ruolo dal menu a tendina. Compariranno solo i ruoli gia creati.
  7. Facoltativamente, compila nome completo, email e cellulare per i registri.
  8. Clicca Salva.

Risultato atteso: Il nuovo account cassiere compare nell'elenco dei Cassieri. Il cassiere puo ora accedere a HandyCafe Server usando il suo nome utente e la sua password. Il suo accesso e limitato ai permessi definiti dal ruolo assegnato.

Come Cambiare il Ruolo di un Cassiere

  1. Vai su Gestione > Cassieri.
  2. Seleziona il cassiere di cui vuoi cambiare il ruolo.
  3. Nel pannello dei dettagli del cassiere, clicca il menu a tendina Ruolo e seleziona un ruolo diverso.
  4. Clicca Salva.

Risultato atteso: I permessi del cassiere cambiano immediatamente. La prossima volta che eseguira un'azione, il sistema verifichera in base al suo nuovo ruolo. Non e necessario che si disconnetta e riconnetta per far entrare in vigore il cambiamento.

Come Limitare un Cassiere ai Report Solo di Oggi

Questo e un requisito comune: vuoi che i cassieri vedano i numeri del turno corrente ma non i dati storici.

  1. Apri il ruolo assegnato al cassiere (Gestione > Ruoli Cassieri).
  2. Nella sezione dei permessi Report:
    • Abilita "Visualizza report di cassa (solo oggi)".
    • Disabilita "Visualizza tutti i report".
    • Disabilita "Visualizza statistiche".
    • Disabilita "Esporta report".
  3. Nella sezione dei permessi Log:
    • Abilita "Visualizza log (solo oggi)".
    • Disabilita "Visualizza tutti i log".
    • Disabilita "Esporta log".
  4. Clicca Salva.

Risultato atteso: Il cassiere puo visualizzare la pagina Report di Cassa ma vede solo i dati del giorno corrente. Il selettore di date (se visibile) e bloccato su oggi. La pagina Statistiche e i pulsanti di esportazione sono nascosti o disabilitati per questo cassiere.

Come Disattivare un Account Cassiere

Quando un membro del personale se ne va, disattiva il suo account invece di eliminarlo. Questo preserva la traccia di audit.

  1. Vai su Gestione > Cassieri.
  2. Seleziona il cassiere da disattivare.
  3. Imposta l'interruttore Attivo su disattivato (o clicca Disattiva).
  4. Clicca Salva.

Risultato atteso: Il cassiere non puo piu accedere. Tutte le sue azioni storiche (sessioni avviate, transazioni registrate, log) rimangono nel sistema. L'account puo essere riattivato in seguito se necessario.

Errori Comuni da Evitare

  • Assegnare il ruolo sbagliato. Verifica sempre il menu a tendina del ruolo quando crei un cassiere. Un cassiere con un ruolo da Manager ha molto piu accesso di quanto previsto per un normale lavoratore del turno.
  • Non testare il ruolo dopo la creazione. Accedi come il cassiere (o usa un account di test con il ruolo) e verifica che le funzionalita limitate siano effettivamente nascoste o disabilitate. Non fare affidamento solo sulle caselle di controllo dei permessi.
  • Dimenticare che i ruoli vengono applicati nel backend. Anche se un elemento dell'interfaccia e visibile, il backend rifiutera le azioni non autorizzate in base alle impostazioni dei permessi del ruolo. Tuttavia, per un'esperienza utente pulita, l'interfaccia dovrebbe anche nascondere le funzionalita non autorizzate.
  • Impostare tutti i ruoli al livello 0. Il livello determina la gerarchia. Se il livello di un ruolo e inferiore a un altro, il cassiere di livello inferiore non puo modificare il cassiere di livello superiore. Pianifica i tuoi livelli: 1 per i cassieri base, 5 per i responsabili, 10 per i responsabili senior.
  • Condividere gli account cassiere. Ogni membro del personale dovrebbe avere il proprio account. Gli account condivisi rendono impossibile tracciare chi ha eseguito una specifica azione nei log.
  • Eliminare un account cassiere invece di disattivarlo. L'eliminazione rimuove il riferimento al cassiere dalle transazioni e dai log (impostato a NULL). Disattiva sempre invece di eliminare per preservare la traccia di audit.
  • Lasciare abilitati i permessi predefiniti per i metodi di pagamento. La maggior parte dei cassieri non dovrebbe poter aggiungere o rimuovere metodi di pagamento. Questa e una modifica di configurazione che dovrebbe essere riservata ai proprietari o agli amministratori.