Manual de Exportação, Importação e Migração

GVFF GRC Platform - Procedimentos para backup, migração e reinstalação

Versão atualizada | Março 2026

Índice

Visão Geral
Requisitos
Exportar o Código
Backup da Base de Dados MySQL
Enviar para o Servidor
Configuração da App Node.js no cPanel
Criação da Base de Dados no cPanel
Importação do SQL
Variáveis de Ambiente
Instalação e Reinício
Domínio e Subdomínio
Migração entre Ambientes
Ambiente Local (Opcional)
Checklist Final

1. Visão Geral

Este manual descreve como exportar, importar e migrar a plataforma GVFF GRC na sua versão atual, baseada em Node.js + Express + MySQL.

A plataforma é composta por:

Código-fonte: backend Node.js e frontend estático
Base de dados: MySQL
Uploads: ficheiros PDF e anexos operacionais
Configuração: variáveis de ambiente no ficheiro .env e/ou no painel da app Node

Nota: Na versão atual, a plataforma deixou de usar PostgreSQL/Neon e passou a usar MySQL. Os procedimentos deste manual assumem essa arquitetura.

2. Requisitos

2.1 Requisitos mínimos

Componente	Mínimo	Recomendado
Node.js	18.x	20.x
MySQL	5.7+	8.x
RAM	512 MB	1 GB+
Espaço	1 GB	5 GB+
Acesso ao painel	cPanel/SSH	cPanel + terminal

2.2 Estrutura do projeto

gvff-grc-platform/
├── index.js
├── package.json
├── package-lock.json
├── .env
├── config/
├── middleware/
├── models/
├── routes/
├── seeds/
├── public/
└── uploads/

Dica: Para um backup completo funcional, deve guardar sempre código + base de dados + uploads + .env.

3. Exportar o Código

3.1 O que exportar

Copie ou compacte estes ficheiros e pastas:

index.js
package.json
package-lock.json
.env
config/
middleware/
models/
routes/
seeds/
public/
uploads/

3.2 O que não é necessário exportar

Normalmente não é necessário levar:

node_modules/
stderr.log
ZIPs temporários e ficheiros de apoio antigos

Atenção: Não copie node_modules do seu computador para o servidor. No destino, deve correr npm install.

3.3 Método recomendado

1 Crie um ZIP do projeto local sem node_modules.

2 Faça upload desse ZIP para o servidor.

3 Extraia o conteúdo na pasta da app Node.

4. Backup da Base de Dados MySQL

4.1 Via phpMyAdmin

1 Abrir o phpMyAdmin.

2 Selecionar a base de dados da plataforma.

3 Clicar em Export.

4 Escolher Quick ou Custom.

5 Exportar em formato SQL.

4.2 Via linha de comandos

mysqldump -h localhost -u NOME_UTILIZADOR -p NOME_BASE > gvff_grc_backup.sql

4.3 O que deve ser preservado

tabelas de negócio: countries, entities, suppliers, assets, risks, documents
tabelas de conformidade: scopes e items
tabelas de utilizadores e permissões
framework items, se quiser preservar customizações

5. Enviar para o Servidor

5.1 Via File Manager do cPanel

1 Entrar no File Manager.

2 Abrir a pasta da aplicação Node.

3 Fazer upload do ZIP ou dos ficheiros atualizados.

4 Extrair ou substituir o conteúdo.

5.2 Via terminal / SSH

scp -r ./gvff-grc-platform/* utilizador@servidor:/home/UTILIZADOR/grc-gvff/

Dica: Antes de substituir a versão em produção, faça um backup da pasta anterior, por exemplo renomeando-a para grc-gvff-backup.

6. Configuração da App Node.js no cPanel

6.1 Campos principais

Campo	Valor típico
Node.js version	20.x
Application mode	Production
Application root	pasta da app, ex: `grc-gvff`
Application URL	domínio ou subdomínio, ex: `grc.gvff.pt`
Application startup file	`index.js`

6.2 Observação importante

Esta aplicação não usa build. O processo correto é:

npm install
npm start

Atenção: Não é necessário usar npm run build, porque o projeto não tem pipeline de compilação. O servidor arranca diretamente com node index.js.

7. Criação da Base de Dados no cPanel

7.1 Criar base e utilizador

1 Abrir Manage My Databases.

2 Criar a base de dados.

3 Criar o utilizador MySQL.

4 Associar o utilizador à base de dados.

5 Dar ALL PRIVILEGES.

7.2 Prefixos do cPanel

No cPanel, o nome real costuma ter prefixo da conta. Exemplo:

Base criada: grc_gvff
Base real no servidor: gvffpt_grc_gvff

Utilizador criado: grcgvffusr
Utilizador real no servidor: gvffpt_grcgvffusr

Importante: Use sempre no .env e nas variáveis da app o nome real completo, incluindo o prefixo do cPanel.

8. Importação do SQL

8.1 Importar via phpMyAdmin

1 Abrir o phpMyAdmin.

2 Selecionar a base correta.

3 Clicar em Import.

4 Escolher o ficheiro .sql.

5 Executar a importação.

8.2 Importar via terminal

mysql -h localhost -u UTILIZADOR -p NOME_BASE < gvff_grc_backup.sql

8.3 Quando não existe backup antigo

Se estiver a criar uma instalação nova sem dados anteriores, pode:

importar apenas o SQL estrutural da aplicação
deixar a aplicação arrancar e popular estruturas iniciais, se essa lógica estiver ativa

9. Variáveis de Ambiente

9.1 Formato atual

DB_HOST=localhost
DB_PORT=3306
DB_NAME=gvffpt_grc_gvff
DB_USER=gvffpt_grcgvffusr
DB_PASSWORD=********
JWT_SECRET=********
PORT=5000

9.2 Onde configurar

no ficheiro .env na raiz do projeto
ou nas Environment Variables da app Node.js no cPanel

9.3 Recomendação prática

Em produção, mantenha as variáveis no painel da aplicação Node e use o .env como apoio local/documental.

Atenção: A versão atual da plataforma já não usa DATABASE_URL. Deve usar DB_HOST, DB_PORT, DB_NAME, DB_USER e DB_PASSWORD.

10. Instalação e Reinício

10.1 Instalar dependências

npm install

10.2 Arranque manual

npm start

10.3 Reinício no painel

No cPanel / Node.js App, usar a opção Restart.

10.4 Ordem correta após update

Substituir ficheiros
Confirmar variáveis de ambiente
Executar npm install
Reiniciar a app
Testar login, registo e módulos

Dica: Se a app arrancar mas der erro de acesso à base de dados, confirme primeiro o nome real completo da base e do utilizador MySQL no cPanel.

11. Domínio e Subdomínio

11.1 Subdomínio recomendado

Para esta plataforma, é recomendável usar um subdomínio dedicado, por exemplo:

grc.gvff.pt

11.2 Passos

1 Criar o subdomínio no cPanel.

2 Associar a app Node a esse subdomínio.

3 Confirmar que o DNS aponta corretamente.

4 Validar o acesso via HTTPS.

Nota: Em ambiente Node no cPanel, o mais importante é o mapeamento correto do Application URL para o subdomínio criado.

12. Migração entre Ambientes

12.1 Cenário típico

Quando migrar a plataforma de um ambiente para outro:

Fazer backup do código atual
Fazer backup da base de dados MySQL
Fazer backup da pasta uploads/
Recriar a base no novo servidor
Importar o SQL
Subir os ficheiros do projeto
Atualizar o .env
Correr npm install
Reiniciar e validar

12.2 Validação após migração

Login e registo
Dashboard
Countries
Entities
Suppliers
Assets
Risks
Documents + download de PDF
Conformidade
Reports
Users / Permissions

13. Ambiente Local (Opcional)

13.1 Quando faz sentido

O ambiente local só é necessário se quiser testar a app no seu computador com uma base de dados local.

13.2 Necessário para correr localmente

Node.js instalado
MySQL local ou remoto acessível
.env apontado para essa base
npm install

13.3 Observação prática

Se no computador não existir MySQL local, a aplicação pode arrancar parcialmente, mas falhará nas rotinas que dependem da base de dados.

Atenção: O sucesso do arranque local não substitui a validação no servidor de produção. O ambiente principal é o da Dominios.pt.

14. Checklist Final

#	Passo	Estado
1	Backup do código criado	☐
2	Backup SQL da base MySQL criado	☐
3	Backup da pasta uploads criado	☐
4	Base MySQL criada no servidor destino	☐
5	Utilizador MySQL associado com ALL PRIVILEGES	☐
6	SQL importado com sucesso	☐
7	Ficheiros atualizados enviados para o servidor	☐
8	.env / variáveis da app atualizados	☐
9	npm install executado	☐
10	App reiniciada	☐
11	Login testado	☐
12	Registo testado	☐
13	Módulos principais validados	☐
14	Subdomínio / domínio validado	☐
15	Backup final pós-migração feito	☐

Checklist de segurança:

Alterar passwords seed / default
Usar um JWT_SECRET forte
Guardar credenciais MySQL em segurança
Fazer backups regulares da base de dados e uploads
Manter Node.js e dependências atualizados

GVFF GRC Platform - Manual de Exportação, Importação e Migração

Documento atualizado para a versão em produção