LA PIRAMIDE DI DANIELE — como subir no cPanel
=============================================

Oi, Victor! Este é o jogo da pirâmide (em italiano) para colocar no ar.

O que o jogo faz:
  • Cada jovem entra com Nome e Cognome e pode refazer o teste quantas
    vezes quiser. Todas as partidas ficam registradas.
  • Cada fase abre com uma cena animada da história de Daniel, narrada,
    com vozes para os personagens. Depois vêm o versículo e a instrução,
    lidos em voz alta, com as palavras ficando em negrito.
  • No fim, cada um recebe conselhos personalizados. No ranking, tocando
    no nome, dá para ver todas as partidas da pessoa e o que ela mudou.

É um site simples: HTML + 1 arquivo PHP + áudios. Não usa banco de dados
nem Node, e não precisa instalar nada. O ranking fica gravado em arquivos
dentro da pasta data/.


O QUE TEM NO daniel.zip
-----------------------
  daniel/index.html       → o jogo inteiro
  daniel/api.php          → o ranking (precisa de PHP 7.4 ou mais novo)
  daniel/data/.htaccess   → bloqueia o acesso público aos dados do ranking
  daniel/audio/           → 57 áudios .mp3 (cerca de 2 MB): narração, vozes
                            dos personagens, versículos, instruções e
                            situações

A senha do administrador já está configurada no api.php (veja no fim).
Não precisa editar nada.


PASSO A PASSO
-------------
1. Entre no cPanel → "Gerenciador de Arquivos" (File Manager).

2. Abra a pasta public_html (ou a pasta do domínio/subdomínio onde o jogo
   vai ficar).

3. Clique em "Carregar" (Upload) e envie o daniel.zip.

4. Volte para a pasta, clique com o botão direito no daniel.zip →
   "Extrair" (Extract). Vai aparecer a pasta daniel/.
   Depois pode apagar o daniel.zip.

   IMPORTANTE: o arquivo data/.htaccess começa com ponto e fica oculto.
   Para conferir se ele está lá: no Gerenciador de Arquivos, clique em
   "Configurações" (Settings) → marque "Mostrar arquivos ocultos"
   (Show Hidden Files).

5. Permissões (botão direito → "Alterar permissões"):
      pasta daniel/          → 755
      pasta daniel/data/     → 755  (se o ranking não gravar, tente 775)
      pasta daniel/audio/    → 755  (os .mp3 dentro dela → 644)
      index.html e api.php   → 644

6. Confira a versão do PHP: cPanel → "Selecionar versão do PHP"
   (ou "MultiPHP Manager"). Precisa ser 7.4 ou mais novo (8.x é ótimo).


ENDEREÇOS (troque SEUSITE pelo domínio)
---------------------------------------
  Jogo (cada jovem no celular/tablet):  https://SEUSITE/daniel/
  Telão com ranking + QR code:          https://SEUSITE/daniel/?telao
  Sala separada por encontro:           https://SEUSITE/daniel/?sala=sabato
                                        https://SEUSITE/daniel/?sala=sabato&telao


TESTE RÁPIDO DEPOIS DE SUBIR (10 minutos)
-----------------------------------------
[ ] 1. Abra https://SEUSITE/daniel/api.php?action=list
       Deve aparecer algo como:
       {"ok":true,"sala":"geral","people":0,"ranking":[]}
       (Se aparecer um erro ou a página em branco, veja "Problemas".)

[ ] 2. VOZ E CENAS: abra https://SEUSITE/daniel/?sala=teste no celular,
       digite Nome e Cognome e toque em "Inizia". Na abertura da fase:
       a cena é animada, uma narradora conta a história, os personagens
       falam, e depois o versículo e a instrução são lidos, com as
       palavras ficando em negrito.
       Se não tiver voz: confira se o 🔊 do canto não está em 🔇 e se a
       pasta daniel/audio/ foi enviada com os 57 arquivos.

[ ] 3. Jogue a partida até o fim (dá para tocar em "⏭ Salta" nas cenas).
       No resultado deve aparecer "Sei al 1° posto su 1 in classifica."
       Depois toque em "🔁 Rifai il test" e jogue de novo, escolhendo
       coisas diferentes. No fim deve aparecer "Questo è il tuo tentativo
       n° 2." e um quadro "📈 Cosa è cambiato rispetto al tentativo 1".
       (Se aparecer "salvato solo su questo dispositivo", o ranking NÃO
       está gravando no servidor: veja "Problemas".)

[ ] 4. Abra https://SEUSITE/daniel/?sala=teste&telao no computador e
       clique uma vez na página (libera o som).
       O ranking deve mostrar "🟢 In diretta" e o seu nome UMA vez só,
       com "2 tentativi". Toque no seu nome: abre a lista das suas
       partidas, com o que mudou de uma para a outra.
       O QR code deve abrir o jogo quando lido pelo celular.

[ ] 5. SEGURANÇA: abra https://SEUSITE/daniel/data/ranking_teste.json
       Deve dar "Forbidden" / "Acesso negado" (403).
       Se mostrar o conteúdo do arquivo, avise o Thiago.

[ ] 6. Limpe o teste: no telão de teste, clique em "Azzera la classifica"
       e digite a senha. Deve aparecer "Classifica azzerata."


PROBLEMAS COMUNS
----------------
• "Modalità offline" no ranking, ou "salvato solo su questo dispositivo":
  o api.php não está respondendo ou não consegue gravar.
  → Confira o teste 1 e a permissão da pasta data/ (755, ou 775).

• api.php mostra o código em vez de executar, ou dá erro 500:
  → O PHP não está ativo para essa pasta, ou a versão é antiga.
    Ajuste em "Selecionar versão do PHP".

• O teste 5 mostrou o arquivo (não bloqueou):
  → O servidor não está lendo o .htaccess (raro no cPanel). Confira se
    data/.htaccess existe (arquivos ocultos) e avise o Thiago.

• Sem voz nem som: o celular pode estar no silencioso (no iPhone, a
  chavinha lateral) ou o botão 🔊 do canto está em 🔇. No telão, os
  navegadores só liberam o som depois do primeiro clique na página.

• Ranking não atualiza no telão: ele atualiza sozinho a cada 4 segundos.
  Recarregue a página.


SENHA DO ADMINISTRADOR (só para zerar o ranking no telão)
--------------------------------------------------------
  leoni-0xlt4h

Ela fica no início do api.php (linha "const ADMIN_KEY").
Não divulgue para os jovens.


O QUE NÃO SUBIR
---------------
Na pasta do projeto, no Mac do Thiago, existem também os arquivos
servidor-local.py, gerar-voz.py, CLAUDE.md, LEIA-ME.txt e a pasta .claude.
Eles servem só para testes e NÃO vão para o servidor. O daniel.zip já vem
só com o necessário.

Obrigado! 🦁
