Número da sorte e o papel da série

É o número que o participante recebe na modalidade Sorteio. Ele tem o formato série/sequencial — por exemplo 001/00001 — e as duas partes são sorteadas, não contadas em ordem. O formato inteiro (quantos dígitos, qual faixa, se há prefixo) vem do cadastro de Série, nada é fixo no código.

A série é da modalidade Sorteio

A série é o que define o formato do número, e ela é escolhida na modalidade Sorteio da campanha — não mais na regra de geração. Antes ela ficava na regra, e com duas regras de série diferente no mesmo Sorteio o formato do número podia variar de uma nota para outra. Agora há uma série por campanha, como era no sistema anterior.

As regras da série na configuração:

• no Sorteio, a série é obrigatória. Sem ela o motor não sabe que número emitir, e por isso a configuração é recusada sem série;
• fora do Sorteio, a série é recusada. As outras modalidades não geram número;
• série inativa não pode ser escolhida. A série que a campanha já usava e foi inativada depois continua valendo para ela, e a modalidade continua editável;
• trocar a série depois do primeiro número gerado é recusado, para todo mundo — nem o Master com confirmação consegue. A campanha ficaria com números em dois formatos, e nada no número diz qual formato valia para ele: a apuração não teria como separá-los. A orientação da mensagem é criar uma campanha nova. Antes do primeiro número, a série pode ser escolhida e trocada à vontade;
• pelo mesmo motivo, o Sorteio que já gerou número não pode ser removido da campanha, nem pelo Master.

Por que o número é aleatório

Série e sequencial são aleatórios dentro da faixa configurada. Isso não é detalhe de implementação, é requisito da apuração: o número premiado é derivado da Loteria Federal em todo o espaço série × sequencial, então os números emitidos precisam estar espalhados por esse espaço inteiro. Se fossem sequenciais, ficariam concentrados numa faixa e a apuração não funcionaria. Como o número premiado é calculado e quem ganha quando ele não foi distribuído está no artigo de sorteio pela Loteria Federal.

A unicidade é garantida no banco, não em memória: cada campanha não pode ter dois números iguais, e o próprio gravar é a conferência. Em colisão, o motor simplesmente sorteia outro — nada falha para quem cadastrou.

Uma nota não emite duas vezes

A emissão é idempotente por nota: a nota que já emitiu devolve os números que ela tem, não emite outros. Há duas exceções importantes a conhecer:

• a nota que foi cortada a zero por um limite não gravou nada. Se ela for reenviada depois de o espaço liberar (porque uma nota anterior foi cancelada), ela gera. Não é inconsistência: é o cálculo acontecendo no momento em que a nota é processada;
• na modalidade que tem regra com saldo, a nota já creditada não credita nem gera de novo, nem pelas regras sem saldo que dividem a modalidade com ela. O valor dela já está no saldo, e reprocessá-la contaria o mesmo dinheiro duas vezes.

Número com nota, com várias notas e sem nota

Nem todo número vem de nota. O vínculo nota–número é opcional e de muitos para muitos:

• com saldo acumulado, um número pode vir de duas ou mais notas. A compra de R$ 30 não fecha a chance, a de R$ 45 fecha, consumindo R$ 30 da primeira e R$ 20 da segunda — aquele número é das duas compras;
• story aprovado, chance por cadastro, chance por comunidade, chance de convite e carga manual geram número sem nota nenhuma.

O que o participante vê

Na área logada, o participante vê os números agrupados pela nota que os gerou, porque a pergunta real é "o que esta compra me rendeu?". A lista não deduplica: o número que veio de duas notas aparece debaixo das duas — deduplicar responderia "esta compra não te rendeu nada" para uma compra que rendeu. Os números sem nota caem num grupo próprio, sem nota, que aparece uma vez, na primeira página.

Duas situações parecidas que não são a mesma coisa:

• número invalidado desaparece da lista. É a marca que o cancelamento de nota escreve. A nota que ficou sem nenhum número válido sai junto, porque um cabeçalho com zero números abaixo não diz nada;
• nota cancelada aparece marcada, e os números listados abaixo dela continuam válidos. O caso real é o número já publicado como ganhador, que vai para análise manual e fica de pé quando a nota é cancelada. Tratar esse número como cancelado diria ao participante que ele perdeu uma chance que ele não perdeu.

O rótulo pode variar: uma campanha pode trocar "Número da Sorte" por outro nome, como código de participação. O formato é o mesmo; só o texto da tela muda.

O número da sorte é sorteado, não distribuído em ordem. Dois participantes que cadastram na mesma hora não recebem números vizinhos, e isso é necessário para a apuração pela Loteria Federal funcionar: o número premiado pode cair em qualquer ponto da faixa, então os números emitidos têm de ocupar a faixa toda.

A série — o formato do número — é escolhida uma vez, na modalidade Sorteio da campanha. Depois que o primeiro número sai, ela não muda mais, nem o Sorteio pode ser tirado da campanha. Vale confirmar o formato com o cliente antes de a campanha entrar no ar.

Se a campanha acumula saldo, vale avisar que um número pode ter vindo de duas compras. Ele aparece debaixo das duas no extrato do participante, e isso está certo — não é número repetido.

E, se o participante reclama que um número desapareceu, há duas respostas diferentes: número invalidado sai da lista (alguma nota que o formou foi cancelada), e nota cancelada fica na lista marcada, com os números dela de pé quando eles ainda valem.

• Falha: a nota foi aceita mas não gerou nenhum número da sorte.
• Possivel causa: não há regra ativa na modalidade Sorteio, ou algum limite cortou a geração a zero.
• Como orientar: confira primeiro se a modalidade Sorteio tem regra ativa. Se tiver, confira os limites de chance por nota e por participante da regra e quantas chances o participante já tem.
• Quando escalar: se a regra estiver ativa, a série configurada e os limites em branco, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: a nota inteira foi recusada e o participante perdeu também a posição premiada dela.
• Possivel causa: a modalidade Sorteio da campanha está sem série. Sem o formato do número a nota inteira cai, e a posição premiada que estava certa cai junto. A configuração atual não deixa salvar o Sorteio sem série, então isso só acontece em campanha configurada antes dessa trava.
• Como orientar: defina a série na modalidade Sorteio. Depois disso, a nota pode ser recadastrada e vale como nota nova.
• Quando escalar: se a série estiver definida e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o operador não consegue trocar a série do Sorteio.
• Possivel causa: a campanha já gerou o primeiro número. A troca é recusada para qualquer papel, porque deixaria números em dois formatos na mesma campanha.
• Como orientar: explique que a série fica travada a partir do primeiro número. Se o formato precisa mudar, o caminho é uma campanha nova.
• Quando escalar: não é falha. Só escalar se a recusa aparecer numa campanha que ainda não gerou nenhum número.

• Falha: o operador não consegue escolher uma série na lista.
• Possivel causa: a série está inativa. Série inativa não pode ser escolhida, só continua valendo para quem já a usava.
• Como orientar: escolha uma série ativa ou reative a série no cadastro de séries.
• Quando escalar: não é falha.

• Falha: o participante diz que o mesmo número aparece duas vezes no extrato dele.
• Possivel causa: a campanha acumula saldo e aquele número foi formado por duas notas. Ele aparece debaixo de cada uma.
• Como orientar: explique que é um número só, que veio de duas compras. Não é número repetido nem chance em dobro.
• Quando escalar: não é falha. Só escalar se o número aparecer duas vezes debaixo da mesma nota.

• Falha: o participante diz que um número da sorte dele desapareceu.
• Possivel causa: alguma nota que formou aquele número foi cancelada e o número foi invalidado.
• Como orientar: confira no detalhe do participante se há nota cancelada. O motivo do cancelamento fica registrado para a operação e explica a queda.
• Quando escalar: se não houver nota cancelada e o número tiver desaparecido, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o participante reenviou uma nota e recebeu números que não recebeu na primeira vez.
• Possivel causa: na primeira tentativa a nota foi cortada a zero por um limite e não gravou nada. Depois o espaço liberou e o reenvio gerou.
• Como orientar: explique que o cálculo acontece no momento em que a nota é processada. Não é nota contada duas vezes.
• Quando escalar: se a nota aparecer duas vezes ativa na campanha, abrir issue no Jira (projeto DEV) com as evidências.