# Atualizações operacionais

Atualizações devem ser distribuídas como pacotes versionados e verificadas antes da instalação. O processo não executa `git pull`, comandos fornecidos pelo pacote ou comandos arbitrários.

Antes de atualizar, faça backup e valide o pacote em ambiente de homologação. A versão de destino deve ser superior à versão instalada; downgrade não é permitido.

O backup operacional disponível no painel registra metadados e artefatos gerados em `storage/app/backups`. A exportação do banco depende de ferramenta aprovada e configurada pelo administrador do ambiente; ela não é executada automaticamente pelo ServiceGPT.

## Instalação e atualização completa

O instalador valida requisitos, permite testar o banco sem gravar configuração e só cria o marker depois de migration e criação bem-sucedida do administrador. O painel usa allowlist para configurações e nunca exibe chaves existentes.

Pacotes ZIP exigem manifest com produto, versão, versão mínima e indicação de migration. A instalação exige reautenticação, backup real, snapshot de arquivos, maintenance mode, migrations via `--force`, verificação de saúde e tentativa de rollback de arquivos. Não há rollback automático de banco; migrations devem ser aditivas e backward compatible.
