# BIRITAS GAME — pacote para hospedagem

## Requisitos
Node.js 20 ou superior, HTTPS e pasta privada persistente com permissão de escrita. Sem dependências npm e sem MySQL. Hospedagem somente PHP/WordPress não executa este projeto.

Esta é uma instalação limpa. O ZIP não contém contas, senhas, sessões ou registros do computador de desenvolvimento. O site ainda não foi instalado nem testado no seu servidor.

## Instalação no cPanel
1. Confirme que existe Application Manager/Gerenciador de Aplicativos ou Setup Node.js App. Caso não exista, peça ao provedor para habilitar Node.js.
2. Crie um subdomínio com certificado HTTPS, por exemplo biritas.seudominio.com.br. Use a raiz do subdomínio, não uma subpasta.
3. Extraia os arquivos em uma pasta privada como /home/SEU_USUARIO/biritas-app, fora de public_html. Não exponha a pasta do projeto como arquivos estáticos. O Node serve somente os arquivos autorizados de public/.
4. Renomeie config.example.json para config.json e substitua SEU_USUARIO e o domínio. DATA_DIR deve apontar para uma pasta privada, fora da raiz pública, por exemplo /home/SEU_USUARIO/biritas-dados. Variáveis de ambiente do painel têm precedência sobre config.json.
5. Antes de iniciar a aplicação, crie as duas contas pelo terminal seguindo a seção abaixo.
6. Registre o aplicativo no painel: raiz biritas-app, URL do subdomínio, modo Production e arquivo de inicialização app.js. Se o painel já o iniciou automaticamente, pare antes da criação do banco. Não use scripts/demo.cjs.
7. Mantenha um único processo para esta aplicação. O banco JSON não suporta cluster nem múltiplos workers. Peça ao provedor para limitar o grupo Passenger a um processo, sem sobreposição durante reinícios. Se isso não for possível, use um serviço Node de processo único com proxy HTTPS.
8. Inicie pelo painel e acesse /administrador. Não inicie simultaneamente pelo terminal.

O cPanel utiliza normalmente Passenger e app.js como entrada; os campos e recursos disponíveis dependem do provedor. Não substitua arquivos de configuração do Apache por conta própria. Documentação: https://docs.cpanel.net/knowledge-base/web-services/how-to-install-a-node.js-application/

## Criar fuxo e bahia em uma instalação nova
No terminal Linux do cPanel, dentro de biritas-app, com a aplicação parada:

```bash
read -r -s -p 'Senha dos administradores: ' BIRITAS_ADMIN_PASSWORD
echo
export BIRITAS_ADMIN_PASSWORD
node criar-administradores.cjs
unset BIRITAS_ADMIN_PASSWORD
```

Digite a senha desejada; ela não aparece na tela nem está gravada no pacote. Ambas as contas recebem essa senha, armazenada com scrypt e salt. O comando se recusa a substituir um banco existente.

Alternativa: iniciar sem banco cria setup-key.txt na pasta de dados. A tela de instalação permite criar somente o primeiro administrador. Para começar com os dois, use o comando acima antes do primeiro início.

## Endereços após a instalação
- https://SEU_SUBDOMINIO/administrador — nomes fuxo e bahia.
- https://SEU_SUBDOMINIO/jogador — login dos participantes.
- https://SEU_SUBDOMINIO/cadastro — cadastro, enquanto inscrições estiverem abertas.

## Verificação e manutenção
Teste cadastro em um celular, aprovação no administrador, início, solicitação e aprovação de copo em aparelhos diferentes. Confirme que duas aprovações da mesma solicitação geram somente um registro. Teste sair e entrar novamente e os dois temas.

As rotas /config.json e /data/database.json devem responder 404. Se aparecer conteúdo delas, pare a publicação e corrija a exposição da pasta. O domínio configurado em PUBLIC_ORIGIN deve ser exatamente o usado no navegador, com HTTPS e sem barra final, ou os formulários serão rejeitados.

Faça backups privados regulares da pasta DATA_DIR com a aplicação parada e teste a restauração. Para atualizar o código, preserve essa pasta e config.json. Em encerramento abrupto, pode sobrar server.lock: remova somente esse arquivo depois de confirmar que nenhum processo está usando o banco. Nunca remova database.json para resolver bloqueio.

Sem instalação pública automática, recuperação de senha por e-mail ou banco compartilhado entre servidores. Este pacote não inclui configuração de DNS ou certificado do seu domínio.
