Resumo das mudanças do Painel Admin de agosto a outubro

Entre 14 de agosto e 30 de outubro de 2026 o Painel Admin recebeu 196 alterações. A automação que deveria publicar uma nota por alteração ficou parada nesse período, por isso este documento reúne tudo em um único resumo.

As mudanças mais importantes para o dia a dia são: a fila de apuração passou a trabalhar por posição; surgiram as telas de Participantes, Ganhadores, Stories e Resgates no grupo Gerenciar; a tela inicial virou um dashboard completo e personalizável; foi criada a aba Relatórios; chegaram os pontos de fidelidade com troca por prêmios, a área Base de participantes com convites por e-mail, as telas embarcadas para a Kaply e o sorteio pela Loteria Federal direto no painel. O painel também passou a respeitar as permissões de cada papel e pode ser usado em português, espanhol e inglês.

Configuração da campanha

• Nova aba Formulário no hub da campanha para configurar os formulários de cadastro do participante e de nota fiscal: ligar e desligar campos, mudar rótulos, definir obrigatoriedade, reordenar arrastando e criar campos personalizados. A tela explica o que cada coluna faz (PR 30 e 78).
• Nova aba Posições para montar o pool de posições premiadas e não premiadas da campanha, com cadastro manual, importação por arquivo com modelo para baixar, paginação, filtros, histórico de importações e botão para desfazer um lote inteiro (PR 31 32 91 e 94).
• A posição premiada passou a usar somente o catálogo de prêmios da campanha. A data da posição precisa estar dentro do período da campanha e não pode ser anterior a hoje. Em campanha organizada por rede o campo Rede é obrigatório e só lista redes ativas (PR 83 87 104 e 108).
• Nova aba Vídeos para cadastrar os vídeos em MP4 que o hotsite exibe no resultado da posição premiada (PR 33).
• O hub da campanha mostra apenas as abas e cartões dos módulos que a campanha realmente usa. A aba Gamificações foi escondida (PR 76 e 77).
• Nova aba Stories com o cadastro das artes que o participante compartilha e a base de geração "Por story" nas regras (PR 165 e 167).
• Nova aba Portal para decidir se a campanha aparece no portal de campanhas e caprichar no cartão com título e descrição curta e banner e marcas e categorias (PR 222).
• Na aba Hotsite entraram as chaves dos botões de compartilhar e os campos de TikTok e de WhatsApp de participação. O endereço da pré-visualização abre o hotsite em uma guia nova e o período da campanha aparece no horário local (PR 99 162 e 179).
• Nova chave para ligar a leitura de QR Code do cupom fiscal no hotsite. O recurso está marcado como BETA e pede confirmação (PR 182).
• Seção Estados participantes no cadastro da campanha: a campanha pode ser nacional ou valer só para estados escolhidos (PR 158).
• Seção Comunidade no WhatsApp com o link de convite e o identificador da comunidade na Kaply. Com isso o hotsite mostra o botão de entrar na comunidade e a entrada pode render chances extras (PR 189).
• Na aba Conteúdos o e-mail de aprovação ganhou lista de variáveis disponíveis, pré-visualização, aviso quando falta prêmio e um modo guiado para montar a mensagem sem HTML. A aba também passou a aceitar o PDF do regulamento de pontos (PR 90 93 e 200).
• Cadastro de campanha mais prático: é possível criar um novo responsável sem sair do formulário; o painel pede confirmação antes de fechar um formulário alterado; data vazia no período não quebra mais o salvar; "Aceite obrigatório" e "Usa aceite" passaram a andar juntos (PR 127 170 171 e 203).
• Produtos e lojas podem ser vinculados à campanha em lote, com seleção múltipla e seleção por rede. Antes era um por vez (PR 128).
• Cada vínculo de loja com a campanha pode dar chance extra (PR 82).
• O aviso da campanha explica que a exigência de anexar a foto da nota agora é configurada no formulário de nota fiscal. A ajuda dos limites de notas por CPF foi corrigida (PR 133 e 150).

Regras de geração de números e chances

• Uma mesma modalidade pode ter várias regras de geração que somam entre si. Exemplo: números por valor da nota mais chances extras por entrar na comunidade (PR 86 e 190).
• Novas bases de geração: Por cadastro, Por entrada na comunidade e Pontos por produto. As duas primeiras só aparecem quando a modalidade é Sorteio (PR 174 177 e 189).
• A série do número da sorte saiu do modal da regra e passou a ser escolhida no cartão da modalidade Sorteio. Ela é obrigatória e fica travada depois de uso. Uma série inativa que já está em uso continua aparecendo na lista (PR 118 196 202 e 203).
• Alterar uma regra ou trocar e remover regras de uma modalidade em campanha em andamento agora pede confirmação e só é permitido para quem tem permissão. O modal da regra ganhou a aba Histórico com todas as alterações em horário de Brasília (PR 137 143 151 e 153).
• A chave da regra nova já vem preenchida como "padrao". Desmarcar uma modalidade por engano não apaga mais a regra configurada (PR 75 e 127).
• Saíram campos que não tinham efeito: valor mínimo do acelerador e o grupo "Produtos aceleradores" (PR 80 e 201).
• O prefixo da série passou a ocupar a primeira casa do número e cada parte tem no máximo 5 dígitos (PR 34).

Apuração e ganhadores

• A fila de apuração em Gerenciar passou a listar posições e não notas. Uma nota que gerou várias posições aparece em várias linhas. A fila tem filtros no servidor, contagem por situação, cores por desfecho e um modal com o contexto do participante (PR 36 e 39).
• Aprovar uma posição individualmente agora pede confirmação, porque a aprovação dispara e-mail para o participante (PR 37).
• O endereço da tela guarda página e filtros e o modal aberto. Dá para atualizar a página ou mandar o link para um colega sem perder o recorte (PR 38).
• Exportação do relatório de apuração em CSV (PR 44).
• A fila mostra "Prêmio devolvido ao pool" quando a reprovação já devolveu o prêmio e "Rede não encontrada" quando a rede não existe mais (PR 102 e 103).
• Nova tela Gerenciar > Ganhadores com filtros, registro de ganhador nas duas modalidades, edição, publicar e ocultar e excluir, e exportação CSV. Os modais de sorteio mostram as notas que formaram o número premiado (PR 51 e 188).
• Botão Sortear pela Loteria Federal: busca o resultado do concurso, apura o número premiado com ganhador e suplentes por proximidade e registra o ganhador como rascunho (PR 223).
• A revelação do sorteio exibe o logo da campanha configurado no hotsite (PR 226).

Participantes e notas fiscais

• Nova tela Gerenciar > Participantes com números da sorte, notas, posições e campos personalizados de cada inscrito, ativação e inativação da participação e exportação CSV do recorte filtrado. Os dados extras usam o rótulo cadastrado no formulário (PR 40 41 e 42).
• Edição do cadastro do participante pelo painel, incluindo a opção "Outro" no campo sexo e a razão social para participantes com CNPJ (PR 85 183 e 203).
• Botão Cancelar a nota com motivo obrigatório. O cancelamento mostra quais chances foram invalidadas e não tem como reativar (PR 160).
• A coluna antes chamada Produtos virou "Valor dos produtos". O detalhe da nota só aparece para quem tem permissão de ler notas (PR 130).
• Nota em PDF ou em link abre em nova aba em vez de aparecer como imagem quebrada. Quando a nota veio da leitura do QR Code aparece o link "Consultar na SEFAZ". A miniatura da foto enviada pelo hotsite novo voltou a aparecer (PR 176 194 e 195).
• Nova aba Saldo no detalhe do participante com o saldo por regra e modalidade, extrato e ajuste manual. A coluna Saldo da listagem saiu porque mostrava sempre zero (PR 146 e 156).

Pontos de fidelidade e resgates

• Campanhas de pontos: configuração dos pontos por produto, acompanhamento e ajuste dos pontos de cada participante com extrato (PR 177).
• Prêmios da modalidade Pontos têm custo em pontos e estoque. A campanha ganhou prazo de resgate em dias (PR 178).
• Nova tela Gerenciar > Resgates com a fila de pedidos por situação. Cada pedido mostra o saldo de pontos do participante e um alerta quando o saldo não cobre o pedido (PR 178 191 e 197).
• O extrato mostra a origem do movimento como convite ou prêmio e reconhece o crédito e o estorno de convite (PR 198).

Stories

• A moderação dos stories enviados pelos participantes fica em Gerenciar > Stories, separada da configuração das artes (PR 172).

Dashboard e relatórios

• A tela inicial virou o dashboard da campanha com indicadores e gráficos que aparecem conforme o que a campanha usa: conversão em nota, recorrência, funil, mapa de calor por dia e hora, projeção até o fim, alertas e comparação com o período anterior (PR 134 136 141 e 142).
• Filtros por período, rede, loja, estado, cidade, canal e produto, com seleção múltipla. Gráficos de produtos mais comprados, cidades com mais notas e mapa de calor geográfico de onde os participantes moram e compram (PR 138 145 148 152 e 181).
• O dashboard é personalizável: cada usuário pode arrastar, redimensionar, incluir e remover gráficos (PR 139 144 e 149).
• Nova aba Relatórios no menu com um relatório por aba: Participantes, Notas fiscais, Números da sorte, Posições premiadas, Apuração e Apuração padrão SPA. É possível salvar filtros em "Meus relatórios" e há a aba Resultado da campanha (PR 159 164 166 169 186 e 187).

Base de participantes e convites

• Novo grupo Base com visão geral da base entre campanhas, segmentos como adormecidos e campeões e fiéis com exportação, e o perfil do participante com todas as suas campanhas (PR 184 e 187).
• Convites por e-mail para a base: assistente em 4 passos com público e benefício e mensagem e revisão, envio na hora ou agendado, acompanhamento com funil de quem recebeu e clicou e se inscreveu e mandou nota, e cancelamento pelo Master (PR 192 193 e 197).

Kaply e telas embarcadas

• Telas que abrem dentro do sistema da Kaply para o cliente criar e acompanhar ações de comunidade com jogos como raspadinha e roleta e chute a gol. Inclui o campo "como usar o prêmio", a prévia do jogo e o link do post pronto para cada canal do cliente (PR 199 204 206 207 218 e 219).
• Na lista de campanhas do ambiente compartilhado da Kaply aparecem filtro e coluna "Cliente" (PR 216).

Cadastros gerais

• Nova tela de Responsáveis. Antes não havia como cadastrar o responsável e por isso não era possível criar campanha em cliente novo (PR 35).
• Produtos e lojas: upload de imagem no lugar de URL, estado da loja escolhido em lista, correções na edição que apagava dados, nome de produto com até 500 caracteres. A validação de EAN foi retirada (PR 66 68 69 79 e 126).
• O documento da loja passou a ser sempre CNPJ obrigatório (PR 168).
• Importação por arquivo com histórico e desfazer nas telas de Lojas, Produtos, Redes e Blacklist (PR 96 98 101 106 e 129).
• Prêmios ganharam a modalidade no cadastro e os seletores filtram por tipo. Novo item de menu Gerenciar prêmios (PR 65 e 100).
• O grupo Cadastros passou a vir antes de Campanhas no menu (PR 97).

Usuários, permissões e acesso

• Telas de "Esqueci minha senha" com código por e-mail, definição de senha no primeiro acesso e tela Meu perfil para trocar nome e senha (PR 112 119 e 121).
• Papéis sem o campo nível e com três permissões globais novas: aprovar notas, aprovar financeiro e exportar dados. Menu, telas e botões passaram a aparecer só para quem tem a permissão do papel (PR 114 122 123 124 e 125).
• A sessão é renovada enquanto a pessoa usa o painel e há aviso antes de expirar. Publicações de nova versão não deslogam mais os usuários (PR 131 e 163).
• Área interna para a equipe Premify acessar o painel de cada cliente e cadastrar cliente novo, restrita à rede do escritório (PR 70 71 72 73 74 e 117).
• Tela Agentes de IA para conectar assistentes como Claude e ChatGPT aos dados do painel com token pessoal ou autorização de acesso (PR 154 155 e 157).
• O painel envia à API o endereço de quem está usando. Antes todos os operadores dividiam o mesmo limite de tentativas de login (PR 180).

Tradução e aparência

• O painel pode ser usado em português, espanhol e inglês pelo seletor de idioma no menu do usuário. O texto em português continua igual. O calendário segue o idioma escolhido (PR 205 208 209 210 211 212 213 214 215 217 220 221 e 224).
• Nova identidade visual com logo da Premify nos temas claro e escuro e trilha de navegação acima do título em todas as telas (PR 57 58 89 e 175).
• Erros ao salvar aparecem em janela por cima da tela e o sucesso aparece em aviso curto no canto. Quando a API cai a mensagem diz o motivo. Operações longas como importação e exportação têm tempo limite maior (PR 110 111 113 115 116 140 e 147).
• Correções de acesso: o login não fica mais preso na tela de entrada e modais altos podem ser rolados até o topo (PR 47 49 59 e 88).

O painel mudou bastante e muitas telas são novas. O time precisa conhecer principalmente:

• A fila de apuração agora é por posição. Uma nota pode aparecer em várias linhas.
• Participantes, Ganhadores, Stories e Resgates ficam em Gerenciar e escolhem a campanha por um seletor no topo.
• Cada papel só vê os menus e botões que a permissão libera. Se um usuário diz que "o botão sumiu" a primeira coisa a conferir é o papel dele.
• Regras de geração agora somam dentro da mesma modalidade e a série do sorteio é escolhida na modalidade e não mais na regra.
• Alterar regras de campanha em andamento exige confirmação e fica registrado no histórico da regra.
• Os números do dashboard e dos relatórios dependem dos filtros escolhidos. Ao comparar com o cliente confirme que os dois usam o mesmo período e os mesmos filtros.

O Painel Admin ganhou novas ferramentas para acompanhar e operar a campanha: dashboard com indicadores e gráficos que podem ser organizados do seu jeito, relatórios com filtros salvos, consulta e edição de participantes, cancelamento de notas com motivo, apuração por posição com confirmação antes de aprovar e registro de ganhadores com sorteio pela Loteria Federal.

Também chegaram os programas de pontos com troca por prêmios, os convites por e-mail para a base de participantes e a opção de usar o painel em espanhol ou inglês. Cada usuário enxerga apenas o que o seu perfil de acesso permite.

• Se um usuário não vê um menu ou botão, confira as permissões do papel dele antes de tratar como erro.
• Mudanças em regras de geração de campanha em andamento afetam a geração de chances dali em diante. O painel pede confirmação e registra quem alterou.
• Cancelar uma nota invalida as chances que ela gerou e não pode ser desfeito.
• Desfazer uma importação remove o lote inteiro. O painel mostra quantos itens serão removidos e pede confirmação antes.
• O prêmio de Pontos com estoque em branco fica sem limite.
• A leitura de QR Code do cupom fiscal está em BETA.
• Lojas antigas cadastradas com CPF continuam aparecendo mas novas lojas exigem CNPJ.
• A tradução cobre os textos das telas. Nomes cadastrados como campanhas e lojas e redes continuam aparecendo como foram cadastrados.

Escalar para o time de desenvolvimento quando:

• Um usuário com a permissão correta recebe "sem permissão" ou não vê um botão que deveria ver.
• O dashboard ou um relatório mostra números que não batem com a exportação da mesma tela e com os mesmos filtros.
• A importação de arquivo termina com erro sem explicar a linha ou o motivo.
• O sorteio pela Loteria Federal não encontra o concurso ou apura um ganhador inesperado.
• O saldo de pontos ou o estoque de um prêmio fica diferente do extrato.
• A sessão cai durante o uso mesmo com o painel aberto e em atividade.

Repositório: Premify-Gelt/premify-V2-Painel
PRs: 30 a 226
Total de PRs mesclados no período de 14 de agosto a 30 de outubro de 2026: 196
Último commit: 0dd11a8b945c0396410b2c99b93e7d4393c98304