Ganhadores e publicação no hotsite

É a tela Ganhadores do grupo Gerenciar: quem aparece no showcase de ganhadores do hotsite da campanha. O ganhador nasce de uma das duas vias — o sorteio, a partir de um número da sorte que saiu, ou a posição premiada já aprovada na apuração. O painel registra, corrige os dados de exibição, publica, oculta e, enquanto o registro nunca foi publicado, exclui.

Registrar não é publicar: todo ganhador nasce como rascunho e só vai ao ar no hotsite por uma ação explícita de publicar.

A campanha é um seletor da tela. A listagem é paginada e tem filtros por modalidade, prêmio, publicação (publicados e rascunhos, só publicados ou só rascunhos), período em que foi premiado e busca por nome, CPF/CNPJ completo ou número. As colunas mostram o ganhador (com a cidade), a origem, o prêmio, a data do prêmio, a apuração, a foto e a situação de publicação.

A coluna de publicação usa três selos:

• Rascunho: registrado e nunca publicado. É o único que ainda pode ser excluído.
• Publicado: aparece no showcase do hotsite.
• Oculto: já foi publicado e depois saiu do showcase. Não pode mais ser excluído.

Há exportação em CSV do recorte filtrado, que segue a permissão global de exportar dados. Com o recorte vazio o botão fica desabilitado.

Registrar

O botão "Registrar ganhador" abre o formulário. O operador escolhe a origem e, depois, prêmio, apuração, data do prêmio e, se quiser, a foto do showcase.

Pelo sorteio, o campo "Número sorteado" busca no servidor por número, nome ou CPF/CNPJ completo e traz até 20 números por vez. Números já registrados como ganhador não aparecem. O prêmio é escolhido entre os prêmios de sorteio da campanha, e a referência da apuração é obrigatória — é ela que liga o ganhador ao resultado oficial, por exemplo "Loteria Federal 6078".

Pela posição premiada, a tela lista só as posições aprovadas na fila de apuração que ainda não viraram ganhador. Aqui não há seletor de prêmio: a tela mostra, sem permitir edição, o prêmio da posição escolhida. A apuração é opcional, e sem data vale a data do prêmio configurada na posição.

Para apurar o sorteio direto pelo resultado da Loteria Federal, com a lista do mais próximo e a revelação ao vivo em tela cheia, existe o botão "Sortear pela Loteria Federal", que tem artigo próprio.

O registro respeita as travas da campanha. A API recusa número que não existe na campanha, número já registrado como ganhador, número invalidado pelo cancelamento da nota que o gerou e prêmio acima do limite de prêmios por CPF ou por nota fiscal configurado na campanha. A mensagem de recusa aparece na tela.

As notas que formaram o número premiado

No ganhador de sorteio, tanto o registro quanto a edição mostram as notas que formaram o número: número da nota, série, valor, data da compra, anexo, link "Consultar na SEFAZ" quando a nota tiver consulta e se a nota está ativa ou cancelada. O anexo aparece conforme o tipo: imagem vira miniatura, PDF abre em nova aba e outro endereço vira o link "Abrir nota". Há link direto para a aba de notas do participante.

Isso existe porque a nota só é conferida quando a pessoa ganha.

Lista de notas vazia não é falta de dado: a origem informa se o número veio de cadastro, story, carga manual ou integração — casos em que não há nota nenhuma.

Se a nota for cancelada depois do registro, a edição mostra o aviso e não bloqueia publicar. Quem decide é o operador, vendo o aviso.

No ganhador de posição premiada esse bloco não existe: a nota dele aparece na apuração.

Editar

A edição corrige o que aparece no showcase: prêmio, apuração, data do prêmio e foto. O vencedor não muda pela edição. Para trocar o vencedor de um rascunho, o caminho é excluir o registro e cadastrar o certo.

Publicar e ocultar

Publicar coloca o ganhador no showcase do hotsite, com nome, cidade e prêmio. Ocultar tira do showcase sem apagar o registro, e ele pode ser publicado de novo. Repetir uma das duas ações não causa efeito novo.

A exclusão só funciona enquanto o ganhador nunca foi publicado. Depois de publicado, o registro fica — o caminho é ocultar.

Permissões

Registrar e sortear pela Loteria Federal seguem a permissão de criar ganhadores. Editar, ocultar e publicar seguem a permissão de editar ganhadores — não existe permissão separada para ocultar e publicar. Excluir segue a permissão de excluir ganhadores. Exportar segue a permissão global de exportar dados.

Sobre a data do prêmio

A data do prêmio é uma data pura: só o dia importa, e ela é exibida exatamente como foi gravada, sem conversão de fuso. Nos filtros de período dos ganhadores vale o dia gravado.

Ganhadores é o passo final: é o que o participante vê na página pública de ganhadores do hotsite. Todo ganhador nasce como rascunho, e enquanto não é publicado ele não aparece para ninguém.

Cinco orientações úteis:

Existem dois caminhos, e eles não se misturam. O do sorteio parte do número que saiu; o da posição premiada parte de uma posição já aprovada na fila de apuração. Se a posição não aparece na lista, ela ainda não foi aprovada ou já virou ganhador.

No sorteio, a referência da apuração é obrigatória. Quem usa o botão "Sortear pela Loteria Federal" já recebe essa referência preenchida com o concurso e a data.

No ganhador de sorteio, o painel mostra as notas que formaram o número. Se alguma delas tiver sido cancelada depois do registro, a tela avisa, mas não impede a publicação — a decisão é do cliente, e vale registrar essa decisão antes de publicar.

Publicar e ocultar são reversíveis. Excluir não, e só funciona enquanto o selo é rascunho. Depois de publicado, o caminho para tirar do ar é ocultar.

O nome exibido do ganhador vem do cadastro do participante e é lido em tempo real. Se o nome estiver errado, corrigir o cadastro do participante já corrige a lista.

• Falha: a posição premiada não aparece na lista para registrar ganhador.
• Possivel causa: ela ainda não foi aprovada na fila de apuração ou já virou ganhador.
• Como orientar: abra Gerenciar e Posições e confira a situação daquela posição. Só posição aprovada e que ainda não virou ganhador aparece aqui.
• Quando escalar: se a posição estiver aprovada, não tiver ganhador registrado e continuar ausente da lista, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o botão "Registrar como rascunho" fica desabilitado no sorteio.
• Possivel causa: falta escolher o número sorteado ou preencher a apuração, que é obrigatória no sorteio.
• Como orientar: escolha o número e informe a referência da apuração, por exemplo o concurso da Loteria Federal.
• Quando escalar: se os dois estiverem preenchidos e o botão continuar desabilitado, abrir issue no Jira (projeto DEV) com prints.

• Falha: o registro é recusado dizendo que o número foi invalidado pelo cancelamento da nota.
• Possivel causa: a nota que gerou aquele número foi cancelada, e número invalidado não pode virar ganhador.
• Como orientar: explique que o número deixou de valer. No sorteio pela Loteria Federal, escolha o próximo suplente da lista.
• Quando escalar: se a nota estiver ativa e o número continuar recusado, abrir issue no Jira (projeto DEV) com o número e a mensagem.

• Falha: o registro é recusado por limite de prêmios.
• Possivel causa: o participante ou a nota já atingiu o limite de prêmios por CPF ou por nota fiscal configurado na campanha.
• Como orientar: confira os limites em Limites e validações no formulário da campanha. No sorteio pela Loteria Federal, passe para o próximo suplente.
• Quando escalar: se o participante estiver abaixo do limite e o registro continuar recusado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o ganhador não aparece na página de ganhadores do hotsite.
• Possivel causa: o registro existe, mas está como rascunho ou foi ocultado.
• Como orientar: confira o selo na coluna de publicação e use Publicar no registro.
• Quando escalar: se o ganhador estiver publicado e não aparecer no hotsite, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: não dá para excluir um ganhador.
• Possivel causa: ele já foi publicado alguma vez e está com o selo publicado ou oculto. A exclusão vale somente para rascunho.
• Como orientar: explique que o registro publicado não se apaga. Use Ocultar para tirar do showcase mantendo o registro.
• Quando escalar: não é falha. Só escalar se a recusa aparecer em ganhador com selo de rascunho.

• Falha: a tela avisa que uma nota do número premiado está cancelada.
• Possivel causa: a nota que formou o número foi cancelada depois do registro. O aviso é informativo e não bloqueia publicar.
• Como orientar: explique que a decisão é do operador. Confira a nota pelo link para a aba de notas do participante e registre a decisão antes de publicar.
• Quando escalar: se o cliente quiser uma trava que impeça publicar nesse caso, abrir issue no Jira (projeto DEV) descrevendo o pedido.

• Falha: o bloco de notas do número premiado aparece vazio.
• Possivel causa: o número não veio de nota. A origem informa se ele veio de cadastro, story, carga manual ou integração.
• Como orientar: leia a origem do número na própria tela. Vazio não é falta de dado nesses casos.
• Quando escalar: se a origem indicar nota e o bloco continuar vazio, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o nome do ganhador está errado na lista.
• Possivel causa: o nome vem do cadastro do participante e é lido em tempo real.
• Como orientar: corrija o nome na edição do cadastro do participante em Gerenciar e Participantes. A lista de ganhadores passa a exibir o nome novo.
• Quando escalar: se o cadastro estiver corrigido e a lista continuar com o nome antigo, abrir issue no Jira (projeto DEV) com as evidências.