Apuração de posições e publicação de ganhadores

É a parte do sistema em que o prêmio é conferido por uma pessoa e só depois aparece ao público. São dois atos separados de propósito: a apuração decide quem ganhou, e publicar decide quem aparece. Todo ganhador nasce rascunho.

O ganhador chega por dois caminhos: a posição premiada aprovada na apuração e o ganhador de sorteio registrado na tela de Ganhadores — à mão ou pelo sorteio da Loteria Federal, que tem artigo próprio.

Registrar e publicar são atos diferentes

Essa separação existe porque expor o nome de uma pessoa tem peso de proteção de dados. O que decide se o ganhador aparece na lista pública é a marca de ativo, e ela vem do sistema, não da tela.

Para a lista pública, o rascunho (nunca publicado) e o ganhador ocultado (que já foi publicado e foi retirado) respondem igual: ficam fora da lista e fora do total. O filtro entra antes da contagem — senão a última página do hotsite viria vazia sem explicação.

O ganhador de sorteio

O registro do ganhador de sorteio exige o número e a referência da apuração (por exemplo, o concurso da Loteria Federal). O número tem de existir na campanha, não pode estar invalidado por cancelamento de nota e não pode já estar registrado como ganhador. Os limites de prêmio do participante e da nota são conferidos no registro.

O painel oferece o "Sortear pela Loteria Federal", que calcula o número premiado a partir dos bilhetes do concurso e lista o número mais próximo e os suplentes. A apuração ali não grava nada: quem grava é o mesmo registro do ganhador, com as mesmas conferências. Os detalhes da regra estão no artigo de sorteio pela Loteria Federal.

A reprovação encerra o registro

Reprovar devolve o prêmio ao pool, e a partir daí a posição pode sair para outra pessoa a qualquer momento. Por isso o registro reprovado não é mais aprovado, reprovado nem reaberto. Aprovar daria dois contemplados na mesma posição; reprovar de novo mandaria liberar uma posição que já é de outro participante.

O excedente de prêmio é barrado, não reprovado

Quando o participante já atingiu o limite de prêmios da campanha, a aprovação é barrada, com a mensagem dizendo o teto e quantos prêmios ele já recebeu — e a posição continua pendente. Devolver o prêmio ao pool segue sendo decisão do operador. Reprovar por conta própria escolheria, no lugar dele, qual das posições do participante morre.

Na aprovação em lote, cada posição é uma decisão independente, com relatório e com e-mail próprio, e a contagem dentro do lote é incremental.

Posição publicada não se reabre

Reabrir tiraria a aprovação e deixaria o ganhador de pé: o prêmio seguiria registrado e publicado, mas pararia de contar no limite, dando ao participante uma vaga a mais sem que nada fosse desfeito. O caminho é excluir ou ocultar o ganhador e só então reabrir a posição.

A lista de números disponíveis esconde quem bateu o teto

Ao registrar ganhador de sorteio, a busca de números disponíveis aplica o mesmo recorte do registro. Oferecer o que o registro recusa produziria o erro depois de o operador já ter escolhido, e duas contagens diferentes fariam a lista e o registro discordarem. O sorteio pela Loteria Federal usa o mesmo recorte.

O nome sai abreviado no hotsite

Na lista pública de ganhadores, o nome sai como primeiro nome e a inicial do último sobrenome: "MARIA DA SILVA" vira "MARIA S.". Nome de uma palavra só sai inteiro, porque não há sobrenome a esconder.

Vale o último sobrenome, não o do meio: em "MARIA DA SILVA" o do meio é partícula, e "MARIA D." não é como ninguém chama a pessoa.

A abreviação é feita pelo servidor, não pela tela. Se o hotsite abreviasse, o nome completo trafegaria na resposta para ser cortado no navegador — ou seja, estaria publicado do mesmo jeito, e bastaria abrir os dados da página.

A busca continua casando com o nome completo. Ninguém digita "MARIA S.", e quem procura "silva" procura justamente o sobrenome que a tela reduz a uma inicial.

O painel continua vendo o nome completo — é o que quem opera usa para conferir com quem fala.

As duas abas são duas listas

A lista pública exige a modalidade, e as duas são telas diferentes: a do Sorteio tem o número da sorte, a de posição premiada (vale-brinde, no nome comercial) não tem. Sem a modalidade, a resposta misturaria as duas e a coluna do número viria vazia em metade das linhas sem dizer por quê. Pedir ganhadores de Cupom ou de Pontos é recusado, porque essas modalidades não geram ganhador.

A lista pública só lê: nada de motor e nada de apuração. O ganhador ali já existe e já foi publicado por alguém.

Exclusão

O ganhador só pode ser excluído se nunca foi publicado. Depois de publicado, o caminho é ocultar.

A conferência da nota

A nota que gerou a posição premiada aparece na apuração, com número, valor e imagem — é esse o ponto de conferência, já que a nota não passa por análise de rotina. A nota que formou o número premiado aparece na tela do ganhador do sorteio.

O que o participante vê da própria posição

Três estados: em análise, aprovada ou reprovada. Internamente há muito mais, e eles não aparecem de propósito. Os estados de erro saem como "em análise", porque do lado de quem espera o prêmio o desfecho ainda não existe. Posição de enchimento não tem situação, porque não passa por apuração.

A apuração é onde uma pessoa do lado do cliente confere o prêmio antes de ele ser pago. A nota que gerou a posição está ali, com imagem, justamente para isso — a nota não passa por análise de rotina, e este é o ponto de conferência.

Depois de aprovada, a posição vira ganhador, e aí há um segundo passo: publicar. O ganhador nasce rascunho e não aparece no hotsite até alguém publicá-lo. Essa separação é deliberada, e o cliente costuma perguntar por ela — ela existe porque publicar o nome de uma pessoa é uma decisão, não uma consequência automática. Vale o mesmo para o ganhador do sorteio, inclusive quando ele sai pelo sorteio da Loteria Federal no painel.

Dois pontos sem volta: reprovar encerra aquele registro (o prêmio volta ao pool e pode sair para outra pessoa, então não há como aprovar depois), e posição publicada não se reabre sem antes excluir ou ocultar o ganhador.

Sobre a lista pública: o nome sai abreviado, com primeiro nome e inicial do sobrenome. A busca na lista funciona pelo nome completo, então quem procura pelo sobrenome encontra. No painel, o cliente continua vendo o nome inteiro.

• Falha: o ganhador foi registrado e não aparece no hotsite.
• Possivel causa: ele está como rascunho. Registrar e publicar são atos separados, e todo ganhador nasce rascunho.
• Como orientar: abra a tela de ganhadores e publique o registro. Rascunho e ganhador ocultado ficam fora da lista e fora do total.
• Quando escalar: se o ganhador estiver publicado e não aparecer, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o operador reprovou uma posição por engano e quer aprová-la.
• Possivel causa: a reprovação devolveu o prêmio ao pool e encerrou o registro. Ele não é mais aprovado, reprovado nem reaberto.
• Como orientar: explique que a posição pode já ter saído para outra pessoa. O caminho é tratar o caso com o cliente e registrar outro prêmio pelo fluxo normal.
• Quando escalar: não é falha. Se o cliente precisar de uma correção excepcional, abrir issue no Jira (projeto DEV) com o caso e as evidências.

• Falha: a aprovação da posição foi barrada com mensagem de limite de prêmios.
• Possivel causa: o participante já recebeu o máximo de prêmios da campanha ou aquela nota já pagou o máximo.
• Como orientar: a mensagem diz o teto e quantos prêmios ele já recebeu. A posição continua pendente. Para liberar outra posição dele é preciso reprovar uma das aprovadas, o que devolve aquele prêmio ao pool.
• Quando escalar: não é falha. Só escalar se a contagem não corresponder aos prêmios do participante.

• Falha: o operador não consegue reabrir uma posição aprovada.
• Possivel causa: ela já foi publicada como ganhador.
• Como orientar: exclua ou oculte o ganhador primeiro e só então reabra a posição.
• Quando escalar: não é falha. Só escalar se a recusa aparecer em posição que nunca foi publicada.

• Falha: o operador não consegue excluir um ganhador.
• Possivel causa: ele já foi publicado. Ganhador publicado só pode ser ocultado.
• Como orientar: oculte o ganhador. Ele sai da lista pública e do total.
• Quando escalar: não é falha.

• Falha: o número que o operador queria usar não aparece na lista de números disponíveis.
• Possivel causa: o participante daquele número já bateu o limite de prêmios, o número já é ganhador ou foi invalidado por cancelamento de nota. A lista aplica o mesmo recorte do registro.
• Como orientar: explique que a lista esconde o que o registro recusaria, para o operador não escolher e depois receber erro.
• Quando escalar: não é falha. Só escalar se o número sumir da lista com o participante abaixo do limite e o número válido.

• Falha: o cliente reclama que o nome do ganhador aparece incompleto no hotsite.
• Possivel causa: o nome sai abreviado de propósito, com primeiro nome e inicial do último sobrenome.
• Como orientar: explique que a abreviação protege o dado numa página pública e indexável. A busca na lista funciona pelo nome completo, e o painel mostra o nome inteiro.
• Quando escalar: não é falha.