Operações de Licença na Administração da Nuvem
Os administradores autorizados da plataforma HandyCafe podem gerenciar o acesso comercial de um cliente pela página de detalhes do cliente. A página começa com uma visão geral da conta, o status do perfil, o status da conexão ao vivo e a quantidade de licenças Genesis. Cada licença Genesis tem um cartão de operações que mostra o plano atual, os limites de PCs e consoles, o saldo de IA, o saldo de membro, o acesso aos módulos adicionais e o estado no Stripe.
As ferramentas legadas e de beta ficam em uma seção expansível separada. A atividade de ping e as alterações de perfil estão disponíveis em Diagnóstico e histórico de alterações. Assim o fluxo Genesis atual continua em evidência sem que as ferramentas de suporte mais antigas sejam removidas.
Ver todas as licenças Genesis
Abra Licenças no painel administrativo interno. A aba Genesis abre por padrão e lista apenas os planos Free e Genesis atuais. As concessões Beta antigas permanecem na aba Beta separada.
Os cartões de resumo mostram a quantidade total de licenças e as quantidades de licenças ativas, pagas e gratuitas. A lista pode ser pesquisada por lan house, conta, e-mail, plano ou chave de licença. Os administradores também podem filtrar por tipo de plano ou status. Cada linha mostra a capacidade, o acesso à Nuvem e à Cafeteria, o saldo de IA, a validade e o status. Selecione Gerenciar para abrir o espaço de trabalho do cliente com as operações de plano, serviço, crédito e cobrança.
Criar a primeira licença Genesis
Quando uma conta não tem nenhuma licença Genesis, a página de detalhes do cliente exibe um formulário de criação de licença em vez de um resultado vazio. Selecione um plano Genesis ativo e uma data de expiração futura. Confira o plano, a expiração e o país na caixa de diálogo de confirmação. Selecione Criar licença para atribuí-la diretamente à conta do cliente.
A conta precisa ter um nome de lan house e um país antes da criação. Selecione Editar perfil para preencher os dados que faltam. O plano define tanto o limite de PCs quanto o de consoles. A data de expiração selecionada vale até o fim daquele dia em UTC.
Operações disponíveis
- Atribuir um plano Genesis. As licenças manuais recebem a capacidade e a data de expiração do plano selecionado. As assinaturas gerenciadas pelo Stripe seguem as regras normais de upgrade e downgrade, incluindo cobranças imediatas ou alterações agendadas.
- Gerenciar Nuvem e Cafeteria. O direito de acesso à Nuvem é atualizado na licença. Ativar a Cafeteria também provisiona ou reativa o tenant correspondente em
handy.cafe; desativá-la suspende esse tenant. Os dois serviços nunca são sincronizados enquanto um bloqueio do banco de dados está ativo. - Conceder crédito de IA. A seção de operações de crédito mostra o saldo de IA atual da licença selecionada antes de o administrador informar uma recarga. Conceder crédito adiciona crédito pré-pago em USD à carteira de IA e grava um registro de auditoria.
- Conceder crédito de membro. Adiciona crédito bônus à conta de membro do HandyCafe que tem o mesmo endereço de e-mail. A operação fica indisponível quando não existe um membro correspondente.
- Alterar a próxima data de cobrança. Nas assinaturas do Stripe, a data é atualizada no Stripe e depois sincronizada com a assinatura e a licença locais. Uma alteração de plano agendada precisa ser cancelada antes.
- Reembolsar um pagamento. O administrador seleciona uma cobrança do Stripe passível de reembolso, escolhe um motivo do Stripe, escreve a justificativa interna obrigatória e confirma o reembolso. O reembolso não cancela a assinatura nem remove o acesso ao produto.
Comportamento de segurança e auditoria
Toda ação que altera dados exige confirmação no painel. As operações de alto impacto no backend são restritas pela chave de API de administrador, validam a titularidade das cobranças do Stripe e gravam um registro de auditoria que só permite acréscimos. O histórico de pagamentos é carregado apenas quando solicitado e se limita às cobranças recentes. Os reembolsos usam uma chave de idempotência única para evitar envios duplicados por acidente.
Se uma licença antiga não tiver mais uma chave em texto puro recuperável, o provisionamento automático da Cafeteria falha de forma segura e o painel informa que um administrador precisa resolver primeiro a credencial da licença.
Prefixos de país nas chaves de licença
As novas chaves de licença vinculadas à conta usam o código de país de duas letras do perfil preenchido do cliente, como GEN-TR-... para uma licença Genesis criada por um administrador ou HC-TR-... para uma licença de conta independente de plano. A criação pelo administrador é interrompida quando o perfil não tem um país válido. O sistema nunca cria uma nova chave GEN-XX-... ou HC-XX-....
Atualizar o campo de país em uma licença existente não faz a rotação silenciosa da chave ativa dela. Os administradores precisam coordenar a correção do país com a rotação da chave, já que o servidor instalado precisa fazer login novamente depois que a credencial dele muda.