HandyCafe Docs
owner

Campanhas

Campanhas sao ofertas promocionais que agrupam um ou mais pacotes sob um unico tema ou promocao por tempo limitado. Elas permitem que proprietarios de lan houses e centros de jogos criem ofertas estruturadas (como "Especial de Verao" ou "Pacote Gaming de Fim de Semana") que membros podem visualizar e comprar pelo Painel do Membro no cliente ou no balcao do caixa.

Estrutura da Campanha

Cada campanha e definida pelos seguintes campos:

Campo Descricao
name O nome de exibicao da campanha, mostrado a membros e equipe.
description Uma descricao de texto explicando o proposito, termos ou beneficios da campanha.
active Um botao que controla se a campanha esta atualmente disponivel para compra.
expires_at Uma data de expiracao opcional. Apos esta data, a campanha nao esta mais disponivel para novas compras, embora compras existentes permanecam validas conforme seus proprios termos.
deleted Uma flag de exclusao suave. Campanhas excluidas ficam ocultas da lista ativa mas seus dados sao preservados para relatorios.

Estados da Campanha

Uma campanha pode estar em um dos seguintes estados:

  • Ativa: A campanha esta visivel e disponivel para compra. A flag active esta em 1 e a campanha nao foi excluida de forma suave.
  • Inativa: A campanha existe mas esta temporariamente desabilitada. A flag active esta em 0. Pode ser reativada a qualquer momento.
  • Expirada: A data atual ultrapassou a data expires_at da campanha. A campanha nao esta mais disponivel para novas compras.
  • Excluida: A campanha foi excluida de forma suave. Nao aparece em nenhuma lista ativa e nao pode ser comprada, mas todos os dados associados (compras, lotes, registros de consumo) sao preservados.

Vinculando Pacotes a Campanhas

Uma campanha sozinha nao define o que o membro recebe. Esse e o papel dos pacotes. Cada campanha contem um ou mais pacotes que definem a parcela especifica (minutos, credito de carteira ou ambos) e o preco de compra.

Por exemplo, uma campanha "Volta as Aulas" pode incluir tres pacotes:

  • Basico: 60 minutos por um preco fixo.
  • Padrao: 120 minutos + 30 minutos de bonus por um preco mais alto.
  • Premium: 500 unidades de credito de carteira + 60 minutos de bonus pelo preco mais alto.

Consulte a pagina Pacotes para detalhes completos sobre como os pacotes sao configurados.

Fluxo de Compra do Membro

Quando um membro compra um pacote de campanha, a seguinte sequencia ocorre:

  1. Navegar: O membro visualiza as campanhas disponiveis no Painel do Membro no PC cliente (na aba Campanhas) ou um operador busca campanhas na interface do servidor.
  2. Selecionar: O membro escolhe um pacote especifico dentro de uma campanha.
  3. Pagamento: O preco de compra e coletado. Pode ser dinheiro no caixa, pagamento com cartao ou deducao do saldo existente da carteira do membro.
  4. Cumprimento: O sistema cria os creditos de carteira e/ou creditos de tempo apropriados com base na definicao do pacote:
    • Para pacotes de dinheiro: creditos de carteira sao criados com a parcela monetaria.
    • Para pacotes de minutos: creditos de tempo sao criados com a parcela de minutos.
    • Parcelas de bonus criam creditos adicionais marcados como "bonus".
  5. Registro: Um registro de compra e criado vinculando o membro, campanha, pacote e todos os creditos associados. Este registro rastreia parcela concedida vs. consumo no nivel da compra.

Ativacao e Desativacao de Campanhas

Proprietarios podem alternar o estado ativo de uma campanha a qualquer momento:

  • Ativar uma campanha a torna imediatamente disponivel para compra por membros e operadores.
  • Desativar uma campanha a remove da lista de compras mas nao afeta compras existentes. Membros que ja compraram pacotes da campanha mantem seus creditos de carteira e creditos de tempo.

Isso e util para promocoes sazonais. Crie a campanha com antecedencia, ative-a quando a promocao comecar e desative-a quando terminar, tudo sem perder nenhum dado.

Criando uma Campanha

Para criar uma nova campanha:

  1. Navegue ate a secao de Campanhas na barra lateral (ou area dedicada de gestao de campanhas).
  2. Clique em Adicionar Campanha.
  3. Informe um nome e uma descricao para a campanha.
  4. Opcionalmente defina uma data de expiracao se a campanha deve parar de aceitar novas compras apos uma data especifica.
  5. Salve a campanha.
  6. Adicione um ou mais pacotes a campanha (consulte Pacotes para detalhes).

Gerenciando Campanhas

Na lista de campanhas, voce pode:

  • Editar o nome, descricao ou data de expiracao de uma campanha.
  • Alternar o status ativo para habilitar ou desabilitar a campanha.
  • Excluir uma campanha (exclusao suave) para remove-la permanentemente da lista ativa preservando os dados.
  • Visualizar compras para ver quais membros compraram pacotes desta campanha e o status das suas parcelas.