#Rotina do Operador

Use esta rotina para acompanhar o Gera Base em producao sem depender de tentativa e erro.

#Checklist diario

• Acesse o Admin e confirme se MariaDB, Templates e Backups aparecem saudaveis.
• Verifique os jobs recentes e investigue qualquer item com status failure.
• Confira os logs filtrando por failure e pelos servicos gerador, admin, query-library e n8n.
• Confirme se existe backup recente de templates e, quando necessario, backup logico MariaDB.
• Teste uma conexao Postgres de homologacao antes de executar lotes grandes.

#Checklist antes de deploy

1. Gere backup pelo Admin ou execute scripts/production/deploy.sh, que cria backup antes do deploy.
2. Rode os testes locais:

python -m pytest -q -rs

3. Para validar interface local com containers ativos:

.\scripts\windows\Rodar Testes Visuais.bat

4. Revise o CHANGELOG.md e crie tag usando scripts/production/release.sh quando for publicar uma versao fechada.

#Alertas

Configure GERA_BASE_ALERT_WEBHOOK_URL para receber falhas em um webhook do n8n ou outro coletor HTTP.

Eventos enviados:

• api_failure
• generation_job_failed
• external_backup_failed

#Backup externo

Configure GERA_BASE_BACKUP_EXTERNAL_COMMAND quando quiser copiar backups para fora do volume local.

Exemplo:

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

Placeholders disponiveis:

• {file}: caminho completo do arquivo de backup.
• {name}: nome do arquivo.
• {kind}: templates ou mariadb.

#Restauracao segura

Use a previa de importacao no Admin antes de restaurar. A tela mostra templates novos, existentes e queries da Biblioteca SQL. Desmarque conteudos que nao devem entrar antes de clicar em importar.

#Incidente rapido

1. Consulte /ready e o painel Admin.
2. Confira logs recentes com filtro failure.
3. Verifique se os containers estao ativos no Portainer ou via Podman.
4. Se o problema comecou apos deploy, execute rollback informando a tag ou commit anterior.