Liferay Upgrade Tool

Propósito y intención del usuario: la herramienta resuelve el problema de planificar, validar y acelerar actualizaciones de bases de código Liferay a través de versiones. Los usuarios objetivo son ingenieros DevOps, arquitectos de plataforma y equipos de IT responsables de actualizaciones de portales y migraciones de módulos. Al actualizar un portal, especialmente en saltos de versión grandes o al sustituir API obsoletas, la herramienta ayuda a determinar tareas, dependencias y riesgos antes de aplicar cambios de código. El enfoque está en la lógica de dominio, viabilidad de la actualización y resultados predecibles, no en el flujo de la interfaz de usuario.
Lógica central y funciones (requeridas): 1) Análisis de compatibilidad de versiones entre la versión actual y la versión objetivo con comprobaciones a nivel de módulo/API; 2) Generación de un plan de migración con tareas, responsables, dependencias y esfuerzo estimado; 3) Evaluación de riesgos basada en depreciaciones de API, cambios de API y cobertura de pruebas; 4) Informe de impacto de cambios que identifica módulos afectados y remedios propuestos. Funciones opcionales: 5) Exportación del gráfico de dependencias para CI; 6) Generación automática de plantillas de parche o scripts de migración; 7) Resúmenes delta basados en notas de version. El flujo de trabajo establece que las funciones centrales son entradas obligatorias para cada escenario de actualización; las funciones opcionales enriquecen el plan cuando hay datos disponibles.
Entradas y salidas: Entradas incluyen current_version (p. ej. 7.4.3), target_version (p. ej. 8.0.0), codebase_path, modules (array), include_plugins (boolean) y datos opcionales como token de acceso al repositorio y resultados de pruebas. Salidas incluyen migration_plan en JSON estructurado, risk_score (0–100), delta_report (texto), compatibility_matrix CSV y un reporte final exportable_upgrade_report (JSON o PDF). Validación: verifica sintaxis de versiones, accesibilidad del path del código, referencias a módulos y presencia de datos opcionales si se proporcionan.