PREVGAME — JORNADA DO FUTURO · PACOTE PARA CPANEL

COMECE AQUI
Este pacote já contém o jogo compilado, painel de administração, upload de
regulamento e patrocinador, perguntas, relatórios e banco de dados automático.

1. Extraia o ZIP no Gerenciador de Arquivos, na pasta pessoal da conta cPanel.
   Exemplo: /home/SEU_USUARIO/PrevGame_Jornada
   Use uma pasta fora de public_html. Não envie apenas index.html.

2. Crie ou escolha um subdomínio exclusivo para o jogo, com HTTPS ativo.
   Exemplo: jogo.seudominio.com.br
   Esta versão deve ser instalada na raiz desse subdomínio (caminho /).

3. No cPanel, abra Setup Node.js App / Configurar aplicativo Node.js.
   Clique em Create Application e preencha:

   Node.js version:          24.x, ou 22.x a partir de 22.13.0
   Application mode:         Production
   Application root:         PrevGame_Jornada
   Application URL:          jogo.seudominio.com.br, caminho /
   Application startup file: app.js

   Application root deve apontar para a pasta que contém app.js e package.json.
   Se o painel pedir caminho absoluto, use /home/SEU_USUARIO/PrevGame_Jornada.

4. Em Environment variables, cadastre:

   NODE_ENV        production
   PUBLIC_URL      https://jogo.seudominio.com.br
   ADMIN_PASSWORD  Sua senha exclusiva com pelo menos 16 caracteres
   DATA_DIR        /home/SEU_USUARIO/PrevGame_Jornada/dados

   Troque SEU_USUARIO e o domínio pelos seus dados reais.
   Não configure PORT ou HOST no cPanel: a conexão é gerenciada pelo Passenger.

5. Salve e clique em Start App ou Restart. Não é necessário abrir terminal nem
   deixar npm start rodando manualmente. O jogo está compilado; Run NPM Install
   não é necessário para iniciar esta versão. Não envie node_modules.

6. Acesse:
   Jogo:     https://jogo.seudominio.com.br/
   Painel:   https://jogo.seudominio.com.br/admin
   Login:    https://jogo.seudominio.com.br/login

   Administrador: nome de acesso admin e senha definida em ADMIN_PASSWORD.
   Participantes criam nome de acesso e senha pela tela de entrada.

PERGUNTAS COM IA
Para gerar perguntas automaticamente, acrescente OPENAI_API_KEY nas variáveis e
reinicie o aplicativo. A chave e os custos da API não estão incluídos. Sem chave,
o upload, revisão de regras e edição manual de perguntas continuam funcionando.

SE O CPANEL MOSTRAR APPLICATION MANAGER
Use as instruções alternativas em INSTALACAO_SERVIDOR.md. O inicializador app.js
atende também ao nome padrão do Passenger. O nome dos menus varia por hospedagem.

IMPORTANTE
- Se houver apenas Node.js 18 ou 20, solicite ao provedor Node.js 22.13+ ou 24.
- O armazenamento usa SQLite nativo; não precisa criar banco MySQL no cPanel.
- Use disco local persistente e mantenha a pasta dados fora da área pública.
- O arquivo .env.example é só um modelo; prefira as variáveis do painel.
- PUBLIC_URL deve ser exatamente o endereço HTTPS escolhido, sem /admin ou /prevgame.
- A instalação começa sem contas, partidas ou arquivos do ambiente original.
- Para atualizar uma instalação deste pacote, preserve dados e suas variáveis.

VERIFICAÇÃO REALIZADA
A inicialização CommonJS do app.js e a escolha da conexão Passenger foram
verificadas localmente com simulação do Passenger. Foram verificados acesso,
permissões, seis missões, upload e persistência após reinício no Node.js 24.
A hospedagem cPanel de destino não foi acessada; conclua a conferência nela.

Leia INSTALACAO_SERVIDOR.md para diagnóstico, backup e configuração alternativa.