تحديث ERPNext v15: كل أمر بيعمل إيه وفين الكارثة بتحصل

# خذ نسخة احتياطية كاملة قبل كل تحديث (شغل كمستخدم frappe)
cd ~/frappe-bench
bench --site mycompany.com backup --with-files

# تأكد أن ملف النسخة موجود فعلا وله محتوى
ls -lh sites/mycompany.com/private/backups/
# المفروض تشوف ملف .sql.gz أنشئ في آخر دقيقتين
# المفروض يكون أكبر من 1 كيلوبايت — الملف بحجم 0 = النسخ فشل

# احتفظ باسم الملف الدقيق للاستخدام في التراجع لو لزم
ls -t sites/mycompany.com/private/backups/*.sql.gz | head -1

# نسخ لسيرفر آخر عبر SCP
scp sites/mycompany.com/private/backups/*.sql.gz user@backup-server:/backups/

# أو رفع إلى S3 (لو كان AWS CLI مهيأ)
aws s3 cp sites/mycompany.com/private/backups/*.sql.gz s3://your-backup-bucket/erpnext/

# الخطوة 1: خذ نسخة احتياطية (مغطاة أعلاه)

# الخطوة 2: تحقق من الإصدار الحالي
bench version
# سجل ده — ستحتاجه للتراجع لو فشل شيء

# الخطوة 3: شغل التحديث
bench update --pull

# لو أردت تشغيل الترحيل بشكل منفصل (أأمن لقواعد البيانات الكبيرة):
bench update --pull --skip-migrate
bench --site mycompany.com migrate  # شغل الترحيل أثناء مراقبته

# الخطوة 4: أعد تشغيل كل الخدمات لتحميل الكود الجديد
bench restart

# الخطوة 5: تحقق من نجاح التحديث
bench version  # المفروض يظهر أرقام الإصدار الجديدة
bench --site mycompany.com doctor  # يتحقق من أي تناقضات

# على سيرفر الاختبار (مش الإنتاج!)
# كرر التثبيت الكامل من دليل التثبيت أولا
# ثم استعد نسخة الإنتاج على موقع الاختبار:

bench new-site staging.mycompany.com \
  --mariadb-root-password DB_PASSWORD \
  --admin-password ADMIN_PASSWORD

# استعد نسخة قاعدة بيانات الإنتاج على الاختبار
bench --site staging.mycompany.com restore \
  /path/to/your-production-backup.sql.gz

# حول كل التطبيقات لفرع v15
bench switch-to-branch version-15 frappe erpnext hrms

# حدث وشغل الترحيلات
bench update --pull

# لو ظهرت أخطاء أثناء الترحيل، ستظهر هنا على الاختبار
# ده بالضبط سبب الاختبار هنا أولا

# على سيرفر الإنتاج
# جدول نافذة صيانة (مثلا: 2 ص الجمعة)

# 1. خذ نسخة احتياطية نهائية مباشرة قبل الترقية
bench --site mycompany.com backup --with-files

# 2. ضع الموقع في وضع الصيانة
bench --site mycompany.com set-maintenance-mode on

# 3. حول لفروع v15
bench switch-to-branch version-15 frappe erpnext hrms

# 4. اسحب الكود وشغل الترحيلات
bench update --pull

# 5. أعد بناء الأصول للإصدار الجديد
bench build --production

# 6. أعد تشغيل الخدمات
bench restart

# 7. عطل وضع الصيانة
bench --site mycompany.com set-maintenance-mode off

# 8. تحقق أن كل شيء بيعمل
bench version
bench --site mycompany.com doctor

# الخطوة 1: أوقف كل الخدمات فورا
sudo supervisorctl stop all

# الخطوة 2: حول كل التطبيقات للفرع السابق
# لو كنت على v15 وتترقى لـ v16:
bench switch-to-branch version-15 frappe erpnext hrms

# لو كنت على v14 وتترقى لـ v15:
bench switch-to-branch version-14 frappe erpnext hrms

# الخطوة 3: استعد قاعدة البيانات من النسخة الاحتياطية
# استبدل اسم الملف بالملف الفعلي اللي رأيته في 'ls' سابقا
bench --site mycompany.com restore \
  sites/mycompany.com/private/backups/20260405_020000-mycompany_com-database.sql.gz

# الخطوة 4: أعد بناء الأصول للإصدار القديم
bench build

# الخطوة 5: ابدأ الخدمات
sudo supervisorctl start all

# الخطوة 6: اختبر الموقع بيعمل
bench --site mycompany.com doctor

# اعرض ما هي الـ commits القادمة قبل سحبها
git -C apps/erpnext log --oneline HEAD..origin/version-15 | head -20
git -C apps/frappe log --oneline HEAD..origin/version-15 | head -20

# تحقق لو كانت ملفات ترحيل موجودة (تغييرات المخطط = مخاطرة أكبر)
ls apps/erpnext/erpnext/patches/
# ملفات patch جديدة منذ آخر تحديث = سيعدل قاعدة البيانات