Guia de Instalação — Transparência

📋 Antes de começar

O que precisa de ter pronto

Acesso ao cPanel do seu domínio (transparencia.tibantu.com)
ZIP do Transparência mais recente (transparencia-v1.10.0.zip)
PHP 8.3 activo (já confirmado no seu cPanel ✓)
Base de dados MySQL criada (já tem tibantu_transparencia ✓)
Utilizador da BD com ALL PRIVILEGES (já tem ✓)
Password do utilizador MySQL à mão — vai precisar dela no passo 2

ℹ️ Nota: a password do utilizador MySQL não é a sua password do cPanel. É a que definiu quando criou o utilizador tibantu_transparencia. Se esqueceu, pode redefini-la em cPanel → MySQL Databases → Current Users → Set Password.

Upload e Extract no cPanel

Carregar a versão mais recente da aplicação para o servidor.

Entrar no cPanel → File Manager
Navegar para a pasta do subdomínio (normalmente public_html/transparencia/ ou similar)
Clicar em Upload e selecionar o ficheiro transparencia-v1.10.0.zip
Depois do upload, voltar ao File Manager, clicar com o botão direito no ZIP → Extract
Confirmar a substituição dos ficheiros existentes

✅ Sucesso: deve ver as pastas api/, assets/, data-sync/ e ficheiros index.html, portal.html, manifest.webmanifest.

Correr `install.php`

Configurar a ligação à BD MySQL e criar as tabelas automaticamente.

Abra no browser:

https://transparencia.tibantu.com/api/install.php

Vai aparecer um formulário. Preencha exatamente assim:

…/api/install.php

🛠️ Instalador do Transparência

Host

localhost

Porta

3306

Nome da base de dados

tibantu_transparencia

Utilizador MySQL

tibantu_transparencia

Password do utilizador MySQL

••••••••••••

🚀 Instalar e criar tabelas

📋 Resumo dos valores

Host	localhost
Porta	3306
Database	tibantu_transparencia
Username	tibantu_transparencia
Password	a que definiu no cPanel

⚠️ Atenção: escreva a password correta. Se errar, o instalador devolve "Access denied" — basta voltar atrás e tentar de novo.

O instalador vai:

Testar a ligação à BD
Criar as tabelas tp_snapshots, tp_audit, tp_rate_limit
Gerar api/db.config.php com as credenciais (ficheiro protegido por .htaccess)
Mostrar uma mensagem verde de sucesso

✅ Sucesso: vê o ecrã com "Instalação concluída" e instruções para apagar o instalador.

Apagar o instalador Segurança

Por segurança, o install.php não deve ficar acessível após o setup.

cPanel → File Manager → pasta api/
Clique com o botão direito em install.php → Delete
(Opcional) Apague também setup.php e phpcheck.php se existirem

🚨 Importante: NÃO apague db.config.php, sync.php, portal.php nem notify.php — esses são os ficheiros activos da aplicação!

Sincronizar todos os dispositivos

Cada dispositivo auto-configura-se ao entrar no domínio. Não precisa de copiar chaves.

🌐 No computador (web/desktop)

Abrir https://transparencia.tibantu.com
Forçar refresh: Ctrl + F5 (Windows/Linux) ou ⌘ + Shift + R (Mac)
Fazer login com admin@transparencia.ao / a sua password
A app pede para mudar a password no 1.º login → defina uma forte
Vai automaticamente buscar os dados do servidor 🎉

📱 No telemóvel

Abrir https://transparencia.tibantu.com no Chrome (Android) ou Safari (iOS)
Limpar cache: definições do navegador → Limpar dados de navegação
Recarregar a página
Fazer login
Instalar a app:
- Android: botão "Instalar app" no ecrã de login (ou menu Chrome → Adicionar ao ecrã principal)
- iOS: botão Partilhar (↑) → Adicionar ao ecrã principal

ℹ️ Auto-configuração: cada dispositivo que abre a app no mesmo domínio recebe automaticamente a chave de sincronização do servidor (endpoint /api/sync.php?action=clientconfig). Não precisa de copiar/colar chaves entre dispositivos.

✅ Confirmação: faça uma alteração num dispositivo (ex: adicione um morador). Em segundos, deve aparecer nos outros dispositivos. Sincronização verificada a cada 10s + ao reabrir a app.

🔧 Resolução de problemas

❌ "Access denied for user"

A password do utilizador MySQL está errada. Vá a cPanel → MySQL Databases → Current Users, encontre tibantu_transparencia e clique em Set Password para definir uma nova. Use essa no formulário do install.

❌ "Unknown database"

O nome está errado. Verifique exatamente em cPanel → MySQL Databases → Current Databases. Deve ser algo como tibantu_transparencia (com prefixo tibantu_).

❌ "Pré-requisitos PHP em falta"

Vá a cPanel → MultiPHP Manager ou Select PHP Version → garanta que está em PHP 8.3 e que as extensões pdo_mysql, json e mbstring estão activas.

⚠️ Dispositivos mostram dados diferentes

Geralmente significa que ainda não correu o install.php ou que está a aceder por URL diferente (www. vs sem www.). Verifique:

Todos os dispositivos usam o mesmo URL (sempre com https://)
Force refresh (Ctrl+F5) em todos
Na app: Saúde do Sistema → Sincronização → Sincronizar Agora

⚠️ Logo ou textos não atualizam

É o service worker a servir versão antiga em cache. Solução:

Na app: Atualizações → Forçar atualização
Ou: no Chrome → F12 → tab Application → Service Workers → Unregister
Recarregar a página

📞 Suporte

Se nada disto resolver, partilhe um screenshot do erro com o suporte técnico. Os logs ficam em cPanel → Errors.

🎯 Checklist final

ZIP carregado e extraído no cPanel
install.php correu com sucesso (mensagem verde)
install.php apagado do servidor
Login feito em pelo menos 2 dispositivos
Password do admin alterada (não usar admin123)
Sincronização entre dispositivos confirmada