#Backups e Restauracao

#Templates

Para exportar templates em JSON:

python scripts/backup_templates.py

Por padrao, o arquivo fica em backups/templates-YYYYMMDD-HHMMSS.json.

Em Podman, os backups criados pelo painel Admin ficam no volume gerador-backups, montado em /app/backups nos containers admin-panel e gerador-bancos. Esse volume e separado do container da aplicacao, entao os arquivos sobrevivem a rebuild/recreate.

Em Windows:

.\scripts\windows\Backup Templates.bat

Tambem e possivel exportar e importar templates pelo painel Admin, na area Backup de templates.

#Backup Externo

Configure GERA_BASE_BACKUP_EXTERNAL_COMMAND para copiar cada backup local para outro destino. O comando recebe os placeholders {file}, {name} e {kind}.

Exemplo:

GERA_BASE_BACKUP_EXTERNAL_COMMAND='rclone copy "{file}" remote:gera-base/backups'

Se o comando falhar e GERA_BASE_ALERT_WEBHOOK_URL estiver configurado, o Gera Base envia um alerta HTTP.

#MariaDB

O MariaDB guarda templates, usuarios, logs, tokens de API e Biblioteca SQL.

Recomendacao operacional:

podman exec templates-mariadb mariadb-dump -u gerador -p gerador_templates > backups/gerador_templates.sql

Guarde backups fora da VPS e teste restauracao periodicamente.

#Restauracao

Para restaurar apenas templates, prefira importar o JSON pelo painel Admin. Para restauracao completa do banco interno, use o dump MariaDB.

O painel Admin mostra uma previa antes de importar backups JSON: templates existentes, templates novos e queries da Biblioteca SQL. Use as caixas de selecao para importar somente o que deseja restaurar.

Antes de restaurar, pare os containers que escrevem no banco:

systemctl --user stop gera-base.service

Depois restaure o dump no MariaDB e suba novamente:

systemctl --user start gera-base.service