HandyCafe Docs
owner cashier

Como Gerenciar Membros

Este guia cobre a criação de contas de membros, gerenciamento de saldos de carteiras, atribuição de níveis de fidelidade e concessão de tempo grátis. Membros são clientes registrados que podem fazer login a partir dos PCs clientes, manter um saldo de carteira e acumular pontos de fidelidade.

O Que Você Vai Precisar

  • Acesso de administrador ou caixa ao HandyCafe Server.
  • A página de Membros acessível na barra lateral esquerda.
  • Pelo menos um método de pagamento configurado se você planeja aceitar recargas de carteira.

Como Criar um Novo Membro

  1. Navegue até a página de Membros usando a barra lateral esquerda.
  2. Clique no botão Adicionar na barra de ferramentas.
  3. Insira o nome de usuário do membro. Este deve ser único entre todos os membros (não diferencia maiúsculas de minúsculas). O membro usará isso para fazer login a partir dos PCs clientes.
  4. Insira um nome de exibição. Este é o nome mostrado na tela durante as sessões e nos relatórios.
  5. Opcionalmente, preencha email, número de telefone e gênero.
  6. Defina o número máximo de conexões simultâneas. Isso controla quantos PCs o membro pode estar logado ao mesmo tempo. O padrão é 1.
  7. Clique em Salvar para criar o membro.

Resultado esperado: O novo membro aparece na lista de membros. O saldo da carteira começa em zero. Eles agora podem fazer login de qualquer PC cliente usando seu nome de usuário.

Nota: Uma senha não é necessária no momento da criação. O membro pode definir sua própria senha a partir do Painel do Membro no PC cliente no primeiro login. Alternativamente, um administrador pode defini-la a partir do servidor.


Como Adicionar Saldo à Carteira de um Membro

A carteira é um saldo pré-pago armazenado em unidades menores da moeda. Os membros podem usar sua carteira para pagar por sessões e pedidos sem entregar dinheiro ao caixa.

  1. Navegue até a página de Membros.
  2. Encontre e selecione o membro que você deseja adicionar saldo. Use a barra de pesquisa se a lista for longa.
  3. Clique no botão Adicionar Saldo ou de pagamento no painel de detalhes do membro.
  4. Insira o valor a ser adicionado à carteira. Este é na sua moeda base (por exemplo, 50,00 para adicionar cinquenta unidades).
  5. Selecione o tipo de crédito:
    • Pago para recargas em dinheiro ou cartão onde o dinheiro foi recebido.
    • Bônus para crédito promocional.
    • Manual para correções administrativas.
  6. Selecione o método de pagamento (Dinheiro, Cartão, etc.). Isso registra como o dinheiro foi recebido.
  7. Clique em Confirmar.

Resultado esperado: Um novo crédito de carteira é criado para o membro. O crédito registra o valor, tipo de crédito e método de pagamento. O saldo total da carteira do membro é atualizado imediatamente. O crédito da carteira aparece no histórico de transações do membro.

Dica: Cada recarga cria uma entrada de crédito de carteira separada. Quando o membro gasta de sua carteira, o sistema consome do crédito ativo mais antigo primeiro (FIFO). Créditos de bônus e pagos são rastreados separadamente.


Como Atribuir um Nível de Fidelidade

Os níveis de fidelidade permitem agrupar membros por nível de gasto e aplicar descontos automáticos.

Criar um Nível

  1. Navegue até a página de Membros.
  2. Abra a seção de gerenciamento de Níveis (acessível na barra de ferramentas de membros ou configurações).
  3. Clique em Adicionar Nível.
  4. Insira um código (por exemplo, "prata"). Este deve ser único.
  5. Insira um nome de exibição (por exemplo, "Membro Prata").
  6. Defina os pontos de limiar. Um membro deve acumular pelo menos essa quantidade de pontos de fidelidade para se qualificar para este nível.
  7. Defina a taxa de desconto. Insira o desconto como uma porcentagem. Por exemplo, 5 significa um desconto de 5% nas sessões.
  8. Clique em Salvar.
  9. Repita para níveis adicionais (por exemplo, Ouro com 1000 pontos e um desconto de 10%).

Atribuir um Nível a um Membro

  1. Navegue até a página de Membros.
  2. Selecione o membro da lista.
  3. No painel de detalhes do membro, localize o campo Nível.
  4. Selecione o nível desejado no menu suspenso.
  5. Clique em Salvar.

Resultado esperado: O membro agora possui o nível selecionado. Quando as sessões deste membro forem cobradas, o desconto do nível será considerado no cálculo do custo. O perfil do membro mostra seu nível atribuído.


Como Ver o Histórico de Transações de um Membro

O histórico de transações mostra todas as recargas de carteira, gastos de carteira, pagamentos de sessões, reembolsos e eventos de pontos de fidelidade para um membro específico.

  1. Navegue até a página de Membros.
  2. Selecione o membro da lista.
  3. Abra o painel de detalhes do membro.
  4. Navegue até a guia Histórico ou Transações dentro do painel de detalhes.
  5. A lista mostra todas as transações em ordem cronológica inversa com:
    • Data e hora.
    • Tipo de transação (recarga de carteira, gasto de carteira, sessão, reembolso, etc.).
    • Valor (positivo para recargas, negativo para gastos).
    • Fonte ou contexto (qual sessão ou pedido consumiu os fundos).
    • Caixa que realizou a ação.

Resultado esperado: Um registro completo de todas as atividades financeiras do membro. Você pode rolar ou filtrar por intervalo de datas para encontrar transações específicas.


Como Dar Tempo Grátis a um Membro

Você pode adicionar um crédito de tempo à conta de um membro. Créditos de tempo funcionam como crédito de carteira, mas em minutos em vez de dinheiro. Quando o membro inicia uma sessão, o sistema pode deduzir de seu saldo de tempo.

  1. Navegue até a página de Membros.
  2. Selecione o membro da lista.
  3. No painel de detalhes do membro, localize a seção Pacotes de Tempo ou Créditos de Tempo.
  4. Clique em Adicionar Tempo.
  5. Insira o número de minutos a adicionar (por exemplo, 120 para duas horas de tempo grátis).
  6. Selecione o tipo de crédito:
    • Manual para tempo cortesia dado pelo café.
    • Bônus para tempo promocional de uma campanha.
    • Pago para tempo comprado através de um pacote.
  7. Opcionalmente, defina uma restrição de dispositivo (apenas PCs, apenas Consoles ou Ambos) para restringir onde o tempo pode ser usado.
  8. Opcionalmente, defina uma data de expiração após a qual o tempo não utilizado expira.
  9. Clique em Confirmar.

Resultado esperado: Um novo crédito de tempo aparece na conta do membro com os minutos especificados. O saldo de tempo disponível do membro é atualizado. Quando o membro inicia uma sessão, o sistema oferecerá deduzir de seu saldo de tempo.


Como Verificar o Saldo de um Membro

Consulta rápida de saldo sem abrir o histórico completo de transações.

  1. Navegue até a página de Membros.
  2. Use a barra de pesquisa no topo para digitar o nome de usuário ou nome de exibição do membro.
  3. Selecione o membro dos resultados filtrados.
  4. O painel de detalhes do membro mostra o saldo da carteira atual (na sua moeda base) e o saldo de tempo (em minutos) no topo do painel.

Resultado esperado: Você vê o saldo atual da carteira e do tempo do membro de relance. Esses valores refletem todas as recargas, gastos e expirações até o momento atual.


Como Lidar com Dívidas de Membros

Se um membro for permitido ter um saldo negativo (dívida), o livro de dívidas rastreia quanto ele deve.

  1. Navegue até a página de Membros.
  2. Selecione o membro que tem dívida pendente.
  3. Abra o painel de detalhes e verifique a seção Dívida.
  4. O livro de dívidas mostra entradas individuais de dívida com valores e datas.
  5. Para liquidar a dívida, recarregue a carteira do membro com o valor devido. Selecione "Pago" como o tipo de fonte para que o pagamento seja registrado corretamente.

Resultado esperado: A recarga da carteira compensa a dívida. O livro de dívidas mostra a entrada de liquidação. O saldo líquido do membro retorna a zero ou positivo.


Erros Comuns a Evitar

  • Criar nomes de usuário duplicados. Nomes de usuário são únicos e não diferenciam maiúsculas de minúsculas. "JohnDoe" e "johndoe" são considerados iguais. O sistema rejeitará duplicatas.
  • Confundir saldo de carteira e saldo de tempo. Carteira é dinheiro (unidades menores da moeda). Tempo é minutos. Eles são sistemas separados. Um membro pode ter crédito na carteira, mas não crédito de tempo, ou vice-versa.
  • Definir conexões máximas muito altas. Se um membro puder fazer login em 5 PCs simultaneamente, ele pode consumir 5x os recursos. Defina isso para 1 para a maioria dos membros.
  • Esquecer de selecionar o tipo de crédito correto. Usar "Pago" para uma recarga cortesia infla seus relatórios de receita. Use "Bônus" ou "Manual" para créditos que não geram receita.
  • Não definir uma expiração no tempo promocional. Créditos de tempo grátis sem uma data de expiração nunca expiram. Se você pretende que o tempo promocional seja limitado, sempre defina uma expiração.
  • Excluir um membro em vez de desativar. Desativar preserva o histórico e pode ser revertido. A exclusão é permanente e remove todos os registros associados.