Manual Historico de Upgrade (transicao para Java 21)

Guia historico preservado com capturas e passos de uma transicao tecnica anterior do produto. Nao representa o caminho publico principal de uso da loja.

Banco SQLite Flyway Rollback testado
1. Pré-check 2. Backup 3. Upgrade historico 4. Validação 5. Rollback

Passo 1 - Pré-check do ambiente

Execute os comandos abaixo apenas quando estiver reproduzindo a transicao historica em ambiente tecnico controlado.

& D:\\dev\\.venv\\Scripts\\python.exe --version
& D:\\dev\\.mvn\\activate-maven-env.ps1
mvn --version

Passo 2 - Backup do banco

Crie backup do SQLite antes de qualquer alteracao nesse fluxo historico.

cd D:\\dev\\caracore-pdv
$timestamp = Get-Date -Format "yyyy_MM_dd_HHmmss"
Copy-Item .\\data\\caracore-pdv.db ".\\backups\\caracore-pdv_backup_$timestamp.db"

Passo 3 - Executar upgrade + validação

Use o orquestrador Python para validar pre e pos-upgrade apenas nesse procedimento historico.

& D:\\dev\\.venv\\Scripts\\python.exe .\\scripts\\upgrade\\run_upgrade_and_validate.py ^
  --db-path .\\data\\caracore-pdv.db ^
  --backup-dir .\\backups ^
  --report-file .\\upgrade_validation_report.txt
Criterio de aprovacao: o relatorio final deve conter result=GO.

Passo 4 - Validação operacional

  • Login no sistema
  • Consulta de venda
  • Teste de autorização por perfil
  • Validação de integridade do banco

Passo 5 - Rollback (se necessário)

Se houver qualquer falha critica, execute rollback imediato nesse fluxo historico:

& D:\\dev\\.venv\\Scripts\\python.exe .\\scripts\\upgrade\\rollback_from_backup.py ^
  --backup-dir .\\backups --latest ^
  --db-path .\\data\\caracore-pdv.db --force
NO-GO: qualquer inconsistência de dados, erro de startup ou falha de segurança.

Checklist de publicação

  • [ ] GO/NO-GO preenchido
  • [ ] Validação operacional executada (login, venda, autorização, banco)
  • [ ] Backup confirmado antes do upgrade
  • [ ] Nenhuma inconsistência de dados detectada
Voltar para Wiki