Liferay Upgrade Tool

Propósito e intenção do usuário: a ferramenta resolve o problema de planejar, validar e acelerar atualizações de bases de código Liferay entre versões. Usuários-alvo incluem engenheiros DevOps, arquitetos de plataforma e equipes de TI responsáveis por upgrades de portais e migrações de módulos. Ao atualizar um portal, especialmente com saltos de versão grandes ou substituição de APIs obsoletas, a ferramenta ajuda a determinar tarefas, dependências e riscos antes de aplicar alterações de código. O foco é na lógica de domínio, viabilidade da atualização e resultados previsíveis, não no fluxo de UI.
Lógica central e recursos (Obrigatórios): 1) Análise de compatibilidade entre a versão atual e a desejada com verificações ao nível de módulo/API; 2) Geração de um plano de migração com tarefas, proprietários, dependências e esforço estimado; 3) Avaliação de risco baseada em depreciações de API, alterações de API e cobertura de testes; 4) Relatório de impacto das mudanças que identifica módulos afetados e soluções propostas. Funcionalidades opcionais: 5) Exportação do gráfico de dependências para CI; 6) Geração automática de modelos de patch ou scripts de migração; 7) Resumos delta baseados em notas de versão. Fluxo de trabalho imposto: funções centrais são entradas obrigatórias para cada cenário; funções optativas enriquecem o plano quando dados existem.
Entradas e saídas: Entradas incluem current_version (ex. 7.4.3), target_version (ex. 8.0.0), codebase_path, modules (array), include_plugins (boolean) e fontes opcionais como token de acesso ao repositório e resultados de testes. Saídas incluem migration_plan em JSON estruturado, risk_score (0–100), delta_report (texto), compatibility_matrix CSV e um relatório final exportable_upgrade_report (JSON ou PDF). Validação verifica sintaxe de versões, acessibilidade do caminho do código, referências a módulos e presença de dados opcionais, se fornecidos.