Prêmios da campanha e resgates de pontos

São duas telas ligadas ao mesmo catálogo:

• A aba Prêmios da campanha (também acessível em Campanhas e depois Gerenciar prêmios) é o catálogo de prêmios da campanha. Todo prêmio pertence a uma modalidade: sorteio, posição premiada ou pontos.
• A tela Resgates do grupo Gerenciar é a fila dos pedidos de troca de pontos por prêmio feitos pelos participantes no site, nas campanhas com a modalidade Pontos.

O catálogo de prêmios

Cada prêmio tem nome (obrigatório), modalidade (obrigatória), valor, ordem, imagem e rede opcional — sem rede, o prêmio vale para todas (aparece como Global). A imagem aceita PNG, JPG ou WEBP de até 30 MB.

A modalidade decide onde o prêmio aparece:

• Prêmio de sorteio só aparece no registro de ganhador de sorteio. Só ele tem data do sorteio e a opção de sorteio automático, que exige a data. Essa opção é gravada, mas hoje não dispara nenhum sorteio sozinha.
• Prêmio de posição premiada só aparece no cadastro e na importação de posições.
• Prêmio de pontos aparece na vitrine de troca do site e exige o custo em pontos (número inteiro maior que zero). O estoque é opcional: é quantas unidades estão disponíveis agora, cada pedido separa uma e a reprovação ou o cancelamento devolve. Em branco, não há limite.

O formulário só oferece as modalidades habilitadas na campanha; se só uma é possível, o campo nem aparece. Sem sorteio, posição premiada nem pontos habilitados, o formulário avisa que é preciso habilitar uma delas nas modalidades da campanha. A modalidade não muda depois que o prêmio está em uso.

A listagem tem filtro por modalidade quando a campanha tem mais de uma, e uma coluna de troca, com o custo em pontos e o estoque (ou "Esgotado"), quando existe prêmio de pontos.

Regras que protegem o que já foi entregue:

• Prêmio vinculado a posição não pode ser inativado nem excluído.
• Prêmio usado por ganhador, ou por importação de posições já desfeita, é inativado em vez de excluído.
• Prêmio já entregue não muda mais de nome nem de valor, porque esses dados aparecem no que já foi aprovado e comunicado. Imagem, ordem e rede seguem editáveis. Para pagar outra coisa, cadastre outro prêmio.

A fila de resgates

A campanha é um seletor da tela. A fila abre em Pendentes e tem os filtros Aprovados, Entregues, Reprovados, Cancelados e Todos, cada um com o total. A busca aceita nome, CPF ou prêmio.

Cada pedido mostra o participante e o saldo de pontos atual dele, o prêmio e o custo, o endereço de entrega, a situação e a data do pedido. O nome e o custo do prêmio ficam congelados no pedido: editar o prêmio depois não muda os pedidos já feitos.

As ações seguem a situação:

1. Pendente: aprovar ou reprovar. Os pontos e a unidade do estoque já saíram quando o participante fez o pedido.
2. Aprovado: marcar entregue, com uma observação opcional (rastreio, retirada na loja), ou reprovar.
3. Entregue, reprovado e cancelado são finais. Cancelado é o pedido que o próprio participante cancelou.

Reprovar exige motivo, que o participante vê no site, devolve os pontos ao saldo e a unidade ao estoque, e não pode ser desfeito.

O aviso de saldo e o extrato

Quando o saldo de pontos do participante está negativo — o cancelamento de uma nota estornou pontos que já tinham virado prêmio — o pedido mostra um aviso visível com o saldo e o motivo. O aviso não bloqueia aprovar, reprovar nem entregar: a decisão é do operador.

Cada pedido tem o botão Ver extrato, que abre o extrato de pontos daquela participação, o mesmo da aba Pontos do participante. Cada movimento mostra de onde veio: a nota, o convite ou o prêmio, além do motivo e do autor. Quem também pode ler notas consegue clicar no número da nota e ver o detalhe dela ali mesmo. Não há ajuste de pontos nessa tela; o ajuste fica na aba Pontos do participante.

Prazo de resgate

O prazo de resgate fica no formulário da campanha e só aparece com a modalidade Pontos marcada. São os dias, de 0 a 365, depois do fim da campanha em que o participante ainda troca pontos por prêmio. Em branco, a troca fecha junto com a campanha.

Permissões

O catálogo segue as permissões de ler, criar, editar e excluir prêmios. A fila de resgates segue a permissão de ler participações, e aprovar, reprovar e marcar entregue seguem a de editar participações.

O catálogo é por modalidade: o prêmio cadastrado como sorteio não aparece nas posições, e o de pontos só aparece na vitrine de troca. Se o prêmio não aparece onde o cliente espera, a primeira conferência é a modalidade dele.

No prêmio de pontos, o estoque é o que resta agora, não o total inicial. Deixar em branco significa sem limite.

Na fila de resgates, a ordem natural é aprovar e depois marcar a entrega. A reprovação devolve pontos e estoque e mostra o motivo ao participante, então vale escrever um motivo claro.

O aviso de saldo negativo é um alerta para o operador olhar com atenção, não uma trava. O botão Ver extrato mostra de onde vieram os pontos antes da decisão.

• Falha: o prêmio cadastrado não aparece no registro de ganhador ou no cadastro de posição.
• Possivel causa: o prêmio foi cadastrado em outra modalidade ou está inativo.
• Como orientar: abra a aba Prêmios da campanha e confira a coluna Modalidade e o status do prêmio.
• Quando escalar: se a modalidade estiver correta, o prêmio ativo e ele continuar ausente, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: não dá para mudar o nome ou o valor de um prêmio.
• Possivel causa: o prêmio já foi entregue: há posição distribuída, aprovação na apuração ou ganhador apontando para ele.
• Como orientar: explique que o dado já comunicado não muda. Cadastre outro prêmio e vincule às posições que ainda não saíram.
• Quando escalar: não é falha.

• Falha: não dá para inativar nem excluir um prêmio.
• Possivel causa: há posição premiada vinculada a ele.
• Como orientar: a mensagem da tela explica o motivo. Troque o prêmio das posições que ainda não saíram antes de inativar.
• Quando escalar: se não houver posição vinculada e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o campo de modalidade não aparece no formulário do prêmio.
• Possivel causa: só uma modalidade é possível nessa campanha, e o painel já usa essa.
• Como orientar: confira as modalidades habilitadas no formulário da campanha.
• Quando escalar: não é falha.

• Falha: o pedido de resgate mostra um aviso de saldo negativo.
• Possivel causa: uma nota do participante foi cancelada depois de os pontos dela terem sido usados.
• Como orientar: abra Ver extrato no pedido para entender de onde vieram os pontos e decida. O aviso não bloqueia a decisão.
• Quando escalar: se o extrato não explicar o saldo negativo, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: os botões de aprovar ou reprovar não aparecem em um pedido.
• Possivel causa: o pedido já está em situação final ou o papel do usuário não tem a permissão de editar participações.
• Como orientar: confira a situação do pedido. Se for pendente ou aprovado, confira com o Master do cliente a permissão do papel.
• Quando escalar: se o pedido estiver pendente, o papel tiver a permissão e os botões continuarem ausentes, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o participante diz que não consegue mais trocar pontos.
• Possivel causa: a campanha terminou e o prazo de resgate acabou ou está em branco, o prêmio está esgotado ou o saldo não cobre o custo.
• Como orientar: confira o prazo de resgate no formulário da campanha, o estoque do prêmio na aba Prêmios e o saldo na aba Pontos do participante.
• Quando escalar: se tudo estiver dentro das regras e a troca continuar recusada, abrir issue no Jira (projeto DEV) com as evidências.