Licenciamento

As versões de lançamento do HandyCafe exigem uma conta HandyCafe verificada antes da configuração do servidor local ou da entrada da equipe. O seu plano determina o número de conexões simultâneas de PCs clientes e consoles que o servidor aceita. Ele também controla o acesso aos recursos específicos de cada plano.

Ativação da Licença

1. Inicie o HandyCafe Server.
2. O HandyCafe verifica se já existe uma licença de conta ativada neste servidor.
3. Informe seu e-mail e sua senha na tela Entrar quando não houver nenhuma licença de conta ativada.
4. Selecione Criar uma gratuitamente quando precisar de uma conta. Informe apenas o seu endereço de e-mail.
5. Abra o link seguro de registro enviado por e-mail. Crie sua senha e conclua o registro no navegador.
6. Volte ao HandyCafe Server e entre com a nova conta.
7. O HandyCafe cria ou seleciona a licença da lan house para a conta e a ativa no servidor.
8. Crie a primeira conta Admin local quando o servidor ainda não tiver um Admin. Caso contrário, aparece a tela de login de Admin ou de operador de caixa.

Contas verificadas novas recebem o plano Gratuito automaticamente. Uma chave de licença HC- neutra em relação ao plano continua sendo usada internamente. A chave não contém o nome do plano atual e mantém a mesma identidade quando o plano muda. Os usuários da versão GA não precisam digitar nem copiar essa chave.

As versões de lançamento não oferecem mais um plano de teste. Se uma instalação antiga ainda tiver um registro de teste assinado, o HandyCafe mantém a ativação da conta verificada e a apresenta como Versão Gratuita enquanto a migração para a nuvem é concluída. O aplicativo não pede a senha da conta de novo a cada inicialização.

A tela de ativação da conta é o primeiro passo obrigatório do lançamento. O Assistente de Primeira Configuração local e a tela de login de Admin ou de operador de caixa só são carregados depois que a ativação da conta é bem-sucedida. A tela de conta da versão de lançamento não pode ser pulada por uma prévia de demonstração.

Selecione Esqueceu a senha? abaixo do campo de senha para pedir um link de redefinição. O HandyCafe sempre mostra a mesma confirmação após o envio. Isso impede que a tela revele se o e-mail está cadastrado.

Plano Gratuito

O plano Gratuito não expira. Ele exige uma conexão de internet funcionando e inclui estes limites:

O HandyCafe mostra VERSÃO GRATUITA na barra superior enquanto o plano Gratuito está ativo. Um cartão dispensável de Versão Gratuita aparece uma vez quando o aplicativo inicia. A página Sobre também identifica a Versão Gratuita e seus limites de 2 PCs e 2 consoles ativos, sem contagem regressiva de teste nem data de expiração.

O plano Gratuito exige uma Conexão ao Vivo com a Nuvem do HandyCafe autenticada o tempo todo. O servidor envia um heartbeat por WebSocket a cada 30 segundos. Três janelas de heartbeat perdidas, cerca de 90 segundos, interrompem o uso operacional. As sessões de PC e de console existentes são encerradas. Novas sessões, Acesso Remoto, capturas de tela e outras operações de escrita continuam bloqueadas até que a Conexão ao Vivo autenticada se restabeleça.

A concessão online assinada de 10 minutos continua sendo uma segunda camada de verificação. Restaurar apenas o acesso geral à internet não basta. A Conexão ao Vivo com a Nuvem autenticada precisa se restabelecer e a concessão assinada precisa continuar válida. Os controles de licença e de compra, os logs, o backup local, a exportação e as ferramentas de recuperação continuam acessíveis enquanto o uso operacional está bloqueado.

Os limites diários de Acesso Remoto e de capturas de tela são definidos pela nuvem. Uma captura que falha não consome a cota. Abrir ou salvar uma captura de tela existente não consome a cota. Os planos Genesis pagos têm Acesso Remoto e capturas de tela locais ilimitados.

Quando um plano pago expira, é cancelado ou tem um pagamento recusado, a lan house passa para o plano Gratuito em vez de perder o acesso aos seus registros. As conexões e sessões de console acima dos limites do plano Gratuito param imediatamente. Uma licença revogada ou desativada por segurança encerra todo o acesso de clientes e consoles.

Planos Genesis de Prazo Fixo

Um plano Genesis pode ser atribuído diretamente a uma lan house por um prazo fixo, sem assinatura com pagamento recorrente. O Dashboard do HandyCafe mostra isso como o plano atual da lan house em Dashboard, Meu Plano e Faturamento. Ele exibe a data final fixa em vez de uma data de renovação.

Um plano de prazo fixo não tem renovação automática nem cancelamento pelo Stripe. Os controles de cancelamento de assinatura, reativação e troca de plano por autoatendimento continuam indisponíveis para esse plano. Entre em contato com o suporte do HandyCafe quando o plano atribuído precisar mudar antes da data final.

Transição do Plano Anual Legacy

Uma compra Legacy anual ativa feita antes de 1 de julho de 2026 pode migrar para o Genesis sem perder o período Legacy já pago. O HandyCafe confirma o pagamento Legacy bem-sucedido antes de oferecer a transição. Um preço ou identificador de assinatura armazenado não é aceito sozinho como comprovante de pagamento. O HandyCafe escolhe o menor pacote Genesis que cobre o limite de clientes do Legacy. O acesso ao Genesis é liberado imediatamente. O acesso incluído termina no mesmo instante em que termina o período Legacy existente.

Abra Meu Plano e localize a licença Legacy elegível. Selecione Migrar para o Genesis e revise a confirmação. A confirmação mostra cobrança zero hoje. Ela também mostra o valor anual exato do Genesis e a data do primeiro pagamento. O Stripe verifica e salva o cartão. Em seguida, o HandyCafe agenda a nova assinatura anual do Genesis para começar quando o período Legacy pago terminar. Essa transição não cria um período de teste.

A renovação Legacy existente só é desativada depois que o agendamento da futura assinatura Genesis é criado com sucesso. Uma configuração que falha restaura a definição de renovação Legacy anterior. O HandyCafe também reconcilia uma configuração interrompida antes de permitir um novo checkout. Isso evita uma lacuna de faturamento, uma cobrança futura invisível ou duas renovações ativas.

Selecione Cancelar renovação agendada para interromper a cobrança futura do Genesis. O acesso ao Genesis incluído continua até a data final do período Legacy pago. Depois dessa data, a lan house passa para o plano Gratuito. Um primeiro pagamento do Genesis recusado também move a lan house para o plano Gratuito. Os registros continuam disponíveis dentro dos limites do plano Gratuito.

Renovações Legacy pelo PayPal precisam de ajuda do suporte antes da transição por autoatendimento. O HandyCafe não agenda uma segunda cobrança recorrente enquanto uma renovação existente do PayPal ainda pode estar ativa.

Configurações da Conta

Abra Configurações, depois selecione Conta para gerenciar a conta HandyCafe vinculada ao servidor. A página mostra a pessoa de contato e o e-mail, a lan house, o país, o plano atual, a cota de PCs, a cota de consoles ativos e a exigência de conexão online. Os pacotes de Nuvem e de Cafeteria ativos aparecem como cartões separados na seção Complementos, abaixo do plano. Selecione Dashboard para abrir o Dashboard do HandyCafe vinculado no navegador do sistema.

No caso de uma assinatura Stripe com renovação automática, a página rotula o limite real do período de cobrança como data de renovação. Se a renovação automática estiver inativa, ela informa isso e exibe a data final de acesso da licença. A data final de acesso pode ser posterior ao limite do período de cobrança porque o HandyCafe inclui uma pequena margem de reconciliação para webhooks de pagamento atrasados. O acesso à Nuvem ou à Cafeteria concedido por um administrador aparece como pacote ativo, sem inventar uma data de renovação.

Selecione Atualizar para solicitar o status assinado mais recente da conta e do plano. Selecione Migrar para o Genesis ou Gerenciar plano para abrir a seleção de planos existente e o fluxo de checkout seguro.

Somente o operador de caixa Admin local pode selecionar Sair. O HandyCafe pede confirmação antes de remover a conta do servidor. Sair desconecta a Conexão ao Vivo com a Nuvem e o relay da cafeteria, apaga a credencial compartilhada da nuvem e devolve o servidor à tela obrigatória de entrada na conta HandyCafe. Uma licença quebrada ou em modo somente leitura ainda pode ser apagada pela tela de recuperação de bloqueio quando a entrada como Admin local não está disponível.

Estados da Licença

Limite de PCs

Sua licença especifica o número máximo de conexões simultâneas de PCs clientes e consoles.

• Quando o limite é atingido, novas conexões de clientes são rejeitadas.
• Iniciar uma terceira sessão de console no plano Gratuito é rejeitado mesmo que mais consoles tenham sido registrados antes de o plano Gratuito ser ativado.
• O servidor exibe uma notificação de limite traduzida. Ele não expõe um código de erro interno.
• O plano Gratuito comporta 2 PCs conectados e 2 consoles conectados por vez.

Se você precisa de mais PCs, atualize sua licença pelo site do HandyCafe.

Modo Somente Leitura

Quando o limite de PCs está definido como 0 (ou quando a licença está em certos estados restritos), o servidor entra em modo somente leitura:

• Você pode visualizar todos os dados e relatórios
• Você não pode iniciar novas sessões
• Você não pode fazer alterações em configurações que afetam operações de clientes
• O Painel de Administração exibe uma sobreposição de licença indicando a restrição

Internet e Comportamento Offline

Os planos pagos usam o período de tolerância offline configurado. O padrão é 48 horas. Se o servidor não conseguir alcançar o serviço de licenciamento:

1. A licença entra no estado offline_grace.
2. Você tem até o prazo de tolerância configurado para restaurar a conectividade com a internet.
3. Durante o período de tolerância, todos os recursos funcionam normalmente.
4. Passado o prazo, a licença entra no estado offline_locked e o servidor é restringido.

O plano Gratuito não usa o período de tolerância offline dos planos pagos. Ele precisa manter a Conexão ao Vivo com a Nuvem autenticada. Uma janela curta de 90 segundos de heartbeats perdidos tolera oscilações breves de rede. A concessão online assinada de 10 minutos oferece uma segunda camada de verificação.

O HandyCafe Server aceita o estado de licença vindo da Nuvem apenas quando a resposta traz uma assinatura HandyCafe válida vinculada à instalação e à requisição atuais. Respostas sem assinatura, alteradas, desatualizadas, repetidas ou de outra instalação são rejeitadas. O acesso operacional continua bloqueado até chegar uma resposta válida.

Dica: Certifique-se de que seu PC servidor tenha uma conexão de internet estável que permita tráfego WebSocket seguro até a Nuvem do HandyCafe. O heartbeat usa largura de banda mínima.

Sobreposição de Licença

A sobreposição de licença também traz o resumo de inicialização único da Versão Gratuita. Quando há um problema de licença, a mesma sobreposição apresenta a ação necessária. Esta sobreposição:

• Mostra o status atual da licença
• Exibe o limite de PCs
• Exibe o limite de consoles ativos
• Fornece instruções para resolver o problema
• Bloqueia o uso operacional quando a licença exige uma ação

Próximos Passos

• Painel de Controle: Entenda a interface principal
• Configurações: Configure sua instalação