Como Configurar Funções e Permissões de Caixa

Este guia aborda a criação de contas de caixa, a definição de funções personalizadas com permissões detalhadas e a atribuição dessas funções ao seu pessoal. Funções devidamente configuradas garantem que cada membro da equipe possa acessar apenas os recursos necessários para seu trabalho.

O Que Você Vai Precisar

• Acesso de administrador ao Servidor HandyCafe (apenas administradores podem gerenciar contas e funções de caixa).
• Um plano para determinar quais membros da equipe precisam de qual nível de acesso.
• Pelo menos uma função definida antes de criar contas de caixa (as funções devem existir para serem atribuídas).

Como Criar uma Função Personalizada

As funções definem o que um caixa pode ou não fazer. O HandyCafe utiliza seis categorias de permissão, cada uma com configurações individuais. Crie suas funções primeiro e depois atribua-as às contas de caixa.

1. Navegue até a seção Gerenciamento usando a barra lateral esquerda.
2. Abra a aba Funções de Caixa.
3. Clique em Adicionar Função.
4. Insira um nome para a função (por exemplo, "Caixa Turno Diurno"). Os nomes das funções devem ser únicos.
5. Defina o nível. Níveis mais altos indicam mais autoridade. Um caixa com uma função de nível inferior não pode modificar um caixa com uma função de nível superior.
6. Configure as permissões de Autenticação. Estas controlam ações relacionadas ao login:
   • Capacidade de login/logout.
   • Capacidade de redefinir senha.
7. Configure as permissões de Membro. Estas controlam o que o caixa pode fazer com contas de membros:
   • Visualizar membros.
   • Criar membros.
   • Editar membros.
   • Excluir membros.
   • Recarregar carteiras.
   • Visualizar histórico de transações.
8. Configure as permissões de Console. Estas controlam ações de sessão e console:
   • Iniciar e parar sessões.
   • Pausar e retomar sessões.
   • Adicionar tempo.
   • Visualizar lista de consoles.
9. Configure as permissões de Log. Estas controlam o acesso aos logs do sistema:
   • Visualizar logs (apenas hoje ou todas as datas).
   • Exportar logs.
10. Configure as permissões de Relatório. Estas controlam o acesso a relatórios financeiros:
    • Visualizar relatórios de caixa (apenas hoje ou todas as datas).
    • Visualizar estatísticas.
    • Exportar relatórios.
11. Configure as permissões de Pagamento. Estas controlam ações relacionadas a pagamentos:
    • Aceitar pagamentos.
    • Processar reembolsos.
    • Modificar métodos de pagamento.
    • Visualizar histórico de pagamentos.
12. Clique em Salvar para criar a função.

Resultado esperado: A nova função aparece na lista de Funções de Caixa com todas as permissões configuradas. Agora está disponível para atribuição às contas de caixa.

Exemplo Prático: Função de Caixa Turno Diurno

Este exemplo cria uma função restrita adequada para um caixa regular trabalhando em um turno diurno.

1. Navegue até Gerenciamento > Funções de Caixa.
2. Clique em Adicionar Função.
3. Nome: "Caixa Turno Diurno".
4. Nível: 1 (nível mais baixo).
5. Permissões de Autenticação: Habilitar login. Desabilitar redefinição de senha.
6. Permissões de Membro:
   • Habilitar: Visualizar membros, Criar membros, Recarregar carteiras, Visualizar histórico de transações.
   • Desabilitar: Editar membros, Excluir membros.
7. Permissões de Console:
   • Habilitar: Iniciar sessões, Parar sessões, Pausar sessões, Retomar sessões, Adicionar tempo.
   • Desabilitar: (nenhuma; caixas de turno diurno precisam de controle total de sessão).
8. Permissões de Log:
   • Habilitar: Visualizar logs (apenas hoje).
   • Desabilitar: Visualizar todos os logs, Exportar logs.
9. Permissões de Relatório:
   • Habilitar: Visualizar relatório de caixa (apenas hoje).
   • Desabilitar: Visualizar todos os relatórios, Visualizar estatísticas, Exportar relatórios.
10. Permissões de Pagamento:
    • Habilitar: Aceitar pagamentos, Visualizar histórico de pagamentos.
    • Desabilitar: Processar reembolsos, Modificar métodos de pagamento.
11. Clique em Salvar.

Resultado esperado: A função "Caixa Turno Diurno" pode iniciar e gerenciar sessões, criar membros, recarregar carteiras, visualizar logs e relatórios de hoje, e aceitar pagamentos. Não pode excluir membros, modificar métodos de pagamento, processar reembolsos ou visualizar relatórios históricos além de hoje.

Exemplo Prático: Função de Gerente

Este exemplo cria uma função com acesso mais amplo para um gerente de turno de confiança.

1. Navegue até Gerenciamento > Funções de Caixa.
2. Clique em Adicionar Função.
3. Nome: "Gerente de Turno".
4. Nível: 5 (mais alto que Caixa Turno Diurno).
5. Permissões de Autenticação: Habilitar todas.
6. Permissões de Membro: Habilitar todas (Visualizar, Criar, Editar, Excluir, Recarregar, Histórico).
7. Permissões de Console: Habilitar todas.
8. Permissões de Log: Habilitar todas (Visualizar todos os logs, Exportar logs).
9. Permissões de Relatório: Habilitar todas (Visualizar todos os relatórios, Estatísticas, Exportar).
10. Permissões de Pagamento:
    • Habilitar: Aceitar pagamentos, Processar reembolsos, Visualizar histórico de pagamentos.
    • Desabilitar: Modificar métodos de pagamento (reservar isso para o administrador/proprietário).
11. Clique em Salvar.

Resultado esperado: A função "Gerente de Turno" tem acesso quase total. A única restrição é que não pode modificar métodos de pagamento, o que é tipicamente uma alteração de configuração em nível de proprietário.

Como Criar uma Conta de Caixa

1. Navegue até a seção Gerenciamento.
2. Abra a aba Caixas.
3. Clique em Adicionar para criar um novo caixa.
4. Insira um nome de usuário. Este é o nome que o caixa digitará para fazer login. Deve ser único.
5. Insira uma senha. Use uma senha forte. O caixa pode alterá-la posteriormente.
6. Selecione uma função no menu suspenso. Apenas funções que você já criou aparecerão.
7. Opcionalmente, preencha nome completo, email e celular para registro.
8. Clique em Salvar.

Resultado esperado: A nova conta de caixa aparece na lista de Caixas. O caixa agora pode fazer login no Servidor HandyCafe usando seu nome de usuário e senha. Seu acesso é restrito às permissões definidas pela função atribuída.

Como Alterar a Função de um Caixa

1. Navegue até Gerenciamento > Caixas.
2. Selecione o caixa cuja função você deseja alterar.
3. No painel de detalhes do caixa, clique no menu suspenso Função e selecione uma função diferente.
4. Clique em Salvar.

Resultado esperado: As permissões do caixa mudam imediatamente. Na próxima vez que realizarem uma ação, o sistema verificará contra sua nova função. Não precisam fazer logout e login novamente para que a alteração tenha efeito.

Como Restringir um Caixa a Apenas Relatórios de Hoje

Esta é uma exigência comum: você quer que os caixas vejam os números do turno atual, mas não dados históricos.

1. Abra a função atribuída ao caixa (Gerenciamento > Funções de Caixa).
2. Na seção de permissões de Relatório:
   • Habilitar "Visualizar relatório de caixa (apenas hoje)."
   • Desabilitar "Visualizar todos os relatórios."
   • Desabilitar "Visualizar estatísticas."
   • Desabilitar "Exportar relatórios."
3. Na seção de permissões de Log:
   • Habilitar "Visualizar logs (apenas hoje)."
   • Desabilitar "Visualizar todos os logs."
   • Desabilitar "Exportar logs."
4. Clique em Salvar.

Resultado esperado: O caixa pode visualizar a página de Relatório de Caixa, mas só vê dados do dia atual. O seletor de datas (se visível) está bloqueado para hoje. A página de Estatísticas e os botões de exportação estão ocultos ou desabilitados para este caixa.

Como Desativar uma Conta de Caixa

Quando um membro da equipe sai, desative sua conta em vez de excluí-la. Isso preserva o histórico de auditoria.

1. Navegue até Gerenciamento > Caixas.
2. Selecione o caixa a ser desativado.
3. Desative o interruptor Ativo (ou clique em Desativar).
4. Clique em Salvar.

Resultado esperado: O caixa não pode mais fazer login. Todas as suas ações históricas (sessões iniciadas, transações registradas, logs) permanecem no sistema. A conta pode ser reativada mais tarde, se necessário.

Erros Comuns a Evitar

• Atribuir a função errada. Sempre verifique duas vezes o menu suspenso de função ao criar um caixa. Um caixa com a função de Gerente tem muito mais acesso do que o pretendido para um trabalhador de turno regular.
• Não testar a função após a criação. Faça login como o caixa (ou use uma conta de teste com a função) e verifique se os recursos restritos estão realmente ocultos ou desabilitados. Não confie apenas nas caixas de seleção de permissões.
• Esquecer que as funções são aplicadas no backend. Mesmo que um elemento da interface esteja visível, o backend rejeitará ações não autorizadas com base nas configurações de permissão da função. No entanto, para uma experiência de usuário limpa, a interface também deve ocultar recursos não autorizados.
• Definir todas as funções para o nível 0. O nível determina a hierarquia. Se o nível de uma função for inferior a outra, o caixa de nível inferior não pode editar o caixa de nível superior. Planeje seus níveis: 1 para caixas básicos, 5 para gerentes, 10 para gerentes seniores.
• Compartilhar contas de caixa. Cada membro da equipe deve ter sua própria conta. Contas compartilhadas tornam impossível rastrear quem realizou uma ação específica nos logs.
• Excluir uma conta de caixa em vez de desativar. A exclusão remove a referência do caixa de transações e logs (definida como NULL). Sempre desative em vez de excluir para preservar o histórico de auditoria.
• Deixar permissões de método de pagamento padrão habilitadas. A maioria dos caixas não deve poder adicionar ou remover métodos de pagamento. Esta é uma alteração de configuração que deve ser restrita a proprietários ou administradores.