أوامر Bench في ERPNext: كل أمر موضح من مهندس DevOps

# دايما ابدأ هنا قبل تشغيل أوامر bench
cd ~/frappe-bench

# تحقق أنك في المكان الصحيح
pwd
# المفروض يطلع: /home/frappe/frappe-bench

# تحقق أنك مستخدم frappe
whoami
# المفروض يطلع: frappe

# إنشاء موقع جديد
# بيعمل إيه: ينشئ قاعدة بيانات MariaDB جديدة، بيشغل كل الترحيلات، ينشئ مستخدم أدمين
# تستخدمه إمتى: عند إعداد شركة/مستأجر جديد على نفس السيرفر
bench new-site mycompany.com \
  --mariadb-root-password DB_ROOT_PASS \
  --admin-password ADMIN_PASS \
  --no-mariadb-socket

# سرد كل المواقع على الـ bench ده
bench --site all list-apps

# تعيين موقع افتراضي (يوفر كتابة --site في كل أمر)
bench use mycompany.com

# تمكين وضع الصيانة (يحجب وصول المستخدمين)
# تستخدمه إمتى: قبل التحديثات أو الترحيلات لمنع تغيير البيانات
bench --site mycompany.com set-maintenance-mode on
bench --site mycompany.com set-maintenance-mode off

# مسح البيانات المخزنة مؤقتا
# تستخدمه إمتى: بعد تغييرات الإعداد غير المنعكسة، أو بعد التحديثات
bench --site mycompany.com clear-cache
bench --site mycompany.com clear-website-cache

# خطر: حذف موقع نهائيا (لا استرداد ممكن)
# بيعمل إيه: يحذف قاعدة البيانات بالكامل ويزيل كل الملفات
bench drop-site mycompany.com --root-password DB_ROOT_PASS

# تنزيل تطبيق من GitHub على الـ bench ده
# بيعمل إيه: git clone للمستودع في apps/
bench get-app erpnext --branch version-15
bench get-app hrms --branch version-15

# تنزيل تطبيق مخصص من مستودع خاص
bench get-app https://github.com/yourcompany/custom-app.git

# تثبيت تطبيق على موقع محدد (يضيف جداوله لقاعدة البيانات)
# بيعمل إيه: بيشغل كل سكربتات الترحيل للالتطبيق ده على ده الموقع
bench --site mycompany.com install-app erpnext
bench --site mycompany.com install-app hrms

# سرد كل التطبيقات المثبتة على موقع
bench --site mycompany.com list-apps

# إلغاء تثبيت تطبيق من موقع (يحذف بياناته — لا رجعة)
bench --site mycompany.com uninstall-app hrms --yes

# إزالة تطبيق من bench بالكامل (يزيل مجلد الكود)
bench remove-app hrms

# نسخة احتياطية كاملة (قاعدة البيانات + كل الملفات المرفوعة)
# بيعمل إيه: mysqldump لقاعدة البيانات + tar لمجلد الملفات
# ملفات النسخ مخزنة في: sites/mycompany.com/private/backups/
bench --site mycompany.com backup --with-files

# نسخة احتياطية لقاعدة البيانات بس (أسرع، بدون مرفقات الملفات)
bench --site mycompany.com backup

# سرد النسخ الاحتياطية الموجودة
ls -lh sites/mycompany.com/private/backups/

# استعادة من نسخة احتياطية
# بيعمل إيه: يسقط ويعيد إنشاء قاعدة البيانات، ثم يستورد النسخة
bench --site mycompany.com restore \
  sites/mycompany.com/private/backups/20260405_020000-mycompany_com-database.sql.gz

# استعادة مع الملفات
bench --site mycompany.com restore \
  sites/mycompany.com/private/backups/20260405_020000-mycompany_com-database.sql.gz \
  --with-private-files \
  sites/mycompany.com/private/backups/20260405_020000-mycompany_com-private-files.tar.gz \
  --with-public-files \
  sites/mycompany.com/private/backups/20260405_020000-mycompany_com-public-files.tar.gz

# تشغيل ترحيلات قاعدة البيانات المعلقة
# بيعمل إيه: بيطبق أي ملفات patch جديدة ما اشتغلتش لسه
# تستخدمه إمتى: بعد التحديثات، بعد تثبيت تطبيقات جديدة
bench --site mycompany.com migrate

# فتح وحدة تحكم MariaDB للـ SQL المباشر
bench --site mycompany.com mariadb

# فتح وحدة تحكم Python مع سياق Frappe
# بيعمل إيه: Python REPL مع frappe.db وfrappe.get_doc وما إلى ده
bench --site mycompany.com console

# التحقق من الموقع بحثا عن أخطاء وتناقضات
bench --site mycompany.com doctor

# إعادة بناء فهرس البحث
# تستخدمه إمتى: بعد ترحيل البيانات أو لما تكون نتائج البحث ناقصة
bench --site mycompany.com rebuild-global-search

# تحديث كامل: سحب الكود + تشغيل الترحيلات + إعادة بناء الأصول
bench update

# سحب الكود بس (بدون ترحيل، بدون إعادة بناء الأصول)
bench update --pull

# تطبيق الترحيلات بس (بدون سحب كود)
bench update --patch

# إعادة بناء أصول JavaScript/CSS
bench build

# بناء للإنتاج (مصغر، أبطأ في البناء لكن أسرع في التقديم)
bench build --production

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

# التحقق من الإصدارات الحالية لكل التطبيقات المثبتة
bench version

# إعداد الإنتاج الأولي (شغل كـ root/sudo بعد التثبيت)
# بيعمل إيه: ينشئ إعداد Supervisor وNginx ويضبط خدمات systemd
sudo bench setup production frappe

# إعادة توليد إعداد Nginx (شغل كـ root بعد إضافة مواقع جديدة)
sudo bench setup nginx
sudo nginx -t        # اختبر الإعداد قبل إعادة التحميل
sudo systemctl reload nginx

# إعادة توليد إعداد Supervisor
sudo bench setup supervisor
sudo supervisorctl reload

# إعادة تشغيل كل خدمات bench
bench restart

# بديل: إعادة التشغيل عبر Supervisor مباشرة (كـ root)
sudo supervisorctl restart all
sudo supervisorctl status

# إيقاف/بدء خدمات فردية
sudo supervisorctl stop frappe-schedule:frappe-schedule
sudo supervisorctl start frappe-schedule:frappe-schedule

# إعادة ضبط كلمة مرور المسؤول
# تستخدمه إمتى: لما تكون مقفلا خارج النظام
bench --site mycompany.com set-admin-password كلمة_المرور_الجديدة

# إضافة مستخدم System Manager جديد من سطر الأوامر
bench --site mycompany.com add-system-manager [email protected] \
  --first-name Ahmed \
  --last-name Hassan

# تعطيل مستخدم (بيمنع الدخول، ما بيحذفش البيانات)
bench --site mycompany.com disable-user [email protected]

# تمكين مستخدم
bench --site mycompany.com enable-user [email protected]

# 1. خذ نسخة احتياطية
bench --site mycompany.com backup --with-files

# 2. طبق التحديثات (التحديثات الصغيرة)
bench update --pull

# 3. أعد تشغيل كل الخدمات بعد التحديث
bench restart

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

# 5. امسح الكاش لما شيء ما بينعكسش
bench --site mycompany.com clear-cache

# 6. أعد ضبط كلمة مرور الأدمين
bench --site mycompany.com set-admin-password كلمة_جديدة

# 7. فعل وضع الصيانة للتحديثات
bench --site mycompany.com set-maintenance-mode on

# 8. تحقق من حالة الخدمات
sudo supervisorctl status

# 9. تحقق من الإصدار الحالي
bench version

# 10. راقب الأخطاء في الوقت الفعلي
tail -f ~/frappe-bench/logs/frappe.log