Regras de geração de chances

A regra de geração é o que decide como cada nota, cadastro, story ou entrada em comunidade vira chance. Ela não tem tela própria no menu: é configurada dentro do formulário da campanha, no card de cada modalidade, pelo modal "Configurar regras de geração". É a configuração mais sensível do painel — mexer nela no meio da campanha muda o que o participante recebe.

A lista de regras da modalidade

Em cada modalidade marcada na campanha, o card mostra as regras daquela modalidade, com o nome, a base, o que rende e etiquetas como inativa, saldo, teto ou rende no evento. Os botões são "Adicionar regra", editar e "Tirar". Tirar remove só o vínculo com aquela modalidade — a regra continua cadastrada no cliente e pode ser reutilizada.

A regra é um cadastro reutilizável: a mesma regra pode ser usada por várias campanhas. Por isso o limite configurado nela acompanha a regra — toda campanha que usar a mesma regra herda o mesmo limite de notas.

Desmarcar uma modalidade não joga a regra fora: o card avisa que a regra está configurada e que basta marcar de novo para reutilizá-la.

As bases de geração

O formulário do modal é guiado pela base escolhida:

• Valor da nota: gera conforme o valor da compra e exige o valor mínimo por número.
• Quantidade de produtos: gera conforme a quantidade de produtos participantes na nota e exige a quantidade mínima.
• Produto participante: gera quando um produto específico aparece na nota.
• Por story: cada story do Instagram aprovado rende a quantidade configurada, sem nota. Aceita um máximo de stories por dia; em branco é sem limite.
• Por cadastro: a inscrição na campanha rende a quantidade configurada, uma única vez. Só vale na modalidade Sorteio.
• Por entrada na comunidade: a entrada na comunidade do cliente no WhatsApp rende a quantidade configurada, uma única vez por participação. Sair e voltar não rende de novo, e sair não tira número. Só vale na modalidade Sorteio e só rende se a campanha tiver o identificador da comunidade preenchido.
• Pontos por produto: usada na modalidade Pontos. Soma os pontos de cada produto da nota, unidade por unidade. Os pontos ficam no campo "Pontos por unidade" do vínculo do produto, na aba Produtos da campanha; produto sem pontos não soma.

Nas bases por story, por cadastro e por entrada na comunidade o modal esconde os limites de nota e o saldo, porque elas não dependem de nota. A quantidade máxima de participação continua valendo como teto de chances.

A seção "Configuração específica" só aparece na modalidade Posição premiada. Nela ficam o limite de posições e a premiação por rede, que separa a apuração das posições por rede.

Várias regras somam

Várias regras na mesma modalidade somam. Duas regras de uma chance a cada cinquenta reais dão quatro chances numa nota de cem reais. As de story, cadastro e comunidade rendem no próprio evento, não na nota. Vale o menor teto por participante entre as regras.

A tela confere o conjunto antes de salvar: tem de haver pelo menos uma regra ativa; no máximo uma regra com saldo; e, na modalidade Pontos, não entram story, cadastro nem comunidade. Erro aqui aparece no card e bloqueia o botão de salvar.

A série do sorteio fica na modalidade

A série — o formato do número da sorte, como 042/01987 — não fica mais na regra. Ela é escolhida no campo "Série (formato do número da sorte)" do card da modalidade Sorteio, acima da lista de regras. É obrigatória no Sorteio: sem ela, a campanha não salva e a tela pede para escolher a série.

Há uma série por campanha. Ela pode ser trocada à vontade até a campanha gerar o primeiro número da sorte. Depois disso o campo fica travado, com a explicação na tela: trocar deixaria a campanha com números em dois formatos, e nem o Master troca. Para usar outra série, o caminho é uma campanha nova.

Pelo mesmo motivo, a modalidade Sorteio não pode ser desmarcada numa campanha que já gerou número da sorte. O card não deixa desmarcar e explica o porquê.

Se a série em uso for inativada depois no cadastro de séries, ela continua valendo nesta campanha. O campo mostra o nome dela com a marca "(inativa)" e a nota de que foi inativada depois de escolhida. Escolher outra série inativa não é possível.

O que saiu do modal

O grupo "Produtos aceleradores" saiu do modal da regra. A opção não mudava resultado nenhum. Para dar chance a mais por produto, o caminho é somar uma regra de base Produto participante às outras regras da modalidade. O histórico das regras antigas continua mostrando a linha dos aceleradores como foi gravada.

Limites de notas

Dois limites da regra são de notas, e não de números: a quantidade de chances por CPF é o máximo de notas por dia por participante, e a quantidade de chances total de notas é o máximo de notas na campanha inteira por participante. A nota que passa do limite é recusada. Em branco é sem limite; zero não é aceito.

Validar estado

A opção "Validar estado" fica no formulário da campanha, entre os limites e validações, e não na regra. Ligada, a nota passa a exigir o estado e é recusada quando o estado da nota for diferente do estado em que o participante declarou residir. Participante sem estado tem a nota recusada, com mensagem que leva a completar o cadastro. O estado passa a ser obrigatório no cadastro pelo hotsite e pela integração de parceiro. A edição do cadastro pelo painel fica de fora dessa exigência, de propósito, para o operador conseguir corrigir cadastro antigo.

Campanha em andamento

Alterar a regra de uma campanha em andamento exige o papel Master e confirmação explícita. Quem não é Master recebe a recusa com a orientação de pedir ao Master do cadastro. O Master que ainda não confirmou recebe a mensagem com as campanhas afetadas e o aviso de que a alteração não recalcula nada para trás: as chances e o saldo já gerados ficam como estão, e só as notas cadastradas depois seguem a regra nova. Fora do período da campanha nada disso se aplica — o papel comum salva sem confirmar. A mesma exigência vale para acrescentar, trocar ou remover a modalidade.

Se o Master cancelar a confirmação, a tela avisa que os dados da campanha foram salvos e a troca de regra não. A troca da série não passa por essa confirmação: o que vale para ela é a trava do primeiro número.

Histórico

Toda alteração fica registrada. Na edição, o modal tem a aba "Histórico", que lista as alterações da mais recente para a mais antiga, com o que mudou, quem alterou e selos como "Confirmada pelo cliente", "Sem confirmação" ou "Não exigia confirmação". Ver o histórico não exige o papel Master — quem vê a regra vê o histórico dela. Regra que nunca foi alterada mostra "Nenhuma alteração registrada". Os valores vêm formatados do servidor, com o mesmo rótulo que o formulário mostra, e o horário é sempre o de Brasília. Alteração feita pela equipe Premify aparece como tal.

A regra de geração é onde o cliente define a mecânica da promoção. Antes de o cliente pedir uma troca de regra com a campanha no ar, três coisas precisam estar ditas.

A alteração vale só para frente. Nada é recalculado para trás: quem já recebeu chance pela regra antiga continua com ela.

Só o Master do cadastro do cliente pode fazer essa alteração, e vai ter de confirmar uma mensagem que nomeia as campanhas afetadas. Isso existe de propósito: é o registro de que a decisão foi do cliente.

Toda alteração fica no histórico, inclusive a do nome. É esse histórico que o cliente lê quando precisa provar o que mudou e quando.

Sobre a série do sorteio: ela é escolhida na modalidade Sorteio e pode ser trocada até sair o primeiro número da sorte. Depois disso não muda mais, para ninguém. Vale combinar o formato do número antes de a campanha começar.

Se o cliente usa mais de uma regra na mesma modalidade, elas somam. Esse é o caminho para, por exemplo, dar chance pelo valor da nota e chance extra por entrar na comunidade do WhatsApp — ou chance extra por um produto específico.

• Falha: a campanha não está gerando número nenhum.
• Possivel causa: a modalidade ficou sem regra ativa ou com apenas regra inativa.
• Como orientar: abra o formulário da campanha e confira se existe pelo menos uma regra ativa no card da modalidade. A própria tela recusa salvar essa configuração e nomeia a regra inativa.
• Quando escalar: se houver regra ativa configurada e as notas continuarem sem gerar chance, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a campanha não salva e a tela pede para escolher a série.
• Possivel causa: a modalidade Sorteio está marcada sem série. A série agora fica no card da modalidade, não na regra.
• Como orientar: escolha a série no campo "Série (formato do número da sorte)" do card do Sorteio. Se a lista estiver vazia, cadastre ou reative a série em Cadastros e Séries.
• Quando escalar: se a série estiver escolhida e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o campo da série aparece desabilitado.
• Possivel causa: a campanha já gerou número da sorte. A partir daí a série não muda mais, nem pelo Master.
• Como orientar: explique que a trava é proposital, para a campanha não ter números em dois formatos. Para usar outra série, o caminho é criar uma campanha nova.
• Quando escalar: não é falha. Só escalar se a campanha não tiver nenhum número gerado e o campo continuar travado.

• Falha: o operador não consegue desmarcar a modalidade Sorteio.
• Possivel causa: a campanha já gerou número da sorte, e a série que explica esses números só existe na modalidade.
• Como orientar: explique que a trava é proposital e que a modalidade precisa continuar na campanha. Para outra configuração, crie uma campanha nova.
• Quando escalar: não é falha.

• Falha: o campo da série mostra o nome com a marca inativa.
• Possivel causa: a série foi inativada no cadastro de séries depois de escolhida. Ela continua valendo nesta campanha.
• Como orientar: não troque a série. A campanha segue gerando números no mesmo formato. Se quiser a série ativa de novo, reative em Cadastros e Séries.
• Quando escalar: não é falha.

• Falha: o operador recebe recusa ao alterar a regra e a mensagem fala em pedir ao Master.
• Possivel causa: a campanha está em andamento, e alterar regra de campanha em andamento exige o papel Master.
• Como orientar: explique que a trava é proposital e oriente a pedir a alteração ao Master do cadastro do cliente.
• Quando escalar: não é falha. Só escalar se o próprio Master receber a mesma recusa.

• Falha: o cliente procura a opção de produtos aceleradores e não encontra.
• Possivel causa: a opção saiu do modal porque não mudava resultado nenhum.
• Como orientar: para dar chance a mais por produto, adicione na mesma modalidade uma regra de base Produto participante. As regras somam.
• Quando escalar: não é falha.

• Falha: o participante diz que a nota dele foi recusada por causa do estado.
• Possivel causa: a opção Validar estado está ligada na campanha e o estado da nota não bate com o estado declarado no cadastro, ou o cadastro está sem estado.
• Como orientar: confira o estado no cadastro do participante e oriente a completar o cadastro. Em cadastro antigo o operador pode corrigir o estado pela edição de cadastro no painel.
• Quando escalar: se o cadastro e a nota tiverem o mesmo estado e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o participante não consegue cadastrar mais notas.
• Possivel causa: o limite de notas por dia ou o limite de notas na campanha inteira da regra foi atingido.
• Como orientar: confira os dois limites na regra da modalidade. Em branco é sem limite. Lembre que o limite acompanha a regra e vale em toda campanha que a use.
• Quando escalar: se os limites estiverem em branco e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.