Liferay Upgrade Tool

الغرض ونية المستخدم: تحل الأداة مشكلة تخطيط والتحقق من وتيرة ترقية كود Liferay عبر الإصدارات. المستهدفون هم مهندسو DevOps، مهندسو بنية المنصة، وفرق IT المسؤولة عن ترقية البوابات وهجرات الوحدات. عند ترقية بوابة، خاصة عند قفزات إصدار كبيرة أو استبدال واجهات برمجية منتهية الصلاحية، تساعد الأداة في تحديد المهام والتبعيات والمخاطر قبل تطبيق تغيير الكود. التركيز ينصب على منطق المجال وجدوى الترقية ونتائج قابلة للتوقع، وليس على تدفق واجهة المستخدم.
المنطق الأساسي والميزات (إلزامية): 1) تحليل التوافق بين الإصدار الحالي والإصدار المستهدف على مستوى الوحدة/واجهة API؛ 2) توليد خطة ترحيل مع المهام والمالكين والتبعيات والجهد التقديري؛ 3) تقييم المخاطر بناءً على انتهاء صلاحية API وتغييرات API وتغطية الاختبارات؛ 4) تقرير تأثير التغييرات يُبرز الوحدات المتأثرة والحلول المقترحة. الميزات الاختيارية: 5) تصدير مخطط التبعيات لـ CI؛ 6) توليد تلقائي لقوالب التصحيحات أو نصوص الترحيل؛ 7) ملخصات Delta مستندة إلى ملاحظات الإصدار. يفرض سير العمل أن تكون الميزات الأساسية مدخلات إلزامية لكل سيناريو ترقية، وتثري الميزات الاختيارية الخطة عند توافر البيانات.
المدخلات والمخرجات: المدخلات تشمل current_version (مثال 7.4.3)، target_version (مثال 8.0.0)، codebase_path، modules (مصوفة)، include_plugins (Boolean) وهي مصادر بيانات اختيارية مثل رمز وصول المستودع ونتائج الاختبارات. المخرجات تشمل migration_plan كـ JSON منظم، risk_score (0–100)، delta_report (نص)، compatibility_matrix CSV، وتقارير التصدير النهائية exportable_upgrade_report (JSON أو PDF). التحقق من الصحة يتأكد من صحة بناء الإصدارات، إمكانية الوصول إلى مسار الشيفرة، مراجع الوحدات، ووجود بيانات اختيارية إن وجدت.