Backup e restauração do sistema

Diferente do backup pessoal (que cada usuário tira dos próprios arquivos), o backup de sistema é uma função exclusiva de administrador que gera uma cópia de tudo: todos os arquivos físicos de todas as contas, mais um dump completo das tabelas principais do banco de dados.

Gerando o backup completo

Em Administração > Sistema > Exportar backup, o Arquivme monta um único .zip contendo:

• Um arquivo database.json, com o conteúdo das tabelas usuarios, arquivos, permissoes, logs, leituras e arquivo_tags.
• Uma pasta uploads/, com a cópia de todos os arquivos físicos de todas as contas.

Esse processo pode levar um tempo considerável em instalações com muito conteúdo — o servidor não aplica limite de tempo de execução a essa operação especificamente, mas evite interromper o processo no meio.

Guarde esse arquivo .zip em um lugar seguro, fora do próprio servidor — ele é, por definição, uma cópia independente, e não cumpre esse papel se ficar só no mesmo disco que está sendo protegido.

Restaurando um backup — leia antes de usar

Operação destrutiva

Restaurar um backup apaga completamente o conteúdo atual das tabelas usuarios, arquivos, permissoes, logs, leituras e arquivo_tags antes de inserir os dados do backup. Não existe confirmação em duas etapas além da que a própria interface pede — uma vez confirmado, não há como desfazer. Nunca restaure um backup em um sistema em produção sem ter certeza absoluta do que está fazendo, e idealmente teste antes num ambiente separado.

Em Administração > Sistema > Importar backup, envie o .zip gerado anteriormente. O processo:

1. Extrai o ZIP e confere se o database.json existe e é válido — se não for, a restauração é recusada antes de tocar em qualquer dado.
2. Apaga o conteúdo atual das seis tabelas listadas acima, dentro de uma transação (se qualquer parte falhar no meio, a transação inteira é revertida — você não fica com um banco pela metade).
3. Insere os dados do backup nessas mesmas tabelas.
4. Copia os arquivos físicos do backup de volta para a pasta de armazenamento (STORAGE_BASE), sem apagar antes os arquivos físicos já existentes que não constam no backup — ou seja, a restauração do disco é aditiva, mas o banco é substitutivo.

O que não está incluso no backup/restauração

As tabelas notificacoes, favoritos, login_attempts, api_rate_limits e sistema_status não fazem parte do dump. Isso significa que, depois de uma restauração:

• Notificações e favoritos de antes do backup não voltam.
• Contadores de tentativa de login e de limite de requisições são zerados (sem impacto prático, eles se recalculam sozinhos).

Quando usar cada um

Situação	O que usar
Usuário quer uma cópia só dos próprios arquivos	Backup pessoal, feito pelo próprio usuário
Rotina de backup de todo o sistema, para desastre/migração	Backup completo, feito pelo admin, guardado fora do servidor
Recuperar de uma perda de dados grave	Restauração — com os riscos acima em mente
Migrar para outro servidor	Backup completo + restauração no destino