╔══════════════════════════════════════════════════════════════╗
║       GALERIA DE FOTOGRAFIAS — MANUAL DE INSTALAÇÃO         ║
╚══════════════════════════════════════════════════════════════╝

INSTALAÇÃO PLUG & PLAY
══════════════════════

1. Faz upload de TODOS os ficheiros para a pasta do teu servidor
   (ex: public_html/galeria ou public_html/)

2. Garante que as pastas têm permissões de escrita (755):
   - imgs/
   - storage/
   - (a raiz onde fica o .env)

3. Acede ao instalador no browser:
   https://tuadomain.pt/galeria/install.php

4. Segue os 3 passos do wizard:
   → Verificar requisitos
   → Configurar base de dados (MySQL no cPanel)
   → Configurar site, admin e MBWay

5. APÓS INSTALAR: apaga ou renomeia o install.php por segurança!
   mv install.php install.php.done

══════════════════════════════════════════════════════════════

FUNCIONALIDADES
═══════════════

✅ Galeria pública com eventos e fotografias
✅ Proteção por password por evento
✅ Carrinho de compras com promoção automática
✅ Checkout com MBWay e Dinheiro
✅ Reconhecimento facial para pesquisa de fotos
✅ Envio automático de fotos por email após pagamento
✅ Link de download seguro com expiração configurável
✅ Métodos de envio editáveis no admin
✅ Configurações do site editáveis no admin (nome, tagline, etc.)
✅ Marca de água automática nas pré-visualizações
✅ Upload em massa de fotografias
✅ Relatórios de vendas por evento

REQUISITOS DO SERVIDOR
═══════════════════════
- PHP 8.1+
- MySQL 5.7+ / MariaDB 10.3+
- Extensões: pdo_mysql, gd, zip
- mod_rewrite activo
- Pasta raiz com permissão de escrita (para criar .env)

ZONA DO ADMIN
══════════════
URL: https://tuadomain.pt/galeria/admin
- Criar/gerir eventos
- Gerir fotografias (upload em massa)
- Ver e editar encomendas
- Confirmar pagamentos e enviar fotos por email
- Editar métodos de envio e preços
- Configurações do site

MBWAY
══════
O número MBWay é apenas INFORMATIVO — é mostrado ao cliente para
que este faça a transferência. Não existe integração API automática.
Depois de o cliente pagar, o admin confirma manualmente no backoffice
e o sistema envia automaticamente as fotos por email.

RECONHECIMENTO FACIAL
══════════════════════
Usa a biblioteca face-api.js (gratuita, open-source).
O processamento é feito 100% no browser do cliente — sem custos,
sem upload de dados para servidores externos.
Requer ligação à internet para carregar os modelos na primeira vez.

SUPORTE
════════
Em caso de dúvidas, contacta o developer.

════════════════════════════════════════════════════════════════
