Posições da campanha e o pool de prêmios

É a aba Posições da campanha: o pool de posições que a campanha vai distribuir. Cada posição tem uma data e um número, e pode ser premiada (ligada a um prêmio do catálogo) ou não premiada. A aba só aparece quando a campanha tem a modalidade de posição premiada marcada.

O título da tela e a aba dizem apenas Posições, e não posições premiadas, porque nem toda posição do pool premia.

A tela lista o pool com paginação, busca, filtros e ordenação feitos no servidor. A busca casa com o número da posição ou com o nome do prêmio. Os cartões do topo trazem as contagens do pool inteiro e funcionam como atalho de filtro — eles não respondem ao filtro de situação, de propósito.

Cada posição tem três marcas independentes, que respondem perguntas diferentes:

• Ativa: a posição está valendo. É o badge clicável que liga e desliga.
• Premiada ou não premiada: paga prêmio ou não. Aparece na coluna do prêmio.
• Distribuída: já foi entregue a um participante. É o marcador ao lado da posição, com a data no tooltip.

No formulário, o tipo da posição é um seletor entre premiada e não premiada. Em posição não premiada o seletor de prêmio desaparece, porque o servidor descarta o prêmio nesse caso. Posição premiada exige um prêmio, e o prêmio tem de ser da mesma campanha e, em vínculo novo, estar ativo. O seletor lista só os prêmios ativos de posição premiada; na edição entra também o prêmio que a posição já tem, mesmo inativo.

A rede da posição

A rede segue a campanha, no cadastro manual e na importação. A tela consulta o servidor para saber se a campanha distribui as posições por rede — o que é definido pela opção de premiação por rede nas regras da modalidade Posição premiada. Em campanha por rede, o seletor de rede é obrigatório e lista só as redes ativas. Nas demais, o seletor aparece desabilitado com a frase de que a campanha não distribui as posições por rede. Enquanto essa consulta não volta, salvar e importar ficam bloqueados. Na edição, a rede inativa que a posição já tinha continua na lista, marcada como inativa.

O motivo é simples: posição do lado errado fica no pool e nunca sai, sem erro em lugar nenhum.

A data da posição

A data da posição tem de ser um dia em que ela ainda pode sair: dentro do período da campanha e não anterior a hoje. Fora disso o servidor recusa, porque a posição só é sorteada no dia exato da sua data e fora do período não entra nota nenhuma. Na edição, a data só é conferida quando muda — é isso que mantém editável o acervo de posições antigas. Campanha inteiramente no passado não aceita posição nova, e esse é o efeito pretendido.

A exclusão responde com um corpo explicando o que aconteceu: se a posição já foi premiada ou tem participante vinculado, o servidor inativa em vez de excluir, e a tela exibe a mensagem que veio.

Também não se mexe no prêmio de uma posição já distribuída: ela não troca de prêmio nem vira não premiada. Os demais campos dela continuam editáveis. Pelo mesmo motivo, prêmio já entregue não muda mais de nome nem de valor — nome e valor são lidos ao vivo pela fila de apuração, pelo e-mail de aprovação e pela tela de Ganhadores. Para pagar outra coisa, o caminho é cadastrar outro prêmio e vinculá-lo às posições que ainda não saíram.

Importação do pool

A aba tem importação por arquivo. O layout é data, posição e se é premiável. O arquivo não traz prêmio nem rede: o operador escolhe um prêmio ativo do catálogo antes do arquivo, e todas as linhas premiáveis apontam para ele; as não premiadas ficam sem prêmio. A coluna de premiável aceita verdadeiro ou falso, um ou zero, S ou N, SIM ou NAO, V ou F.

Atenção: no sistema anterior essa coluna tinha o sentido oposto. A tela avisa, para ninguém reaproveitar um arquivo antigo sem conferir a marcação. Linha em layout anterior vira erro de linha com a mensagem explicando o layout atual.

A rede vem só do formulário, com a mesma regra do cadastro manual descrita acima: obrigatória em campanha por rede e desabilitada nas demais.

Há modelo para download. A linha de exemplo do modelo pode ficar no arquivo: a importação reconhece o marcador e descarta a linha antes de qualquer validação, registrando isso nos avisos. Reimportado sem preenchimento, o modelo gera zero posições, nenhum erro e só esse aviso.

O relatório da importação não é sucesso ou falha: traz o total de linhas, quantas entraram, quantas premiadas, quantas não premiadas, quantas foram ignoradas por repetição, os erros por linha e os avisos. A tela só recarrega a lista quando algo de fato entrou.

Toda importação que grava ao menos uma posição vira um lote, com histórico e opção de desfazer. O desfazer é tudo ou nada: se alguma posição do lote já foi distribuída ou tem participante vinculado, nada é removido e a mensagem diz quantas. As posições saem de verdade, inclusive as editadas à mão depois da importação — elas continuam sendo do lote. O arquivo em si não é guardado, só o nome.

Se o operador já escolheu prêmio, rede ou arquivo e clicar em cancelar no formulário de importação, a tela pergunta se quer sair sem salvar.

O pool é a lista de posições que a campanha vai premiar. Quem monta é o operador, à mão ou por arquivo, e o prêmio sai sempre do catálogo de prêmios da campanha.

Três avisos que evitam retrabalho com o cliente:

A data da posição precisa ser um dia futuro dentro do período da campanha. A posição sai no dia exato da data dela — não é "a partir de". Data no passado o sistema recusa, porque a posição nunca sairia.

Se a campanha premia por rede, toda posição precisa de rede, e vice-versa. Posição do lado errado fica no pool para sempre, sem erro aparente.

Depois que uma posição foi distribuída, o prêmio dela está fechado. Nome e valor do prêmio entregue não mudam mais, porque já foram comunicados ao participante. Se o cliente quer pagar outra coisa, o caminho é um prêmio novo nas posições que ainda não saíram.

Se o cliente vai reaproveitar um arquivo do sistema antigo, avise antes: a coluna que diz se a posição premia tinha o sentido invertido lá.

• Falha: a aba Posições não aparece na campanha.
• Possivel causa: a modalidade de posição premiada não está marcada na campanha.
• Como orientar: abra o formulário da campanha e marque a modalidade Posição premiada.
• Quando escalar: se a modalidade estiver marcada e a aba continuar ausente, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o servidor recusa a data da posição.
• Possivel causa: a data está fora do período da campanha ou é anterior a hoje. A posição só sai no dia exato da data dela.
• Como orientar: escolha uma data dentro do período da campanha e não anterior a hoje. Se a campanha inteira já passou, não dá para cadastrar posição nova.
• Quando escalar: se a data estiver dentro do período e a recusa continuar, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o seletor de rede aparece desabilitado no cadastro ou na importação.
• Possivel causa: a campanha não distribui as posições por rede. Nesse caso a posição entra sem rede, de propósito.
• Como orientar: explique que a rede segue a configuração da campanha. Se o cliente quer premiar por rede, a opção fica nas regras da modalidade Posição premiada, e a troca tem restrições quando já há posições no pool.
• Quando escalar: se a campanha premiar por rede e o seletor continuar desabilitado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: as posições foram importadas e nenhuma é distribuída.
• Possivel causa: as posições entraram do lado errado do escopo. Campanha que premia por rede exige rede em toda posição, e campanha sem rede exige posição sem rede.
• Como orientar: confira o escopo da campanha na regra da modalidade e a rede das posições. Se o lado estiver errado, desfaça a importação e reimporte com a rede correta.
• Quando escalar: se o escopo estiver correto e as posições continuarem sem sair, acionar o time de desenvolvimento urgentemente e abrir issue no Jira (projeto DEV) com as evidências.

• Falha: o seletor de prêmio da posição aparece vazio.
• Possivel causa: a campanha não tem prêmio ativo de posição premiada cadastrado.
• Como orientar: cadastre o prêmio na aba Prêmios da campanha com a modalidade de posição premiada e volte à aba Posições. O próprio seletor explica isso.
• Quando escalar: se houver prêmio ativo de posição premiada e o seletor continuar vazio, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: não dá para desfazer a importação do pool.
• Possivel causa: alguma posição do lote já foi distribuída ou tem participante vinculado. O desfazer é tudo ou nada.
• Como orientar: a mensagem do servidor diz quantas posições impedem. Nada foi removido. Ajuste as posições restantes manualmente ou inative as que não devem valer.
• Quando escalar: se nenhuma posição do lote tiver sido distribuída e o desfazer continuar sendo recusado, abrir issue no Jira (projeto DEV) com as evidências.

• Falha: não dá para alterar o nome ou o valor de um prêmio.
• Possivel causa: esse prêmio já tem posição distribuída, registro aprovado na apuração ou ganhador apontando para ele.
• Como orientar: explique que nome e valor de prêmio entregue não mudam, porque já foram comunicados ao participante. Imagem, ordem e rede seguem editáveis. Para pagar outra coisa, cadastre um prêmio novo.
• Quando escalar: não é falha. Só escalar se a recusa aparecer em prêmio que nunca saiu.