Fluxo de status do processo de recompensa
O Processador de Recompensas gerencia o ciclo de vida completo das recompensas dos jogadores - desde a criação e reivindicação até a ativação e expiração. O processo de reivindicação de recompensas pode ser iniciado de duas maneiras: através da interface do usuário (UI) ou por um administrador, ambos com o objetivo de conceder uma recompensa ao jogador. As recompensas também podem ser concedidas automaticamente por meio de outros produtos de gamificação, como Missões, Torneios, Campanhas ou compradas diretamente pelo jogador por meio da Loja de Recompensas. Quando uma reivindicação é iniciada, o sistema primeiro verifica se a recompensa já foi reivindicada. Se já tiver sido, o processo termina aí. Se a recompensa ainda estiver disponível (Não Reivindicada), o processo continua dependendo do seu tipo e configuração de ativação.
🎁 Tipos de Recompensas
Cada tipo de recompensa tem sua própria lógica durante a ativação e reivindicação:
| Tipo de Recompensa | Descrição |
|---|---|
| Oferta Bônus | Envia um bônus promocional ao jogador por meio do sistema de bônus externo. |
| Tokens / XP | Concede tokens virtuais ou pontos de experiência diretamente na conta do jogador. |
| Boosters (Nível, Missão, Token) | Multiplica temporariamente o progresso ou os pontos do jogador. Eles podem ser ativados automaticamente ou manualmente. |
| MiniGame | Desbloqueia recompensas especiais de mini-jogos interativos. |
| Externo | Recompensas de sistemas externos, marcadas diretamente como Concedidas. |
| Manual | Recompensas criadas e atribuídas manualmente por administradores. |
🔄 Ciclo de Vida da Recompensa
As recompensas passam por várias etapas para garantir a rastreabilidade e confiabilidade completas:
| Status | Descrição |
|---|---|
| Não Reivindicada | A recompensa está disponível, mas ainda não foi reivindicada pelo jogador. |
| Pendente | Recompensas do tipo Booster/Mini-Games aguardando para serem ativadas. |
| Em Andamento | A ativação da recompensa está em andamento. |
| Concedida / Concluída | A recompensa foi entregue com sucesso ou usada pelo jogador. |
| Falhou | Ocorreu um erro ao processar a recompensa. |
| Recusada / Excluída / Expirada / Devolvida | A recompensa foi recusada, removida, expirada ou abandonada (ex: mini-games). |
⚙️ Fluxo de Reivindicação e Ativação
O processo de reivindicação de recompensas pode ser iniciado de duas maneiras: seja através da interface do usuário (UI) ou por um administrador, ambos com o objetivo de conceder uma recompensa ao jogador. As recompensas também podem ser concedidas automaticamente por meio de outros produtos de gamificação, como Missões, Torneios, Campanhas ou compradas diretamente pelo jogador através da Loja de Recompensas.
Quando uma reivindicação é iniciada, o sistema primeiro verifica se a recompensa já foi reivindicada. Se já tiver sido, o processo termina ali. Se a recompensa ainda estiver disponível (Não Reivindicada), o processo continua dependendo do seu tipo e configuração.
Uma vez validado, o sistema determina o tipo de recompensa e executa o fluxo apropriado:
- As recompensas automáticas são ativadas imediatamente após serem criadas.
- As recompensas manuais ou ativadas pelo jogador permanecem em status Não Reivindicado ou Pendente até que o jogador ou o administrador ative-as.
- Uma vez iniciada a ativação, a recompensa passa para Em Andamento e, em seguida, para Concedida ou Concluída, dependendo do resultado.
- Se ocorrer algum erro durante o processo, o status muda para Falha, fornecendo rastreabilidade para suporte e depuração.
Isso garante que todas as recompensas — sejam elas conquistadas, compradas ou concedidas manualmente — sigam um processo consistente, transparente e confiável, da criação à entrega.
🎯 Visão Geral da Jornada do Usuário do Processador de Recompensas (PR)
O Processador de Recompensas (PR) gerencia todo o ciclo de vida das recompensas — da criação à entrega — com base na configuração da plataforma.
Cada recompensa passa por um conjunto de status que descrevem seu estado atual no processo.
Como a recompensa se move entre esses status depende de duas principais bandeiras de configuração:
- PlayerShouldClaimRewards – determina se o jogador deve reivindicar manualmente a recompensa.
- AutomaticActivation – determina se a recompensa é ativada automaticamente ou precisa de ativação manual.
🧭 Cenários da Jornada do Usuário
Cenário 1 – Jogador Deve Reivindicar e Ativar
Atores: 👤 Jogador → ⚙️ Processador de Recompensas (PR) → 🧩 Mecânica ou serviço (Típico de boosters, minigames ou recompensas com expiração)
- Uma nova recompensa é registrada no PR.
- Como
PlayerShouldClaimRewards = true, a recompensa é armazenada no Baú → status: Não Reivindicada. - O jogador clica em Reivindicar no widget → status: Ativação Pendente.
- O jogador então clica em Ativar → O PR valida a data de expiração.
- Se a recompensa expirar antes da ativação → status: Expirada.
- Se válida → a recompensa passa para Em Andamento e é entregue ao mecânico correspondente (por exemplo, Missões, Ranks).
- O serviço processa a recompensa:
- Aplica efeitos (XP, multiplicadores, etc.)
- Relata a conclusão → status: Concedida ou Concluída.
- Se ocorrer algum erro de entrega → status: Falha.
Cenário 2 – Ativação Automática
(Típico de XP, Tokens, Bônus, recompensas externas)
- Uma nova recompensa é registrada.
- Como
PlayerShouldClaimRewards = false, a recompensa vai diretamente para Ativação Pendente. - Se a recompensa expirar antes da ativação → status: Expirada.
- Se
AutomaticActivation = true, o PR entrega imediatamente a recompensa ao mecânico. - A recompensa passa para Em Andamento, e após entrega bem-sucedida → Concedida.
- Se houver um erro de comunicação ou sistema → Falhou.
🧩 Tabela de Status
| Status | Definido Quando | Quem Ativa | Descrição |
|---|---|---|---|
| Não Reivindicada | Recompensa criada e armazenada no baú | RP | O jogador deve reivindicar antes da ativação. |
| Ativação Pendente | O jogador reivindica a recompensa ou o sistema agenda a ativação | RP | Aguardando ser ativado ou entregue automaticamente. |
| Em Andamento | Início da entrega da recompensa | RP → Mecânica | A mecânica está processando ou validando a recompensa (XP, missão, bônus, etc.). |
| Concedida | Recompensa aplicada com êxito | Mecânica → RP | Recompensa aplicada ao jogador (por exemplo, XP adicionado, bônus concedido). |
| Completa | Recompensa temporária finalizada | Mecânica → RP | Impulsionador ou recompensa temporária expirada após o uso. |
| Expirada | Período de validade da recompensa terminou antes da ativação | RP | A recompensa não é mais válida. |
| Falhou | Ocorreu um erro de entrega ou comunicação | RP | A mecânica não pôde processar a recompensa; marcada para nova tentativa ou suporte. |
| Recusada | O jogador recusa a recompensa | Jogador | A recompensa é cancelada e não armazenada. |
🎁 Resumo do Tipo de Recompensa
| Tipo de Recompensa | Método de Ativação | Expira | Entregue Para | Exemplo / Descrição |
|---|---|---|---|---|
| XP | Automática | ❌ Não | Classificações | O jogador recebe pontos de experiência instantaneamente; o sistema de classificação atualiza o progresso do jogador. |
| Tokens | Automático | ❌ Não | Carteira / Mecânica de Tokens | A moeda virtual ou pontos são adicionados automaticamente ao saldo do jogador. |
| Bônus | Automático | ❌ Não | Serviço de Bônus / Casino | Bônus externo de cassino concedido diretamente (por exemplo, bônus de 10 €). |
| Externo | Automático | ❌ Não | Não fazer nada | — |
| Impulsionador de Missão | Manual do Jogador | ✅ Sim | Missões | O jogador ativa um impulsionador (por exemplo, contribuição ×2) válido por um período determinado (por exemplo, 3 horas). |
| Impulsionador de Token | Manual do Jogador | ✅ Sim | Tokens | Multiplica os tokens ganhos durante uma janela de tempo (por exemplo, ×3 tokens durante 1 hora). |
| Impulsionador de Nível | Manual do Jogador | ✅ Sim | Classificações | Aumenta temporariamente o ganho de XP na progressão de classificação. |
| Mini-Jogo | Manual do Jogador | ✅ Sim | Mecânica de Mini-Jogo | Desbloqueia um jogo que deve ser jogado antes do vencimento (por exemplo, rodada-da-roda). |
| Recompensa Manual | Manual do Administrador | ❌ Não | Definido pelo Administrador | O administrador atribui a recompensa diretamente ao jogador. |
✅ Resumo Rápido
-
Recompensas automáticas: entregues imediatamente — sem ação do usuário.
(XP, Tokens, Bônus, Externo) -
Recompensas manuais: requerem ativação do jogador, podem expirar.
(Impulsionador de Missão, Impulsionador de Token, Impulsionador de Nível, Mini-Jogo)