Afromania · backend (Laravel) · ambiente de qualidade/preview
================================================================

Este pacote já vem com as dependências (vendor/) incluídas — não
precisas de correr "composer install". Falta só: criar a base de
dados, configurar o .env, apontar o domínio e correr 2 comandos.

------------------------------------------------------------------
1. Criar a base de dados (cPanel da conta onde vai ficar o backend)
------------------------------------------------------------------
No cPanel → "MySQL Databases":
  - Cria uma base de dados (ex.: livrariafromania_afromania_qld)
  - Cria um utilizador com password forte
  - Associa o utilizador à base de dados, com TODOS os privilégios

Guarda os 3 valores (nome da base, utilizador, password) — vão para
o .env no passo 3.

------------------------------------------------------------------
2. Criar o subdomínio
------------------------------------------------------------------
No cPanel → "Subdomains" (ou no WHM, se for conta nova):
  - Subdomínio: backendqualidade
  - Domínio: livrariaafromania.com
  - Document Root: aponta para a pasta "public" DENTRO de onde vais
    extrair este zip (ex.: se extraíres para
    /home/UTILIZADOR/backendqualidade_app/, o Document Root deve
    ser /home/UTILIZADOR/backendqualidade_app/public — nunca a
    pasta raiz da app, só a "public").

Em "MultiPHP Manager", garante que esse domínio usa PHP 8.4.

------------------------------------------------------------------
3. Enviar e configurar
------------------------------------------------------------------
  - Upload deste .zip para /home/UTILIZADOR/backendqualidade_app/
    (a pasta PAI de "public", não dentro dela) e Extract.
  - Abre o ficheiro .env (já vem no zip, só precisa de 3 valores)
    e preenche DB_DATABASE, DB_USERNAME, DB_PASSWORD com o que
    criaste no passo 1.
  - Confirma que SANCTUM_STATEFUL_DOMAINS e CORS_ALLOWED_ORIGINS
    têm o domínio REAL onde a loja (frontend) vai ficar. Já vem
    preenchido com "qualidade.livrariaafromania.com" — muda se for
    outro.

------------------------------------------------------------------
4. Comandos finais (Terminal do WHM, como root)
------------------------------------------------------------------
Confirma o caminho certo da app e corre:

  cd /home/UTILIZADOR/backendqualidade_app
  php artisan migrate --seed --force
  php artisan storage:link
  chown -R UTILIZADOR:UTILIZADOR .
  find storage bootstrap/cache -type d -exec chmod 775 {} \;
  find storage bootstrap/cache -type f -exec chmod 664 {} \;

(troca "UTILIZADOR" pelo utilizador cPanel real da conta)

O "migrate --seed" cria as tabelas e já preenche perfis/permissões,
configurações e um catálogo de demonstração — dá para testar a loja
sem mais nada.

------------------------------------------------------------------
Notas importantes
------------------------------------------------------------------
- APP_DEBUG está a "false" de propósito — nunca mudar para "true"
  num sítio acessível publicamente (mostra dados sensíveis em
  erros).
- Não há dados reais de províncias/municípios de Angola ainda
  (ponto em aberto já combinado) — o checkout só funciona para
  moradas que tu criares manualmente numa zona de entrega que
  também tens de criar (ou pede ajuda ao Claude para isso).
- Pagamento por referência usa o driver "fake" (simulado) — não é
  um gateway real.
- Quando o frontend estiver no ar, confirma comigo se o domínio dele
  bate certo com o que puseste em SANCTUM_STATEFUL_DOMAINS e
  CORS_ALLOWED_ORIGINS — se não bater, o login e tudo o que precisa
  de sessão fica bloqueado por CORS.
