METRIXA — PACOTE PARA HOSPEDAGEM cPANEL
Versão: b59bc67 (20261111-1324)

Este pacote já traz tudo o que o servidor precisa: o código, os ficheiros do ecrã
(public/build) e as dependências do PHP (vendor). Não é preciso Composer, Node nem Git
no servidor. Guia completo: docs/publicar.md, secção «Hospedagem cPanel (Bluehost)».

ANTES DE TUDO (uma só vez)
  1. O plano tem de ter PostgreSQL e PHP 8.4 (cPanel → PostgreSQL Databases;
     Software → MultiPHP Manager). Sem isso, o Metrixa não funciona: use uma VPS.
  2. Ligue o SSH (Shell Access) no portal da hospedagem.

PRIMEIRA INSTALAÇÃO
  1. cPanel → PostgreSQL Databases: crie a base de dados e o utilizador (com todos os
     privilégios). Anote o nome completo (com o prefixo da conta) e a palavra-passe.
  2. cPanel → Domains: crie o subdomínio (ex.: metrixa.exemplo.org) com a Document Root
     em  metrixa/public  (fora de public_html). Depois, SSL/TLS Status → AutoSSL.
  3. cPanel → File Manager: envie este .zip para a pasta da conta (a de cima de
     public_html) e escolha «Extract». Fica a pasta  ~/metrixa.
  4. Por SSH:
       alias php84=/opt/cpanel/ea-php84/root/usr/bin/php
       cd ~/metrixa
       cp .env.cpanel.example .env      # e edite os valores em MAIÚSCULAS
       php84 artisan key:generate
       php84 artisan migrate --force
       php84 artisan datahub:create-admin email@h2n.org.mz "Nome Apelido" --organization="h2n" --platform
       php84 artisan optimize
       chmod -R u+rwX storage bootstrap/cache
     (Nunca use --seed em produção: cria contas de demonstração.)
  5. cPanel → Cron Jobs: UMA tarefa a cada minuto (* * * * *):
       cd $HOME/metrixa && /opt/cpanel/ea-php84/root/usr/bin/php artisan schedule:run >> /dev/null 2>&1
  6. Abra https://metrixa.exemplo.org — o administrador recebe um email para escolher a
     palavra-passe (o email SMTP do .env tem de funcionar).

ACTUALIZAR PARA UMA VERSÃO NOVA (com um pacote novo)
  1. Por SSH:   cd ~/metrixa && php84 artisan down --retry=15
  2. Guarde o .env:   cp ~/metrixa/.env ~/metrixa.env.copia
  3. File Manager: envie o pacote novo e extraia-o por cima da pasta (substitui os
     ficheiros; o .env e a pasta storage ficam).
     Se preferir uma pasta limpa: renomeie a antiga para metrixa-antiga, extraia o novo,
     e copie para ~/metrixa o .env e o conteúdo de metrixa-antiga/storage/app.
  4. Por SSH:
       cd ~/metrixa
       php84 artisan migrate --force
       php84 artisan optimize
       php84 artisan queue:restart
       php84 artisan up

PROBLEMAS
  - Erros do sistema:  ~/metrixa/storage/logs/laravel.log
  - Erros do Apache:   cPanel → Errors
  - Página em branco ou erro 500 logo a seguir a instalar: confirme o .env, a APP_KEY e
    as permissões de storage e bootstrap/cache.
