Liferay Upgrade Tool

Scopo e intento dell’utente: lo strumento risolve il problema di pianificare, convalidare e accelerare gli upgrade di codici Liferay tra versioni. Gli utenti di riferimento sono ingegneri DevOps, architetti di piattaforma e team IT responsabili di upgrade di portali e migrazioni di moduli. Durante l’upgrade di un portale, soprattutto per grandi salti di versione o sostituzione di API deprecate, lo strumento aiuta a determinare attività, dipendenze e rischi prima che venga applicato qualsiasi cambiamento di codice. L’attenzione è sulla logica di dominio, fattibilità dell’upgrade e risultati prevedibili, non sul flusso dell’interfaccia utente.
Logica di core & Funzionalità (Obbligatorie): 1) Analisi di compatibilità tra versione corrente e versione obiettivo a livello di modulo/API; 2) Generazione di un piano di migrazione con attività, responsabili, dipendenze e sforzo stimato; 3) Valutazione del rischio basata su deprecazioni API, cambiamenti API e copertura di test; 4) Rapporto sull’impatto delle modifiche che evidenzia moduli interessati e rimedi proposti. Funzionalità opzionali: 5) Esportazione grafico dipendenze per CI; 6) Generazione automatica di modelli di patch o script di migrazione; 7) sommari delta basati su note di rilascio. Il flusso di lavoro impone che le funzioni principali siano input obbligatori per ogni scenario di upgrade; le funzioni opzionali arricchiscono il piano quando vi sono dati disponibili.
Ingressi ed uscite: Ingressi: current_version (es. 7.4.3), target_version (es. 8.0.0), codebase_path, modules (array), include_plugins (boolean) e fonti opzionali come token di accesso al repository e risultati di test. Uscite: migration_plan in JSON strutturato, risk_score (0–100), delta_report (testo), compatibility_matrix CSV e un report finale exportable_upgrade_report (JSON o PDF). La validazione verifica sintassi delle versioni, accessibilità del percorso del codice e riferimenti ai moduli, nonché presenza di dati opzionali se forniti.