Visão Geral do Hotsite V2

O Hotsite V2 é a aplicação web que mostra as campanhas promocionais ao participante e permite os fluxos principais: cadastro, login, edição do cadastro, cadastro de compras, consulta de números, saldo, pontos e posições, regulamento, política de privacidade e ganhadores.

Ele não é o painel administrativo. Banners, cores, campos do formulário, produtos, lojas, regras de geração de chances, documentos e ganhadores são configurados no painel e lidos da API Premify V2.

Cada campanha vive em um endereço próprio: /campanha/nome-da-campanha. O trecho depois de /campanha/ é a "rota" da campanha. Com ela o hotsite busca na API a identidade, o visual, os documentos e as regras daquela promoção. A raiz do site (só o domínio, sem rota) não tem conteúdo e mostra "Página não encontrada" de propósito. A única exceção é o Portal Premify, em /portal.

Hoje existem dois hotsites separados, que não se misturam:

• Hotsite novo: site.premify.com.br, usa a API Premify V2 e é atualizado automaticamente a cada nova versão.
• Hotsite legado: premiada-v2.premify.com.br, ligado ao sistema anterior, com publicação manual.

Sistemas que o hotsite novo usa:

• API Premify V2: campanha, participante, notas, números, saldo, pontos, posições e ganhadores.
• ViaCEP: preenche rua, bairro e cidade a partir do CEP.
• Serviço de consulta de NFC-e: lê os dados do cupom fiscal pelo QR Code, nas campanhas que ligaram esse recurso.
• Inteligência artificial (Gemini): sugere os produtos participantes a partir dos itens do cupom. É opcional; sem ela o participante escolhe os produtos à mão.

O que o hotsite não faz:

• não administra campanhas nem cadastra produtos e lojas;
• não define as regras da promoção (quem participa, quanto vale cada chance, limites);
• não faz sorteio nem apuração;
• não valida a nota fiscal por conta própria: quem aceita ou recusa é a API;
• não guarda os dados principais de participantes e notas.

O hotsite é a vitrine e o ponto de operação do participante. Tudo o que o cliente quer mudar (banner, regulamento, campos pedidos no cadastro, regras) é feito no painel da Premify e aparece no hotsite em pouco tempo, normalmente em até um minuto. Se uma regra parecer errada no site, ela quase sempre vem da configuração da campanha, e não do site.

• Falha: o participante abre o domínio sem o nome da campanha e vê "Página não encontrada".
• Possivel causa: comportamento esperado. O site só existe dentro de uma campanha ou do portal.
• Como orientar: envie o link completo da campanha ou o endereço do portal (site.premify.com.br/portal).
• Quando escalar: não é falha.

• Falha: o participante diz que o cadastro ou a senha "sumiram" depois de trocar de site.
• Possivel causa: ele entrou no hotsite legado (premiada-v2.premify.com.br) e não no novo, ou o contrário. Os dois são sistemas separados.
• Como orientar: confirme o endereço que ele está usando e indique o link oficial da campanha.
• Quando escalar: se a campanha estiver no hotsite certo e o cadastro não for encontrado, abrir issue no Jira (projeto DEV) com o CPF e o link.

• Falha: uma regra da promoção aparece diferente do combinado com o cliente.
• Possivel causa: a regra vem da configuração da campanha no painel e é aplicada pela API.
• Como orientar: confira a configuração da campanha no painel antes de tratar como erro do site.
• Quando escalar: se a configuração estiver certa e o site se comportar diferente, abrir issue no Jira (projeto DEV) com prints e o link.