🔐 Como Funciona a Validação de Licença Premium

📋 Visão Geral

O sistema Halftone 3D Panel Generator usa uma validação de licença para controlar o acesso às funcionalidades premium. Esta documentação explica como funciona esse processo.

🗄️ Onde a Licença é Armazenada

localStorage do Navegador

A licença premium é armazenada no localStorage do navegador do usuário. Isso significa:

✅ Vantagens:

• Funciona offline (após primeira validação)
• Não requer login ou conta
• Rápido e eficiente
• Persiste entre sessões do navegador

⚠️ Limitações:

• Específico para cada navegador
• Perdido se limpar dados do navegador
• Não sincroniza entre dispositivos
• Não funciona em modo anônimo/privado (alguns navegadores)

Chave de Armazenamento

A licença é salva com a chave: halftone3d_premium

✅ Como Funciona a Validação

1. Verificação ao Carregar a Página

Quando você acessa a página de compra, o sistema:

1. Verifica se existe uma licença no localStorage
2. Verifica se a licença está ativa (active: true)
3. Verifica se a licença não expirou (se houver expiresAt)
4. Se tudo estiver OK, desabilita o botão de compra

2. Verificação ao Clicar em "Comprar Premium"

Antes de criar qualquer pagamento, o sistema:

1. Verifica novamente se já tem licença válida
2. Se tiver, bloqueia a criação do pagamento
3. Mostra mensagem informativa
4. Oferece botão para ir ao gerador

3. Verificação Periódica

O sistema verifica a cada 2 segundos se o status da licença mudou:

• Se você ativar uma licença em outra aba, a página atualiza automaticamente
• Se a licença expirar, o botão de compra é habilitado novamente

🚫 Prevenção de Pagamento Duplicado

Como Funciona

O sistema impede que você pague mais de uma vez:

1. Ao carregar a página:
   • Se já tem licença válida → Botão desabilitado
   • Mensagem: "Você já possui Premium ativo"
2. Ao clicar em "Comprar Premium":
   • Verifica novamente antes de criar pagamento
   • Se já tem licença → Bloqueia e mostra mensagem
3. Proteção em múltiplas camadas:
   • Verificação no localStorage
   • Verificação no evento de clique
   • Verificação periódica

🔍 Como Verificar se Você Tem Licença

Método 1: Interface do Site

1. Acesse a página de compra
2. Se o botão estiver desabilitado e mostrar "Você já possui Premium ativo"
3. A mensagem mostrará seu código de licença e data de expiração

Método 2: Console do Navegador

1. Abra o Console do Navegador (F12 → Console)
2. Digite:
   JSON.parse(localStorage.getItem('halftone3d_premium'))
3. Você verá os dados da sua licença

Método 3: Verificar no Aplicativo

1. Abra o gerador
2. Se você tem acesso a funcionalidades premium, você tem licença ativa

🧪 Licenças Demo vs Licenças Reais

Licença Demo (para testes)

• Código: Começa com demo- (ex: demo-1767219451325)
• Validação: Não valida no servidor
• Uso: Apenas para testes locais
• Bloqueio: NÃO bloqueia pagamento (você pode comprar mesmo com demo ativa)

Licença Real (paga)

• Código: Formato H3D-XXXX-XXXX-XXXX-XXXX
• Validação: Valida no servidor
• Uso: Produção
• Bloqueio: Bloqueia pagamento (você já tem premium)

🗑️ Como Remover/Limpar Licença

Se Você Quiser Testar Novamente

Método 1: Console do Navegador

Depois recarregue a página (F5)

Método 2: Limpar Dados do Navegador

• Chrome/Edge: Configurações → Privacidade → Limpar dados de navegação
• Firefox: Configurações → Privacidade → Limpar dados
• Safari: Preferências → Privacidade → Gerenciar dados do site

Método 3: Modo Anônimo

• Abra uma janela anônima/privada
• A licença não estará disponível

⚠️ Problemas Comuns

"Não consigo comprar mesmo sem licença"

Possíveis causas:

1. Licença demo ativa (não bloqueia, mas pode confundir)
2. Licença expirada ainda no localStorage
3. Cache do navegador

Solução:

1. Limpe o localStorage (veja seção acima)
2. Recarregue a página (Ctrl+F5 ou Cmd+Shift+R)
3. Tente novamente

"Paguei mas não apareceu premium"

Possíveis causas:

1. Webhook ainda não processou
2. Licença não foi ativada no localStorage
3. Problema de conexão

Solução:

1. Aguarde alguns segundos (webhook pode demorar)
2. Clique em "Já paguei - Verificar pagamento"
3. Digite o código de licença manualmente (se recebeu por email)
4. Verifique os logs do servidor (se tiver acesso)

"Perdi minha licença ao limpar o navegador"

Solução:

1. Se você tem o código da licença, digite manualmente na página de compra
2. O código está no email de confirmação (se configurado)
3. Entre em contato com suporte se não tiver o código

🔒 Segurança e Privacidade

O Que É Armazenado

• Código da licença (ex: H3D-XXXX-XXXX-XXXX-XXXX)
• Data de ativação
• Data de expiração (se houver)
• Status (ativo/inativo)

O Que NÃO É Armazenado

• Dados de pagamento
• Informações pessoais sensíveis
• Senhas
• Tokens de acesso

Validação no Servidor

Mesmo que a licença esteja no localStorage, o sistema também valida no servidor:

• Ao ativar uma licença, ela é validada no backend
• O servidor verifica se a licença existe e está válida
• O servidor verifica se não expirou

📞 Suporte

Se você tiver problemas com a validação de licença:

1. Verifique se tem licença ativa: Veja seção "Como Verificar se Você Tem Licença"
2. Limpe e tente novamente: Veja seção "Como Remover/Limpar Licença"
3. Entre em contato:
   • Forneça o código da licença (se tiver)
   • Informe o navegador e sistema operacional
   • Descreva o problema detalhadamente